Instalación

<!-- translations:start -->

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

<!-- translations:end --> Tesserae se publica en PyPI y expone comandos de shell para que los usuarios no tengan que ejecutar python3 -m tesserae.cli manualmente.

Instalar desde PyPI (recomendado)

pip install tesserae

Eso es todo. pip registra tres scripts de consola en tu PATH:

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

El comando canónico en la documentación es tesserae; tesserae (con guion) es un alias. tesserae_mcp inicia el servidor MCP.

pipx también sirve. Si prefieres mantener las herramientas CLI en venvs aislados:

pipx install tesserae

Actualizar

pip install --upgrade tesserae

Integraciones opcionales

La wheel predeterminada es deliberadamente ligera. El asistente de configuración puede instalar las piezas complementarias/de runtime más pesadas solo cuando se lo pidas:

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

Las instalaciones manuales de paquetes siguen disponibles para flujos avanzados:

pip install kuzu cognee graphiti-core

• kuzu — persistencia de grafos Kuzu.
• cognee — flujos runtime add/cognify de Cognee; la configuración guarda {python} -m pip install cognee y reintenta una vez si falta Cognee.
• Understand Anything — se instala mediante el instalador upstream cuando se selecciona --install-understand-anything; Tesserae guarda un wrapper de actualización gestionado en lugar de pedir a los usuarios que inventen un comando shell.
• graphiti-core — sincronización en vivo Graphiti/Neo4j. export-graphiti y sync-graphiti --dry-run funcionan sin él.

La ruta de síntesis respaldada por Anthropic usa un marcador extras:

pip install "tesserae[synthesis-llm]"

Instalar desde el código fuente (para contribuidores)

Si quieres trabajar en el código, instala el checkout editable:

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

También se incluye un instalador de conveniencia: clona, crea un .venv local del proyecto, ejecuta pip install -e . y deja los wrappers en ~/.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"

Flags útiles (./scripts/install.sh --help):

Si usaste --skip-shell-config, reinicia la shell o ejecuta:

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

Verificar la instalación

tesserae project init --help
tesserae project compile --help
tesserae project build-site --help