80 lines
1.6 KiB
Markdown
80 lines
1.6 KiB
Markdown
# 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
|
|
|
|
1. Copia e configura l'environment:
|
|
```bash
|
|
cp .env.example .env
|
|
# Edita .env: imposta API_KEY e le altre variabili
|
|
```
|
|
|
|
2. Autentica Claude Code nel worker:
|
|
```bash
|
|
docker compose run --rm claude-worker npx claude login
|
|
```
|
|
|
|
3. Avvia il sistema:
|
|
```bash
|
|
docker compose up -d
|
|
```
|
|
|
|
4. Verifica:
|
|
```bash
|
|
curl -H "X-Api-Key: TUA_KEY" http://localhost:8000/api/health
|
|
```
|
|
|
|
## Sviluppo locale
|
|
|
|
```bash
|
|
uv sync --all-groups
|
|
cp .env.example .env
|
|
# Edita .env
|
|
uv run dev
|
|
```
|
|
|
|
## Test
|
|
|
|
```bash
|
|
uv run pytest -v
|
|
```
|
|
|
|
## API
|
|
|
|
Documentazione completa: `http://localhost:8000/doc`
|
|
|
|
### Esempio d'uso
|
|
|
|
```bash
|
|
# 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"
|
|
```
|