
Un assistente personale AI incentrato sulla sicurezza.
Scopri gli strumenti più utilizzati dalla nostra community.
Nessun dato di popolarità ancora.

Stavrobot è un assistente AI personale costruito secondo il principio di "tutti gli accessi di cui un assistente AI ha bisogno, e niente di più".
Ha tutte le belle funzionalità di un assistente AI, ma si concentra su sandboxing, isolamento e permessi minimi. È leggero e viene distribuito con un semplice docker compose up.
uv, isolato dall'ambiente host.Installazione assistita dall'AI: Chiedi alla tua AI per la programmazione (Claude Code, Cursor, Windsurf, ecc.) di recuperare e seguire https://stavrobot.stavros.io/INSTALL.md — ti guiderà attraverso l'intera configurazione in modo interattivo.
Installazione manuale:
Invia un messaggio a @BotFather su Telegram per creare un bot e copia il token. Invia un messaggio a @userinfobot per ottenere il tuo ID utente Telegram (viene usato come chat ID).
Copia env.example in .env e cambia POSTGRES_PASSWORD con qualcosa di sicuro e TZ con il tuo fuso orario.
Copia config.example.toml in data/main/config.toml e compila i campi obbligatori: apiKey, password, publicHostname, [owner].name, [owner].telegram (il tuo chat ID) e [telegram].botToken. Tutto il resto nel file è opzionale.
docker compose up --build
Fatto. Invia un messaggio al tuo bot su Telegram e risponderà. Consulta le sezioni dettagliate sulla configurazione qui sotto per Signal, WhatsApp, email e altre opzioni.
config.example.toml in data/main/config.toml.authFile (o apiKey) e publicHostname. Tutto il resto è opzionale.env.example in .env e imposta il tuo fuso orario (TZ). Anche le credenziali Postgres e altre impostazioni d'ambiente possono essere sovrascritte lì. Imposta sempre POSTGRES_PASSWORD con qualcosa di sicuro — il valore predefinito è un segnaposto debole e non dovrebbe essere usato in produzione.Dopo l'avvio dell'app, apri /settings/config per modificare config.toml nel browser. La
pagina è protetta da HTTP Basic Auth e mostra la configurazione grezza, inclusi eventuali
segreti che contiene. Un salvataggio valido crea un singolo backup <CONFIG_PATH>.bak, salva il
nuovo contenuto e riavvia l'app; questo interrompe qualsiasi turno dell'agente in corso.
plugin-runner, coder, signal-bridge e python-runner leggono config.toml solo
all'avvio. Le modifiche che li riguardano, come la password, richiedono il riavvio
manuale di quei container.
Stavrobot può essere indirizzato verso qualsiasi endpoint compatibile con OpenAI (Ollama, LiteLLM, vLLM, ecc.) o un proxy personalizzato compatibile con Anthropic impostando baseUrl in config.toml. Consulta config.example.toml per i campi richiesti e le configurazioni di esempio. Imposta reasoning = true solo per i modelli che supportano il thinking, poiché è ciò che fa sì che thinkingLevel venga applicato su un endpoint personalizzato.
L'app supporta due modalità di autenticazione: API key o OAuth.
apiKey in config.toml. Non è necessario alcun login o logout.authFile in config.toml (un percorso in cui verranno memorizzate le credenziali). La pagina di login funziona con qualsiasi provider OAuth supportato da Pi.
<your-hostname>/login in un browser. Segui le istruzioni sulla pagina e le credenziali vengono salvate nel file di autenticazione. Stavrobot sceglie il metodo di login headless del provider, così non vieni mai reindirizzato a un callback localhost irraggiungibile. Con Anthropic, dopo aver selezionato Authorize, Anthropic mostra un codice, che copi e incolli nella pagina di login di Stavrobot. I provider con un flusso device-code mostrano invece il codice sulla pagina di Stavrobot, e tu lo digiti sul sito del provider. Se l'autenticazione scade mentre il bot è in esecuzione, ti invia un messaggio con l'URL di login tramite la tua piattaforma di messaggistica.authFile. Il bot rileverà le credenziali mancanti al messaggio successivo e ti chiederà di effettuare nuovamente il login.Il container coder è opzionale (necessario solo per la funzionalità di auto-programmazione). Per impostazione predefinita utilizza Claude Code con autenticazione tramite abbonamento (OAuth), separata dalla API key dell'app principale. Per utilizzare invece un endpoint API compatibile con Anthropic, imposta sia [coder].apiKey che [coder].baseUrl in config.toml; Claude Code li utilizzerà quindi come ANTHROPIC_API_KEY e ANTHROPIC_BASE_URL. Le chiavi di primo livello apiKey/baseUrl configurano solo il modello dell'app principale e non influiscono mai sul coder. Impostare solo una delle due chiavi [coder] è un errore all'avvio.
I profili di Docker Compose sono separati da virgole, quindi puoi combinarli (ad es. COMPOSE_PROFILES=signal,coder).
COMPOSE_PROFILES nel tuo file .env per includere coder (ad es. COMPOSE_PROFILES=coder, oppure COMPOSE_PROFILES=signal,coder se stai usando anche Signal).docker compose --profile coder up --build[coder].apiKey/[coder].baseUrl): docker compose exec -u coder coder claude (ti chiederà di effettuare il login se non lo hai già fatto).[coder].model nella tua configurazione su un alias di modello di Claude Code (sonnet, opus o haiku).