Votre Lenn, chez vous

Ce qu’il vous faut

• Un serveur avec Docker et Docker Compose : un petit serveur loué, un ordinateur à la maison, un NAS récent.
• De la mémoire : le compose réserve 1 Go à l’application web et 4 Go au worker qui transcrit et comprend vos moments. Comptez environ 6 Go. Le service audio (facultatif) en demande davantage ; un GPU NVIDIA l’accélère.
• Une adresse en HTTPS, par exemple lenn.votredomaine.fr, derrière un proxy inverse. Un exemple Caddy est fourni.
• Vos clés chez les fournisseurs d’IA, ou rien du tout pour commencer : le mode démo fonctionne sans aucune clé.

Installer en cinq étapes

1. 1

   Récupérez le code

   Clonez le dépôt sur votre serveur.

   $ git clone https://github.com/Synapsr/lenn.git && cd lenn
   

2. 2

   Remplissez trois valeurs

   Copiez le fichier d’exemple, puis renseignez LENN_PUBLIC_URL (l’adresse publique de votre serveur), LENN_AUTH_SECRET et POSTGRES_PASSWORD. Ne changez plus jamais le secret ensuite : vos clés enregistrées et vos appareils en dépendent.

   $ cp deploy/.env.example deploy/.env
   $ openssl rand -base64 48    # LENN_AUTH_SECRET
   $ openssl rand -hex 24       # POSTGRES_PASSWORD
   

3. 3

   Lancez Lenn

   Une seule commande démarre PostgreSQL, applique les migrations, puis lance l’application web et le worker. L’application écoute sur 127.0.0.1:3210, jamais directement sur internet.

   $ docker compose -f deploy/compose.yaml up -d --build
   

4. 4

   Mettez-le derrière HTTPS

   Placez un proxy inverse devant Lenn. Avec Caddy, le certificat est automatique. Ajoutez LENN_TRUST_PROXY=true dans deploy/.env. Voir l’exemple complet.

   lenn.example.org {
     reverse_proxy 127.0.0.1:3210 {
       flush_interval -1
     }
   }
   

5. 5

   Ouvrez l’assistant

   Ouvrez votre adresse dans un navigateur. La première visite crée le compte administrateur, puis l’assistant vous aide à coller vos clés et à les tester d’un bouton. Elles sont chiffrées en base ; les variables d’environnement restent prioritaires.

Vos clés, et à quoi elles servent

Lenn n’affiche que ce qui est réellement configuré sur votre serveur : sans clé OpenAI, par exemple, il n’y a pas de bouton de conversation vocale. Vous payez chaque fournisseur directement, à ses tarifs.

Sans aucune clé

Ajoutez LENN_AI=mock dans deploy/.env : transcriptions et réponses factices, idéal pour essayer, faire une démonstration ou contribuer au code.

D’autres fournisseurs, y compris locaux

• Transcription : Deepgram, ou tout serveur Whisper compatible OpenAI, y compris faster-whisper chez vous.
• Compagnon : toute API compatible OpenAI, comme Mistral, ou un modèle local avec Ollama.

Le service audio (facultatif)

Un service Python qui tourne à côté de Lenn : débruitage, détection de la parole, séparation des voix avec pyannote, et empreintes vocales pour reconnaître qui parle. Il fonctionne sur CPU, plus vite avec un GPU. Sans lui, Lenn transcrit quand même vos moments.

$ docker compose -f deploy/compose.yaml -f deploy/compose.audio.yaml up -d --build

Renseignez ensuite LENN_AUDIO_URL=http://audio:8000 et LENN_AUDIO_TOKEN dans deploy/.env. Le jeton Hugging Face suppose d’avoir accepté une fois les conditions du modèle pyannote.

Licences

Le code est sur GitHub : licence du serveur, licence des apps Apple.

Contribuer

• Un problème, une idée : ouvrez une issue.
• Le design system décrit le compagnon, les couleurs, la voix et le ton : un même produit partout.
• Pas envie d’installer quoi que ce soit ? Lenn Cloud fait tout cela pour vous.