sibilla/README.md

🔮 Sibilla

L'oracolo AI che cerca nel web e risponde alle tue domande. Self-hosted Perplexity-like search engine.

Sibilla è un motore di ricerca AI self-hosted che combina:

• 🧠 Google Gemini API — modelli linguistici avanzati con grounding su web search
• 🔧 MCP (Model Context Protocol) — tool use per estendere le capacità dell'AI
• 🔍 Web search integrata — ricerca e sintesi delle fonti in tempo reale
• 🖥️ Flask web app — interfaccia pulita e reattiva

Tu chiedi → Sibilla cerca nel web → Sintetizza le fonti → Ti risponde con citazioni

Architettura (pianificata)

sibilla/
├── src/sibilla/
│   ├── app.py          # Flask app factory
│   ├── cli.py          # Entry point
│   ├── search.py       # Web search + scraping
│   ├── ai.py           # Google Gemini API client
│   ├── mcp.py          # MCP tool integration
│   └── prompts.py      # Prompt templates
├── templates/
│   └── index.html      # Interfaccia di ricerca
├── static/
│   ├── style.css       # Stili
│   └── app.js          # Logica frontend
└── tests/
    └── ...

Setup

cd sibilla
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

Crea un file .env con la tua API key Google:

GOOGLE_API_KEY=your-api-key-here

Uso

# Avvia il server
sibilla

# Oppure
python -m sibilla

Poi apri http://127.0.0.1:5000 nel browser.

Sviluppo

pip install -e ".[dev]"
pytest
ruff check src tests

Licenza

MIT