Local Setup Checklist

A practical runbook for getting a newly cloned Aegis Agent workspace running on a teammate's machine.

Clone and enter the repository

Use the project root as the working directory for both frontend and backend setup.

git clone <repo-url>
cd Aegis-Agent

Keep BAND_MOCK_MODE=true for local UI testing without external Band credentials.

cd backend
python -m venv venv
.\venv\Scripts\Activate.ps1
pip install -r requirements.txt
Copy-Item .env.example .env
uvicorn main:app --reload

Local dev defaults to http://localhost:8000; production uses Vercel rewrites unless NEXT_PUBLIC_API_BASE_URL is set.

cd frontend
npm install
npm run dev

If the backend is offline, room creation and file upload will fail.

Open http://localhost:3000
Create an analysis
Watch War Room handoffs
Open the final verdict

SECRETS NOTE

Do not commit real API keys. Add provider credentials only to a private local backend/.env when testing online model calls.