Установка

<!-- translations:start -->

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

<!-- translations:end --> Tesserae опубликован в PyPI и предоставляет shell-команды, чтобы пользователям не приходилось вручную запускать python3 -m tesserae.cli.

Установка из PyPI (рекомендуется)

pip install tesserae

Готово. pip зарегистрирует три консольных скрипта в вашем PATH:

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

Каноническая команда в документации — tesserae; tesserae (с дефисом) является псевдонимом. tesserae_mcp запускает MCP-сервер.

pipx тоже подходит. Если вы предпочитаете держать CLI-инструменты в отдельных изолированных venv:

pipx install tesserae

Обновление

pip install --upgrade tesserae

Необязательные интеграции

Стандартный wheel намеренно лёгкий. Мастер настройки может установить более тяжёлые companion/runtime-компоненты только тогда, когда вы этого попросите:

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

Для продвинутых рабочих процессов по-прежнему доступна ручная установка пакетов:

pip install kuzu cognee graphiti-core

• kuzu — персистентность графа Kuzu.
• cognee — runtime-процессы Cognee add/cognify; настройка сохраняет {python} -m pip install cognee и повторяет один раз, если Cognee отсутствует.
• Understand Anything — устанавливается через upstream-инсталлятор, когда выбран --install-understand-anything; Tesserae сохраняет управляемый refresh wrapper вместо того, чтобы просить пользователей придумывать shell-команду.
• graphiti-core — живая синхронизация Graphiti/Neo4j. export-graphiti и sync-graphiti --dry-run работают и без него.

Путь синтеза на базе Anthropic использует маркер extras:

pip install "tesserae[synthesis-llm]"

Установка из исходного кода (для контрибьюторов)

Если вы хотите дорабатывать кодовую базу, установите editable checkout:

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

Также включён удобный установщик: он клонирует репозиторий, создаёт локальный для проекта .venv, запускает pip install -e . и кладёт wrappers в ~/.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"

Полезные флаги (./scripts/install.sh --help):

Если использовался --skip-shell-config, перезапустите shell или выполните:

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

Проверка установки

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