NotariumDocumentation
Version de la documentation: latest
FR

Démarrage rapide

Notarium est une base de connaissances auto-hébergée, conçue comme de simples fichiers Markdown sur votre propre disque — une base sur laquelle un humain et un agent IA travaillent d'égal à égal. Pas de cloud, pas de format propriétaire : les notes vivent dans des dossiers, et git peut faire office de source de vérité.

Cette section est le chemin le plus court de zéro jusqu'à une instance opérationnelle : déployez Notarium dans un seul conteneur, créez votre première note dans l'éditeur web, puis connectez votre agent via MCP. L'ensemble prend environ cinq minutes.

Ce qu'il vous faut

Simplement Docker (ou Docker Desktop) et un port libre. Tout le reste — l'éditeur web, le moteur et le point d'accès MCP pour les agents — est déjà inclus dans l'image. Pas besoin d'installer Node, une base de données ou un index vectoriel séparément.

Comment ça fonctionne

La même base de connaissances est ouverte à deux lecteurs à la fois. L'humain passe par l'éditeur web, l'agent par le point d'accès MCP ; tous deux voient le même graphe de notes, et sur le disque, ce n'est qu'une arborescence de fichiers .md.

flowchart LR
  human([Humain]) -->|éditeur web| core
  agent([Agent IA]) -->|MCP · start_session| core
  core[Moteur Notarium] --> files[(Fichiers Markdown<br/>sur le disque)]
  files -.->|git = source de vérité| git[(Dépôt)]

Le principe clé est file-first : une note est un fichier, pas une ligne dans la base de données de quelqu'un d'autre. Aucun export n'est nécessaire, car vous n'êtes jamais vraiment « à l'intérieur » — les données sont toujours les vôtres et toujours sur le disque.

Lancer une instance

Le moyen le plus rapide est de lancer l'image préconstruite. Elle est autonome : elle démarre le moteur, l'interface web et le point d'accès MCP d'un seul coup.

# Récupérer l'image et démarrer le conteneur
docker run -d --name notarium \
  -p 3000:3000 \
  -v notarium-data:/data \
  docouno/notarium:latest

Un unique volume /data contient tout l'état : la base de métadonnées, les index, vos notes et les artefacts d'export. Il n'y a rien de plus à configurer — le port 3000 et le chemin des données /data sont déjà intégrés dans l'image. Le port à gauche de 3000 peut être remplacé par n'importe quel port libre.

Ouvrez http://localhost:3000 — vous serez accueilli par l'écran de configuration initiale. Il crée le propriétaire de l'instance (le premier compte) et un espace de départ (personnel). Ensuite, vous voilà dans l'éditeur.

Port et données

Vous pouvez changer le port 3000 en modifiant le nombre de gauche dans -p <le vôtre>:3000. L'image docouno/notarium est publique — c'est la voie d'installation principale (les détails et la compilation depuis les sources se trouvent sur la page Installation). Le volume /data survit à la recréation du conteneur — mais protégez le volume lui-même : vos données partent avec lui.

Ce qui se passe en coulisses au premier lancement :

  • le moteur démarre et sert l'interface web sur le port que vous avez indiqué ;
  • l'arborescence de vos espaces est initialisée dans le volume /data ;
  • l'écran de configuration crée le propriétaire — le compte auquel appartient l'instance.

La suite

L'instance est opérationnelle — trois courtes étapes suivent. Chacune est détaillée sur sa propre page :

ÉtapePageCe que vous obtiendrez
1Installation et lancementUn tour d'horizon de docker / make up, des volumes et de l'écran de configuration
2Votre première noteL'arborescence de fichiers, l'éditeur web, l'enregistrement en .md
3Connecter un agentUn jeton, le point d'accès POST /mcp, l'appel de start_session

Vous voulez d'abord saisir le modèle dans son ensemble ? Jetez un œil à la section Concepts : espaces et projets, types de notes, graphe de connaissances et modèle d'accès pour les humains et les agents.