Documentation
Auto-hébergement
Fais tourner Allomi chez toi avec Docker Compose.
Allomi est open source (MIT). Le code que tu fais tourner est celui du cloud : mêmes images, même base, même API.
git clone https://github.com/allomi-ai/allomi
cd allomi
cp .env.example .env
# remplis .env (voir plus bas), puis :
docker compose -f docker-compose.selfhost.yml up -d
Ce qui tourne
| Service | Rôle |
|---|---|
postgres | Postgres 16 : données et file de tâches (pg-boss). |
migrate | Applique les migrations de la base, puis s'arrête. |
api | API REST, sessions, clés d'API, webhooks, MCP distant (port 3001). |
voice | Pont entre le réseau téléphonique (Twilio) et le modèle de voix (port 3002). |
worker | Le cerveau de l'assistant, la mémoire, le planificateur, l'envoi des webhooks, les connecteurs. |
web | Ce site et l'application. |
Les images sont publiées sous ghcr.io/allomi-ai/*. Fixe une version avec ALLOMI_VERSION.
Ce qu'il te faut
- Un serveur avec Docker (une petite VM suffit).
- Une URL HTTPS publique pour le service vocal (
VOICE_PUBLIC_URL) : Twilio s'y connecte. Mets un reverse proxy comme Caddy devant, ou un tunnel pour tester. - Un compte Twilio (numéros, flux média, Verify en option pour les codes SMS) et une clé d'API OpenAI pour la voix en temps réel.
- Un modèle pour le raisonnement de l'assistant, configuré avec
ANTHROPIC_BASE_URLetANTHROPIC_AUTH_TOKEN. - En option : Stripe (facturation, désactivée si absente), Resend (e-mails).
Chaque variable est documentée dans .env.example. Génère la clé de scellement qui chiffre les secrets stockés avec openssl rand -base64 32 et garde-la précieusement : sans elle, les clés des connecteurs ne sont plus lisibles.
Sauvegardes et mises à jour
Sauvegarde le volume postgres-data (un pg_dump quotidien suffit). Pour mettre à jour, change ALLOMI_VERSION, lance docker compose pull puis up -d : le service migrate applique d'abord les nouvelles migrations.