QualiFile is a Flask application for managing a local file workspace with previews, metadata, validation flags, project tracking, and Windows portable packaging.
- Workspace explorer with folder navigation, filtering, sorting, and file operations
- Preview support for text, code, images, PDFs, and Office documents
- PDF and image utilities for merge, extraction, capture, and annotation flows
- Notes, tags, sidecar metadata, per-file validation tracking, and note formatting helpers
- Projects, linked roots, tasks/notes, timeline, reminders, alerts, project archiving, and opt-in inline entry composition
- Git Sync Manager for project metadata export/import and repo actions
QualiFile opens with a focused workspace selection flow, then expands into a project-centric dashboard for linked roots, tasks, notes, and timeline work.
The first screen keeps setup minimal: choose the root folder QualiFile should manage and start working inside a contained local workspace.
The projects view brings project tracking, status visibility, and task/note management into a single screen.
- Python 3.10 or newer for source runs
- Source validated against Python 3.10 and 3.12 syntax
- Windows is the primary platform, portable builds are Windows-only
- Office previews require Windows, Microsoft Office, and
pywin32
python -m pip install -r requirements.txt
python -m flask --app run.py --debug runOpen http://127.0.0.1:5000 and choose a workspace root.
python -m pip install -r requirements/portable_build.txt
build_portable.bat
build_portable_embedded.batDownload the packaged builds for the v1.2.0 release:
Portable builds bundle minified frontend assets, the user tutorial, and
vendored offline web assets under dist/.
app/Flask app, blueprints, feature modules, templates, and static assetsdocs/tutorial assets, schema registry, portable notices, and third-party noticespackaging/Windows launchers and PyInstaller specstools/asset and portable build helpersrequirements/runtime and packaging dependency sets
QualiFile is currently maintained for personal use and is not accepting external contributions. Bug reports, questions, and feature requests should go through GitHub Issues.
QualiFile is licensed under Business Source License 1.1. Personal and other non-production use is allowed. Commercial and production use requires a license from the licensor.

