This project is a 3-service system built with React (Vite), Go (REST API), and Python (FastAPI).
- UI (Vite + React): Dashboard where users can create an account and chat with the AI.
- Go API: Provides REST endpoints for creating users and verifying them (UUID based).
- Python Agent: AI agent stub (currently just echoes input). Later can be extended to call Google GenAI.
Make sure you have these installed:
- Node.js (≥ 18.x recommended)
- Go (≥ 1.22)
- Python 3 (≥ 3.10)
- Make (comes with Linux/macOS; for Windows use Git Bash or WSL)
concurrently(Node helper for running multiple processes at once)
Install concurrently globally once:
npm install -g concurrently
cd ui
npm install
Create a .env file in ui/:
VITE_API_URL=http://localhost:8080
VITE_AGENT_URL=http://localhost:8001
cd internal
go mod tidy
cd agent
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
then
deactivate
Create a .env file in agent/ for implementing agent:
GEMINI_API_KEY=
make run-all