README.md

---
title: Agente AI Backend
emoji: 🤖
colorFrom: indigo
colorTo: blue
sdk: docker
app_port: 7860
pinned: false
---

# Agente AI — Backend FastAPI

Backend Python FastAPI per Agente AI. Streaming LLM, memoria, esecuzione codice, terminal PTY.

## Endpoints principali

- `GET  /health`              — stato backend
- `GET  /api/status`          — versione + config
- `POST /api/reason/loop`     — agent reasoning loop
- `POST /api/exec`            — esecuzione codice Python
- `POST /api/execute-shell`   — shell commands
- `POST /api/search`          — web search proxy
- `POST /api/fetch-page`      — page fetch proxy
- `WS   /ws/terminal`         — PTY WebSocket terminal

## Stack

- Python 3.11 + FastAPI + uvicorn
- smolagents>=1.14.0 + litellm>=1.40.0
- supabase (opzionale)

## Variabili ambiente

| Variabile | Descrizione |
|-----------|-------------|
| GROQ_API_KEY | Groq API key |
| GEMINI_API_KEY | Google Gemini key |
| OPENROUTER_API_KEY | OpenRouter key |
| HF_TOKEN | HuggingFace token |
| SUPABASE_URL | Supabase URL (opzionale) |
| SUPABASE_ANON_KEY | Supabase anon key (opzionale) |
| ALLOWED_ORIGINS | CORS origins comma-separated |