How atharva2093/fileorg works
FileSync is a local-first file intelligence workbench: users scan a folder, inspect content-based recommendations, choose what to apply, and can review or undo recorded operations. Its distinct stages include discovery, extraction, local model analysis, review planning, safe filesystem changes, and history; assignment question-and-answer tools are a separate capability. The README documents these responsibilities and workflow. Source excerpts do not show the API’s full route implementations, so some links reflect documented behavior rather than inspected call sites.
Main entry points: api.py Local API · planner.py Review plan · operations.py Verified operations · assignment.py Assignment workflow
Components 15
Workbench
- Web workbench
frontend/app.py - Local API
filesync/api.py - Settings
filesync/config.py
File Intelligence
- Folder scanner
filesync/scanner.py - Content extraction
filesync/extractor.py - Analysis validation
filesync/classifier.py - Gemma provider
filesync/ai.py - Ollama runtime
Organization
- Domain records
filesync/models.py - Review plan
filesync/planner.py - Verified operations
filesync/operations.py - SQLite history
filesync/history.py
Learning Tools
- Assignment workflow
filesync/assignment.py
Other components
- User
- Selected folder
Connections 20
- User → Web workbench: uses
README.md - Web workbench → Local API: sends requests
- Local API → Settings: loads settings
filesync/api.py - Local API → Folder scanner: scans folder
README.md - Folder scanner → Selected folder: reads metadata
README.md - Local API → Review plan: builds review plan
README.md - Review plan → Content extraction: extracts content
filesync/planner.py - Review plan → Analysis validation: analyzes files
filesync/planner.py - Analysis validation → Gemma provider: requests analysis
filesync/classifier.py - Gemma provider → Ollama runtime: runs inference
filesync/ai.py - Local API → Verified operations: applies selection
README.md - Verified operations → Selected folder: copies and verifies
filesync/operations.py - Verified operations → SQLite history: records operations
filesync/operations.py - Local API → SQLite history: lists and undoes
README.md - Local API → Assignment workflow: serves questions
README.md - Assignment workflow → Content extraction: extracts assignment
filesync/assignment.py - Assignment workflow → Gemma provider: requests answers
filesync/assignment.py - Assignment workflow → SQLite history: records answer counts
README.md - Review plan → Domain records: creates plan records
filesync/planner.py - Verified operations → Domain records: updates operation records
filesync/operations.py