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 trois scripts console dans votre PATH :

tesserae --help
tesserae --help
tesserae_mcp --help

La commande canonique dans la documentation est tesserae ; tesserae (avec un tiret) est un alias. tesserae_mcp démarre le serveur MCP.

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 project setup \
  --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 sync-graphiti --dry-run fonctionnent sans lui.

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

pip install "tesserae[synthesis-llm]"

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 project init --help
tesserae project compile --help
tesserae project build-site --help