# 🎯 Setup Claude Anthropic API

## ✅ Migrazione Completata!

Jarvis-Cognitive è stato migrato da **Google Gemini** a **Claude Anthropic** per conversazioni filosofiche ancora più profonde e autentiche con Marco Aurelio.

---

## 📋 Configurazione API Key

### 1. Ottieni la tua API Key Claude

1. Vai su: [https://console.anthropic.com](https://console.anthropic.com)
2. Crea un account o accedi
3. Vai su **API Keys**
4. Click su **Create Key**
5. Copia la chiave (inizia con `sk-ant-api03-...`)

### 2. Aggiungi la Key al file .env

Modifica `data/.env` e aggiungi:

```bash
# Claude Anthropic API Key
ANTHROPIC_API_KEY="sk-ant-api03-LA_TUA_KEY_QUI"

# Mantieni anche queste (ancora utilizzate)
GOOGLE_API_KEY="..."  # Per embeddings
TAVILY_API_KEY="..."  # Per ricerca web
```

### 3. Verifica la configurazione

Il file `config/config.yaml` è già configurato per usare Claude:

```yaml
llm_provider: "anthropic"
model_name: "claude-3-5-sonnet-20241022"
```

---

## 🚀 Avvio

```bash
./start_jarvis.sh
```

Oppure doppio click sull'icona **"Jarvis - Marco Aurelio"** sulla Scrivania.

---

## 🔄 Tornare a Google Gemini (opzionale)

Se preferisci tornare a Gemini, modifica `config/config.yaml`:

```yaml
llm_provider: "google"
model_name: "gemini-2.5-flash"
```

Il sistema supporta entrambi! Basta cambiare il provider.

---

## 🆚 Claude vs Gemini

| Caratteristica | Claude 3.5 Sonnet | Gemini 2.5 Flash |
|----------------|-------------------|------------------|
| **Reasoning filosofico** | ★★★★★ Eccellente | ★★★★☆ Ottimo |
| **Tool use (RAG)** | ★★★★★ Superiore | ★★★★☆ Buono |
| **Contesto** | 200K token | 1M token |
| **Velocità** | Veloce | Molto veloce |
| **Costo** | Medio | Economico |
| **Italiano** | ★★★★★ Eccellente | ★★★★☆ Buono |

**Raccomandazione**: Claude è superiore per Marco Aurelio - reasoning filosofico più profondo e tool use migliore per il RAG.

---

## 💰 Costi (stimati)

### Claude Sonnet 3.5
- **Input**: $3.00 / 1M token
- **Output**: $15.00 / 1M token

### Esempio d'uso tipico:
- Conversazione media: ~2000 token input + 500 token output
- Costo per conversazione: ~$0.0135 (circa 1 centesimo)
- 100 conversazioni: ~$1.35

Per uso personale il costo è trascurabile. La qualità delle risposte filosofiche vale la differenza!

---

## ✅ Checklist Setup

- [ ] API Key Claude ottenuta da console.anthropic.com
- [ ] `ANTHROPIC_API_KEY` aggiunta in `data/.env`
- [ ] Config verificata: `llm_provider: "anthropic"` in `config/config.yaml`
- [ ] Applicazione avviata: `./start_jarvis.sh`
- [ ] Prima conversazione testata con Marco Aurelio

---

## 🐛 Troubleshooting

### Errore: "Authentication error"
- Verifica che `ANTHROPIC_API_KEY` in `.env` sia corretta
- Deve iniziare con `sk-ant-api03-`

### Errore: "langchain-anthropic non disponibile"
```bash
source .venv/bin/activate
pip install anthropic langchain-anthropic
```

### Errore: "Rate limit exceeded"
- Hai superato i limiti gratuiti
- Aggiungi credito su console.anthropic.com
- Oppure torna temporaneamente a Gemini

---

**Marco Aurelio con Claude è pronto!** 🏛️✨

*"La qualità del tuo pensiero determina la qualità della tua vita."* - Marco Aurelio