Before setting up the project, ensure you have the following installed:

• Python 3.13+ - Required for this project
• uv - Fast Python package installer and resolver

If you don't have uv installed, you can install it using one of the following methods:

On macOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Using pip:

pip install uv

Using Homebrew (macOS):

brew install uv

1. Clone or navigate to the project directory:

   cd backend

2. Install dependencies using uv:

   uv sync

   This will create a virtual environment and install all dependencies specified in pyproject.toml.

3. Activate the virtual environment:

   source .venv/bin/activate

   Or if you prefer to run commands without activating:

   uv run manage.py runserver

Run the main application:

# If virtual environment is activated
python manage.py runserver

# Or using uv directly
uv run manage.py runserver

To add a new dependency:

uv add package-name

uv run manage.py runserver

backend/
├── manage.py           # Main application entry point
├── pyproject.toml      # Project configuration and dependencies
├── uv.lock             # Locked dependency versions
└── README.md           # This file
└── backend             # Django Configuration

• Ensure Python 3.13+ is installed and available in your PATH
• If you encounter issues with uv, try updating it: uv self update

This project is part of the TMT (ThunderMindtech) organization.