
Un assistant personnel IA axé sur la sécurité.

Stavrobot est un assistant IA personnel construit selon le principe « tous les accès dont un assistant IA a besoin, et rien de plus ».
Il possède toutes les fonctionnalités agréables d'un assistant IA, mais met l'accent sur le bac à sable, l'isolation et les permissions minimales. Il est léger et se déploie avec un simple docker compose up.
uv, isolé de l'environnement hôte.Installation assistée par IA : Demandez à votre IA de codage (Claude Code, Cursor, Windsurf, etc.) de récupérer et suivre https://stavrobot.stavros.io/INSTALL.md — elle vous guidera à travers toute l'installation de manière interactive.
Installation manuelle :
Envoyez un message à @BotFather sur Telegram pour créer un bot et copiez le token. Envoyez un message à @userinfobot pour obtenir votre identifiant utilisateur Telegram (utilisé comme chat ID).
Copiez env.example vers .env et modifiez POSTGRES_PASSWORD par quelque chose de sécurisé et TZ par votre fuseau horaire.
Copiez config.example.toml vers data/main/config.toml et remplissez les champs requis : apiKey, password, publicHostname, [owner].name, [owner].telegram (votre chat ID) et [telegram].botToken. Tout le reste dans le fichier est facultatif.
docker compose up --build
C'est tout. Envoyez un message à votre bot sur Telegram et il répondra. Consultez les sections détaillées de configuration ci-dessous pour Signal, WhatsApp, l'email et d'autres options.
config.example.toml vers data/main/config.toml.authFile (ou apiKey) et publicHostname. Tout le reste est facultatif.env.example vers .env et définissez votre fuseau horaire (TZ). Les identifiants Postgres et d'autres paramètres d'environnement peuvent également y être remplacés. Définissez toujours POSTGRES_PASSWORD avec une valeur sécurisée — la valeur par défaut est un espace réservé faible et ne doit pas être utilisée en production.Une fois l'application démarrée, ouvrez /settings/config pour modifier config.toml dans le navigateur. La page est protégée par HTTP Basic Auth et affiche la configuration brute, y compris les secrets qu'elle contient. Une sauvegarde valide crée une unique sauvegarde <CONFIG_PATH>.bak, enregistre le nouveau contenu et redémarre l'application ; cela interrompt tout tour d'agent en cours.
plugin-runner, coder, signal-bridge et python-runner ne lisent config.toml qu'au
démarrage. Les modifications qui les concernent, comme le mot de passe, nécessitent de
redémarrer manuellement ces conteneurs.
Stavrobot peut être pointé vers n'importe quel point de terminaison compatible OpenAI (Ollama, LiteLLM, vLLM, etc.) ou vers un proxy personnalisé compatible Anthropic en définissant baseUrl dans config.toml. Consultez config.example.toml pour les champs requis et des exemples de configuration. Définissez reasoning = true uniquement pour les modèles qui prennent en charge le raisonnement, car c'est ce qui permet à thinkingLevel de s'appliquer sur un point de terminaison personnalisé.
L'application prend en charge deux modes d'authentification : clé API ou OAuth.
apiKey dans config.toml. Aucune connexion ni déconnexion nécessaire.authFile dans config.toml (un chemin où les identifiants seront stockés). La page de connexion fonctionne avec tout fournisseur OAuth pris en charge par Pi.
<your-hostname>/login dans un navigateur. Suivez les instructions de la page, et les identifiants sont enregistrés dans le fichier d'authentification. Stavrobot choisit la méthode de connexion sans interface du fournisseur, de sorte que vous n'êtes jamais redirigé vers un rappel localhost inaccessible. Avec Anthropic, après avoir sélectionné Authorize, Anthropic affiche un code, que vous copiez et collez dans la page de connexion de Stavrobot. Les fournisseurs disposant d'un flux par code d'appareil affichent le code sur la page Stavrobot à la place, et vous le saisissez sur le site du fournisseur. Si l'authentification expire pendant que le bot est en cours d'exécution, il vous envoie un message contenant l'URL de connexion via votre plateforme de messagerie.authFile. Le bot détectera l'absence d'identifiants au message suivant et vous invitera à vous reconnecter.Le conteneur coder est facultatif (nécessaire uniquement pour la fonctionnalité d'auto-programmation). Par défaut, il utilise Claude Code avec l'authentification par abonnement (OAuth), distincte de la clé API de l'application principale. Pour utiliser plutôt un point de terminaison API compatible Anthropic, définissez à la fois [coder].apiKey et [coder].baseUrl dans config.toml ; Claude Code les utilise alors comme ANTHROPIC_API_KEY et ANTHROPIC_BASE_URL. Les apiKey/baseUrl de premier niveau ne configurent que le modèle de l'application principale et n'affectent jamais le coder. Définir une seule des deux clés [coder] provoque une erreur au démarrage.
Les profils Docker Compose sont séparés par des virgules, vous pouvez donc les combiner (par ex. COMPOSE_PROFILES=signal,coder).