Ouvrez le setup
Allez sur http://localhost:3000/setup et utilisez le mot de passe affiché par init-env.sh. Le dashboard reste lié à 127.0.0.1 par défaut.
Installation
Chez vous.
Pas à pas.
NervaBrain s’exécute dans Docker et conserve le vault sur votre disque. Cette page couvre l’installation, le premier accès, la connexion facultative de l’IA et les vérifications utiles.
Démarrage rapide
Quatre commandes.
Puis un setup guidé.
Installez Git, Docker Engine ou Docker Desktop, puis vérifiez que docker compose version répond. Le script crée ensuite votre .env et ses secrets locaux.
Docker Compose v2 Git Linux, macOS ou VPS Port 3000 disponible
git clone https://github.com/paulgdl9/nervabrain.git
cd nervabrain
./scripts/init-env.sh
docker compose up -d --buildAprès les quatre commandes
Vérifier, connecter,
puis garder la main.
Le premier démarrage construit les images et peut prendre plusieurs minutes. Les commandes ci-dessous suffisent pour contrôler l’instance et l’entretenir.
Contrôlez les services
ps doit montrer l’application et le bridge en état sain. Le point de contrôle doit répondre {"ok":true}.
docker compose ps
curl -fsS http://127.0.0.1:3000/api/health
docker compose logs --tail=100 second-brainConnectez l’IA si nécessaire
Une clé API peut être saisie dans le setup. Pour utiliser vos abonnements CLI, authentifiez Codex ou Claude dans le conteneur privé, puis vérifiez la connexion dans les réglages.
docker compose exec ai-bridge codex login --device-auth
docker compose exec ai-bridge claude auth loginMettez à jour sans déplacer vos données
vault/ et data/ restent montés depuis la machine. Sauvegardez ces deux dossiers avant une mise à jour importante.
git pull --ff-only
docker compose up -d --build
docker compose psLe setup fait le reste
Votre système,
pas un template générique.
- 01Définissez le contexte
Langue, fuseau horaire, domaines de vie et objectifs structurent le vault initial.
- 02Activez les modules utiles
Finance, budget, entraînement et espaces personnalisés restent optionnels.
- 03Connectez une IA, ou passez
Clé API ou session CLI pour Claude et Codex. Aucun fournisseur n’est obligatoire et les identifiants restent dans
data/, hors du vault et de Git. - 04Testez la boucle cœur
Envoyez une première capture, vérifiez son classement automatique, puis ouvrez le Daily.
- 05Ouvrez le vault
Obsidian, Git ou votre éditeur habituel voient de simples fichiers Markdown.
Deux dossiers à sauvegarder.
vault/ contient votre mémoire. data/ conserve les secrets, sessions et préférences hors de Git.
Local par défaut.
Le dashboard écoute sur 127.0.0.1:3000. Rien n’est exposé publiquement pendant l’installation standard.
Accès distant explicite.
Cloudflare Access, VPN ou LAN peuvent être ajoutés ensuite. L’ouverture réseau reste une décision séparée.
Mises à jour réversibles.
Le code évolue sans déplacer le vault. La désinstallation des services conserve les fichiers personnels.
Questions fréquentes
Avant de commencer.
L’IA est-elle obligatoire ?
Non. Le dashboard, le vault et les fallbacks locaux fonctionnent sans Claude ni Codex.
Puis-je utiliser Obsidian ?
Oui. Le dossier vault/ est un vault Obsidian normal composé de Markdown et de propriétés YAML.
Que se passe-t-il si j’arrête NervaBrain ?
Vos fichiers restent lisibles et exploitables avec n’importe quel éditeur Markdown.
Comment sauvegarder mes données ?
Git, Syncthing, rsync ou le profil Restic fourni peuvent copier le vault vers un autre disque ou serveur.
Comment l’ouvrir depuis une autre machine ?
Gardez le port local et ajoutez un VPN ou Cloudflare Access. Sur un LAN de confiance, adaptez SECOND_BRAIN_BIND et les règles d’écriture dans .env avant de redémarrer Compose.
Où regarder si le setup ne répond pas ?
Lancez docker compose ps, puis docker compose logs --tail=100 second-brain. Une erreur de port, de permission sur le vault ou de variable .env apparaît généralement dans ces deux sorties.
Prêt à ouvrir votre vault ?