ss-tools/specs/033-gradio-agent-chat/quickstart.md

#region AgentChat.Quickstart [C:2] [TYPE ADR] [SEMANTICS quickstart,agent-chat,langchain-v1] @BRIEF Developer quickstart — Gradio + LangChain v1 native stack.

Quick Start (Docker)

docker compose build ss-tools-agent
docker compose up -d
# Frontend: http://localhost:5173 → login → assistant toggle
# Gradio proxy: http://localhost:8000/api/agent/gradio

Quick Start (Local)

# Terminal 1: FastAPI
cd backend && source .venv/bin/activate
uvicorn src.app:app --reload --port 8000

# Terminal 2: Gradio Agent
cd backend && source .venv/bin/activate
pip install gradio langchain langchain-openai langgraph-checkpoint pdfplumber
python -m src.agent.run  # Port 7860

# Terminal 3: Svelte
cd frontend && npm install @gradio/client && npm run dev -- --port 5173

Verification

# Backend tests
cd backend && source .venv/bin/activate && python -m pytest tests/ -v

# Frontend tests
cd frontend && npm run test

# Lint
cd backend && python -m ruff check src/agent/
cd frontend && npm run lint

# Gradio health
curl http://localhost:7860/health

Environment

LLM_API_KEY=sk-...
LLM_BASE_URL=https://api.openai.com/v1
LLM_MODEL=gpt-4o
JWT_SECRET=<shared with FastAPI>
FASTAPI_URL=http://ss-tools-api:8000
SERVICE_TOKEN_SECRET=<for POST /api/auth/service-token>

#endregion AgentChat.Quickstart