Installation

<!-- translations:start -->

English · 한국어 · 中文 · 日本語 · Русский · Español · Français · Deutsch

<!-- translations:end --> Tesserae est publié sur PyPI et expose des commandes shell afin que les utilisateurs n'aient pas à lancer python3 -m tesserae.cli manuellement.

Installer depuis PyPI (recommandé)

pip install tesserae

C'est tout. pip enregistre deux scripts console dans votre PATH :

tesserae --help
tesserae_mcp --help

La commande canonique dans la documentation est tesserae. tesserae_mcp démarre le serveur MCP (qui expose désormais l'outil compile_context à la demande — voir le Démarrage rapide).

pipx convient aussi. Si vous préférez garder les outils CLI dans leurs propres venv isolés :

pipx install tesserae

Mettre à niveau

pip install --upgrade tesserae

Intégrations facultatives

La wheel par défaut est volontairement légère. L'assistant de configuration peut installer les composants companion/runtime plus lourds uniquement lorsque vous le demandez :

# Understand Anything companion graph + Cognee runtime memory
tesserae init \
  --with-understand-anything \
  --install-understand-anything \
  --understand-anything-platform codex \
  --run-cognee \
  --install-cognee

Les installations manuelles de paquets restent disponibles pour les flux avancés :

pip install kuzu cognee graphiti-core

• kuzu — persistance de graphe Kuzu.
• cognee — workflows runtime Cognee add/cognify ; la configuration stocke {python} -m pip install cognee et réessaie une fois si Cognee manque.
• Understand Anything — installé via l'installateur upstream lorsque --install-understand-anything est sélectionné ; Tesserae stocke un refresh wrapper géré au lieu de demander aux utilisateurs d'inventer une commande shell.
• graphiti-core — synchronisation live Graphiti/Neo4j. export graphiti et export graphiti --sync --dry-run fonctionnent sans lui.

Le chemin de synthèse basé sur Anthropic utilise un marqueur extras :

pip install "tesserae[synthesis-llm]"

Les véritables embeddings sémantiques (la voie de récupération par défaut depuis la v0.5.0) sont fournis via l'extra semantic :

pip install "tesserae[semantic]"

Cela installe model2vec et télécharge un modèle statique léger, hors ligne et sans torch (environ 8 Mo de potion-base-8M, téléchargé une seule fois lors de la première utilisation). Sans lui, la récupération hybride/par embeddings retombe sur un stub non sémantique à seaux de hachage et émet un avertissement bien visible ; l'installation de cet extra est donc recommandée à quiconque utilise tesserae ask, tesserae context ou l'outil MCP compile_context.

Installer depuis la source (pour les contributeurs)

Si vous voulez modifier la base de code, installez plutôt le checkout editable :

git clone https://github.com/ca1773130n/Tesserae.git
cd Tesserae
pip install -e .

Un installateur pratique est également inclus : il clone, crée un .venv local au projet, exécute pip install -e . et dépose les wrappers dans ~/.local/bin :

# Quick: clone + install in one shot
curl -fsSL https://raw.githubusercontent.com/ca1773130n/Tesserae/main/scripts/install.sh | bash

# From an existing checkout
./scripts/install.sh --dir "$PWD"

Options utiles (./scripts/install.sh --help) :

Si --skip-shell-config a été utilisé, redémarrez le shell ou exécutez :

export PATH="$HOME/.local/bin:$PATH"

Vérifier l'installation

tesserae init --help
tesserae compile --help
tesserae export site --help