Developer Setup

This section is for developers or contributors who want to customize, debug, or deploy the project in production.

🧩 Prerequisites

Ensure the following are installed:

• Python 3.11+

• Node.js 18+

• Make

• Optional: Docker for containerized development

---

🔧 Manual Commands

Run Backend

cd backend
.\venv\Scripts\Activate.ps1   # Activate virtual environment (if used)
uvicorn main:app --reload --host 0.0.0.0 --port 8000

Run Frontend

cd frontend-react
npm start

Build for Production

To build the frontend for production, run:

cd frontend-react
npm run build

To prepare the backend for production, install requirements (if not done yet):

cd backend
pip install -r requirements.txt

---

🐳 Docker Support (Optional)

Coming soon: A Dockerfile for local or cloud deployments.

---

⚙️ Environment Variables

• Located in .env

• Required keys:

  • OPENAI_API_KEY

  • SUPABASE_URL

  • SUPABASE_KEY

  • AZURE_SPEECH_KEY (if using TTS/STT)

---

🧪 Testing & Debugging

• Manual scenario testing supported with logs

• Unit + integration tests planned for agents

• Built-in debugging tools via Admin Panel (React)