busya
ec6421de35
- Replace all occurrences of 'ss-tools' with 'superset-tools' in 104 files - Rename git bundle file ss-tools.bundle → superset-tools.bundle - Update .gitignore pattern accordingly - Preserve variable names (hasSsTools etc.) and code identifiers
58 lines
1.3 KiB
Markdown
58 lines
1.3 KiB
Markdown
#region AgentChat.Quickstart [C:2] [TYPE ADR] [SEMANTICS quickstart,agent-chat,langchain-v1]
|
|
@BRIEF Developer quickstart — Gradio + LangChain v1 native stack.
|
|
|
|
## Quick Start (Docker)
|
|
|
|
```bash
|
|
docker compose build superset-tools-agent
|
|
docker compose up -d
|
|
# Frontend: http://localhost:5173 → login → assistant toggle
|
|
# Gradio proxy: http://localhost:8000/api/agent/gradio
|
|
```
|
|
|
|
## Quick Start (Local)
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
LLM_API_KEY=sk-...
|
|
LLM_BASE_URL=https://api.openai.com/v1
|
|
LLM_MODEL=gpt-4o
|
|
JWT_SECRET=<shared with FastAPI>
|
|
FASTAPI_URL=http://superset-tools-api:8000
|
|
SERVICE_TOKEN_SECRET=<for POST /api/auth/service-token>
|
|
```
|
|
|
|
#endregion AgentChat.Quickstart
|