インストール

<!-- translations:start -->

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

<!-- translations:end --> Tesserae は PyPI で公開されており、ユーザーが python3 -m tesserae.cli を手動で実行しなくて済むように shell コマンドを提供します。

PyPI からインストール（推奨）

pip install tesserae

これだけです。pip は PATH に 3 つのコンソールスクリプトを登録します。

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 — ランタイム Cognee add/cognify ワークフロー。セットアップは {python} -m pip install cognee を保存し、Cognee が見つからない場合は一度だけ再試行します。
• Understand Anything — --install-understand-anything が選択された場合、upstream インストーラーでインストールされます。Tesserae はユーザーに shell コマンドを作らせる代わりに、管理された refresh wrapper を保存します。
• 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 .

便利なインストーラーも同梱されています。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