Adriano Dal Pastro
98ad65d248
Adds middleware requiring X-Api-Key header or ?api_key= query param to access Swagger UI and ReDoc. OpenAPI schema remains public. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
OpusAgent
Servizio self-hosted per l'interazione programmatica con i modelli Anthropic tramite Claude Code SDK, sfruttando un abbonamento Claude Pro/Max esistente.
Architettura
Due container Docker:
- fastapi-service — API REST, autenticazione, coda richieste, rate limiting
- claude-worker — Processamento richieste via Claude Code SDK
Setup
Prerequisiti
- Docker e Docker Compose
- Un abbonamento Claude Pro/Max attivo
Prima installazione
-
Copia e configura l'environment:
cp .env.example .env # Edita .env: imposta API_KEY e le altre variabili -
Avvia il sistema:
docker compose up -d -
Autentica Claude Code nel worker (nel container attivo, non con
run --rm):docker compose exec claude-worker npx claude loginLe credenziali vengono salvate nel volume Docker
claude-auth(mount:/root/.claude) e persistono tra riavvii e rebuild. Si perdono solo condocker compose down -v. -
Verifica:
curl -H "X-Api-Key: TUA_KEY" http://localhost:8000/api/health
Sviluppo locale
uv sync --all-groups
cp .env.example .env
# Edita .env
uv run dev
Test
uv run pytest -v
API
Documentazione interattiva:
- Swagger UI:
https://opus-agent.tielogic.xyz/docs - ReDoc:
https://opus-agent.tielogic.xyz/redoc
Esempio d'uso
# Crea un argomento
curl -X POST http://localhost:8000/api/topics \
-H "X-Api-Key: TUA_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "coding", "system_prompt": "Sei un esperto sviluppatore."}'
# Invia una richiesta
curl -X POST http://localhost:8000/api/requests \
-H "X-Api-Key: TUA_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "Come implemento JWT in FastAPI?", "topic_id": "ID_TOPIC"}'
# Controlla il risultato
curl http://localhost:8000/api/requests/ID_RICHIESTA \
-H "X-Api-Key: TUA_KEY"