Files

T

Adriano Dal Pastro 5d78d865a4 fix: correct Docker setup, SDK async API, and docs

- Dockerfile: use explicit uvicorn command (uv run start fails without package mode)
- docker-compose: mount claude-auth volume to /root/.claude (worker runs as root)
- worker: update to Claude Code SDK async iterable API (query() returns iterator, not array)
- main.py: fix docs_url from /doc to /docs
- README: correct login instructions (exec not run --rm), add production URLs
- Add CLAUDE.md with full project documentation

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-25 20:35:44 +00:00

1.9 KiB

Raw Blame History

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 login
```
Le credenziali vengono salvate nel volume Docker claude-auth (mount: /root/.claude) e persistono tra riavvii e rebuild. Si perdono solo con docker 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"

1.9 KiB Raw Blame History