Docs
De rien du tout à une mémoire interrogeable que votre assistant peut lire.
Accès anticipé. Ces étapes décrivent la version de bureau pour Windows et la réplique hébergée. Les deux changent chaque semaine ; si quelque chose ici ne correspond pas à ce que vous voyez, c'est l'application qui a raison et cette page qui est périmée — dites-le-nous à hello@varven.net.
1. Installer
Téléchargez l'installateur Windows et lancez-le. Au premier démarrage, Varven demande deux choses :
- Un dossier de coffre. N'importe quel dossier. Si vous tenez déjà des notes en Markdown, pointez-le dessus — Varven lit ce qui s'y trouve déjà.
- L'autorisation d'exécuter un modèle local. L'organisation se fait sur votre propre matériel, et rien n'exige le cloud.
Varven utilise votre GPU automatiquement quand vous en avez un et se rabat sur le CPU sinon : plus lent, mais ça fonctionne et ça n'échouera pas en silence.
2. Vérifier votre coffre
Avant la première synchronisation, Varven inspecte votre coffre et signale ce qui ne passerait pas proprement — doublons, notes inclassables, entrées trop longues pour être indexées en entier. La vérification tourne en local et n'envoie rien.
3. Connecter un client IA
Varven parle le Model Context Protocol via Streamable HTTP, donc n'importe quel client MCP fonctionne. Dans Claude : Paramètres → Connecteurs → Ajouter un connecteur personnalisé, puis collez :
https://api.varven.net/mcpClaude vous enverra vers une page de connexion. Approuvez, et le connecteur apparaît dans votre liste d'outils. La même URL fonctionne dans tout client qui prend en charge les connecteurs MCP distants — ChatGPT, Gemini, Cursor et VS Code entre autres, dans la limite de leur propre prise en charge des connecteurs. Voir les réglages de connecteurs de chaque client.
4. Ce que votre assistant peut faire
| Outil | Ce qu'il fait |
|---|---|
memory_search | Recherche hybride, par mots-clés et sémantique, dans tout votre coffre |
memory_get | Récupérer un souvenir complet par son id |
memory_briefing | Contexte permanent : éléments épinglés, préférences, corrections |
memory_timeline | Ce qui a changé récemment, dans l'ordre |
Les quatre sont en lecture seule dans la version actuelle. L'écriture depuis le cloud est sur la feuille de route.
Lire un résultat
Les résultats portent des indicateurs auxquels il vaut la peine de prêter attention :
- stale — personne n'a revérifié cette affirmation récemment. Les différents types de mémoire vieillissent à des vitesses différentes, et l'indicateur en tient compte. Les préférences et corrections n'expirent jamais, car elles sont vraies du seul fait d'avoir été dites.
- weak_match — même le meilleur résultat a obtenu un score faible. Ce n'est probablement pas votre réponse, et votre assistant devrait le dire plutôt que de broder une prose assurée autour.
- superseded — ceci a été remplacé par quelque chose de plus récent. L'ancienne version reste interrogeable, ce qui permet de demander quand une chose a changé au lieu de réécrire l'historique en silence.
Quand quelque chose cloche
La recherche ne renvoie rien alors que le coffre contient des notes
En général, la première synchronisation n'est pas terminée. Regardez le panneau de synchronisation. S'il indique que c'est terminé,
lancez --inspect — un coffre sans frontmatter reconnu se synchronise sans erreur
et se cherche mal.
La première question après une pause est lente
Le modèle local se décharge quand il est inactif et met environ 30 secondes à revenir en VRAM. Ce n'est pas un blocage. Cela ne touche que les opérations locales ; la réplique cloud répond immédiatement.
Le connecteur refuse d'autoriser
C'est presque toujours une URL qui ne correspond pas. L'adresse doit être exactement
https://api.varven.net/mcp — pas de barre oblique finale, pas de http://.
Les identifiants de ressource OAuth sont comparés littéralement et un écart échoue avec un
message peu utile.
Les réponses se sont dégradées sans aucune erreur
Le modèle local est probablement injoignable, et la recherche s'est discrètement rabattue sur les seuls mots-clés. Le panneau d'état indique la santé du modèle. Cette panne est silencieuse par nature, d'où l'existence de l'indicateur.