lfpoulain / Cornelius

Un miroir qui vous reconnaît, vous écoute et vous répond, en français. 
 Fonctionnalités ·
 Installer ·
 Premiers pas ·
 Documentation ·
 Confidentialité ·
 Licence 
---
Cornelius transforme un écran, tel quel ou glissé derrière un miroir sans tain, en assistant pour toute la famille. Il reconnaît qui se présente devant lui, ouvre la conversation quand on le regarde ou qu’on l’appelle par son nom, et répond à la voix avec des cartes qui s’affichent sur le miroir : la météo, le prochain bus, la lumière du salon, un souvenir, une image…
La caméra, les visages et l’écoute du mot d’appel restent sur l’ordinateur du miroir. Seule la conversation passe par OpenAI, et seulement quand elle est ouverte.
## ✨ Ce que fait Cornelius
 🗣️ Il converse à la voix 
 En français, avec une voix naturelle, et affiche ses réponses sous forme de cartes sur le miroir.
 👋 Il sait quand on lui parle 
 Il ouvre la conversation quand une personne se présente, le regarde ou dit « Cornelius ». Le modèle du mot d’appel est fourni et tourne en local.
 🙂 Il reconnaît le foyer 
 Les visages sont reconnus sur l’ordinateur lui-même, avec un mode vie privée quand plusieurs personnes sont devant le miroir.
 🌤️ Il informe d’un coup d’œil 
 L’heure, la météo et les prochains passages de bus ou de RER, à la demande ou affichés en permanence.
 🏠 Il commande la maison 
 Avec Home Assistant ou des commandes HTTP, et il confie les tâches longues à des agents Hermes.
 🧠 Il se souvient 
 Des souvenirs propres à chaque personne, que chacun peut consulter, corriger ou effacer.
 👁️ Il voit et il dessine 
 En option, il décrit ce que montre la caméra et crée des images, sur l’ordinateur ou avec OpenAI.
 🧩 Il s’enrichit 
 Des modules ajoutent de nouvelles informations et de nouveaux outils vocaux. Les modules externes vivent dans cornelius-modules et se mettent à jour à part.
## 🧰 Ce qu’il faut
| | |
|---|---|
| 💻 **Ordinateur** | x86-64 sous Linux (Debian, Ubuntu, Arch ou une dérivée) ou Windows 10 et 11 |
| 🎥 **Matériel** | une webcam, un micro, des haut-parleurs et un écran (seul, ou derrière un miroir sans tain) |
| 🛠️ **Logiciels** | Node.js 24 (24.2 ou plus récent), Python 3.12 et Git |
| 🔑 **Clé OpenAI** | d’un compte payant : sans elle, Cornelius ne peut pas parler |
| ➕ **En option** | une carte graphique pour la vision et les images, un jeton Météo Concept pour la météo, un jeton PRIM pour les transports d’Île-de-France, des satellites audio (Waveshare ESP32-S3-AUDIO-Board) pour parler à Cornelius depuis d’autres pièces |
## 🚀 Installer
### 🐧 Linux
Récupérez les outils de base et le code (sur Arch : `sudo pacman -S git curl unzip`) :
 [code] 
> [!TIP]
> Si la dernière commande n’affiche pas `v24.2` ou plus récent dans la version 24 (cas d’Ubuntu et Debian), installez fnm, un gestionnaire de versions de Node.js sans droits administrateur, puis ouvrez un nouveau terminal et revenez dans le dossier :
>
> [code] 
Lancez ensuite l’installation. Elle installe Node.js 24 avec fnm, les dépendanc