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

Autentica Claude Code nel worker:

docker compose run --rm claude-worker npx claude login

Avvia il sistema:
```
docker compose up -d
```

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 completa: http://localhost:8000/doc

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"

1.6 KiB Raw Blame History