How to Run the Project

On Linux (Debian)

1. python3 -m venv .venv
2. source .venv/bin/activate
3. pip install --upgrade pip
4. pip install -r requirements.txt
5. python3 main.py ← Launches the GUI application

On Windows

1. python -m venv .venv
2. .venv\Scripts\activate
3. pip install --upgrade pip
4. pip install -r requirements.txt
5. python main.py ← Launches the GUI application

Testing the Ingestor (Optional)

To test file extraction without the GUI:

python3 test.py

Architecture

The project now uses MVC architecture for better organization:

• Model (model/) - Graph data structures, file ingestor, similarity calculations
• Controller (controller/) - Graph building logic, background workers
• View (view/) - Qt GUI components

See ARCHITECTURE.md for detailed structure documentation.