| name | setup |
| description | First-time project setup for local development |
| allowed-tools | Bash, Read |
Setup
First-time project setup for local development.
Instructions
1. Install Prerequisites
curl -LsSf https://astral.sh/uv/install.sh | sh
node --version
2. Backend Setup
cd backend
uv venv venv
uv sync --group dev
3. Frontend Setup
cd frontend
npm install
4. Verify Setup
cd backend
source venv/bin/activate
python --version
ruff --version
ty --version
cd frontend
npm run build
Quick Start After Setup
cd backend && source venv/bin/activate && uvicorn app.main:app --reload --port 8000
cd frontend && npm run dev
Access the app at http://localhost:5173
Environment Variables (Optional)
Copy the example secrets file if you need HuggingFace or GitHub tokens:
cp secrets.env.example secrets.env
Important Notes
- uv automatically handles PyTorch CPU-only installation
- The lockfile (
uv.lock) ensures reproducible dependencies
- Development tools (ruff, ty) are included with
--group dev
- Frontend proxies API calls to backend on port 8000