安装

<!-- 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 有意保持轻量。只有在你明确要求时，设置向导才会安装较重的配套/运行时组件：

# 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 — 运行时 Cognee add/cognify 工作流；设置会保存 {python} -m pip install cognee，如果缺少 Cognee 会重试一次。
• Understand Anything — 选择 --install-understand-anything 时通过上游安装器安装；Tesserae 会保存一个托管的刷新 wrapper，而不是要求用户自己发明 shell 命令。
• graphiti-core — 实时 Graphiti/Neo4j 同步。没有它时，export-graphiti 和 sync-graphiti --dry-run 仍可工作。

Anthropic 支持的合成路径使用 extras 标记：

pip install "tesserae[synthesis-llm]"

从源码安装（贡献者）

如果你想修改代码库，请改用可编辑 checkout 安装：

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

仓库还附带一个便捷安装器：它会 clone、创建项目本地 .venv、运行 pip install -e .，并把 wrapper 放到 ~/.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