Installation

<!-- translations:start -->

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

<!-- translations:end --> Tesserae est publié sur PyPI et expose des commandes shell pour 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 sur votre PATH :

tesserae --help
tesserae_mcp --help

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

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

pipx install tesserae

uv convient aussi, mais les extras s'écrivent à l'intérieur des guillemets. uv tool install n'a pas d'option --extra (vérifié avec uv 0.10), donc uv tool install tesserae --extra semantic se termine sur unexpected argument '--extra' et l'extra n'est jamais installé :

uv tool install "tesserae[semantic]"        # les extras, dans les guillemets
uv tool install --with model2vec tesserae   # équivalent

Vous le scriptez ? Vérifiez le code de sortie. Une installation de semantic silencieusement ignorée est exactement la raison pour laquelle la recherche hybride et associate retombent sur le stub non sémantique.

Mise à niveau

pip install --upgrade tesserae

Configuration machine (une fois, tous les projets)

Configurez Tesserae une seule fois au lieu de par projet, et installez les dépendances optionnelles en une commande :

# Interactive machine-wide setup — pick LLM provider/effort + which deps to install:
tesserae setup
# …or non-interactively (written to ~/.tesserae/config.json) + install everything:
tesserae setup --llm-provider codex --reasoning-effort medium --install all

# Just see / manage optional dependencies
tesserae config deps                     # show what's installed
tesserae config deps --install memex     # fast transcript search (needs cargo)

Dépendances optionnelles connues : memex (recherche rapide de transcriptions) et raganything. Un .tesserae/config.json par projet prime toujours sur ces valeurs globales (ordre de résolution : env → projet → global → défaut intégré). tesserae init propose aussi d’installer memex lors d’une configuration interactive.

Intégrations optionnelles (par projet)

La wheel par défaut est volontairement légère, et les backends de mémoire optionnels sont désactivés par défaut. tesserae init est l’unique étape d’intégration par projet — son assistant choisit le fournisseur LLM et les sources détectées ; les pièces compagnons/runtime plus lourdes s’installent au niveau machine via tesserae setup --install … (ou tesserae config deps --install …) et s’activent par projet dans .tesserae/config.json :

# Machine-wide installs of the optional pieces:
tesserae setup --install raganything

# Then per project: enable what you want in .tesserae/config.json
#   memory_backends.raganything.enabled: true   (query via `tesserae query --backend raganything`)

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

pip install kuzu graphiti-core

• kuzu — persistance de graphe Kuzu.
• RAG-Anything — installé via pip install 'raganything[all]' (tesserae setup --install raganything) ; Tesserae stocke un wrapper de rafraîchissement géré pour les exécutions du parseur multimodal.
• graphiti-core — synchronisation Graphiti/Neo4j en direct. export graphiti et export graphiti --sync --dry-run fonctionnent sans lui.

Le chemin de synthèse adossé à Anthropic utilise un marqueur extras :

pip install "tesserae[synthesis-llm]"

Les vrais embeddings sémantiques (la voie de récupération par défaut depuis la v0.5.0) sont livrés derrière 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 (~8 Mo potion-base-8M, récupéré une fois au premier usage). Sans lui, la récupération hybride/par embeddings retombe sur un stub hash-bucket non sémantique et émet un avertissement bruyant, donc installer cet extra est recommandé pour quiconque utilise tesserae ask, tesserae context ou l’outil MCP compile_context.

Pour la pile multimodale RAG-Anything avec tous les parseurs préinstallés :

pip install 'tesserae[raganything-all]'

Prérequis système : le parsing de .doc/.docx/.ppt/.pptx/.xls/.xlsx requiert LibreOffice sur l’hôte. Installez-le via le gestionnaire de paquets de votre plateforme (p. ex. brew install --cask libreoffice, apt-get install libreoffice) ; RAG-Anything saute les documents Office avec un avertissement quand LibreOffice est absent.

Installer depuis les sources (pour les contributeurs)

Si vous voulez bidouiller le code, installez plutôt le checkout éditable :

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

Un installeur de commodité est également fourni — il clone, crée un .venv local au projet, lance 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"

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

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

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

Vérifier l’installation

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