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

ServiceRôle
postgresPostgres 16 : données et file de tâches (pg-boss).
migrateApplique les migrations de la base, puis s'arrête.
apiAPI REST, sessions, clés d'API, webhooks, MCP distant (port 3001).
voicePont entre le réseau téléphonique (Twilio) et le modèle de voix (port 3002).
workerLe cerveau de l'assistant, la mémoire, le planificateur, l'envoi des webhooks, les connecteurs.
webCe 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_URL et ANTHROPIC_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.