🔮 Initial commit: sibilla — self-hosted Perplexity-like AI search engine

README.md

@@ -0,0 +1,74 @@
+# 🔮 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
+
+```bash
+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
+
+```bash
+# Avvia il server
+sibilla
+
+# Oppure
+python -m sibilla
+```
+
+Poi apri http://127.0.0.1:5000 nel browser.
+
+## Sviluppo
+
+```bash
+pip install -e ".[dev]"
+pytest
+ruff check src tests
+```
+
+## Licenza
+
+MIT