インストール

<!-- translations:start -->

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

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

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

pip install tesserae

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

tesserae --help
tesserae_mcp --help

ドキュメントにおける正規のコマンドは tesserae です。tesserae_mcp は MCP サーバーを起動します（現在はオンデマンドの compile_context ツールを公開しています — Quickstart を参照）。

pipx でも問題ありません。 CLI ツールをそれぞれ独立した venv に保ちたい場合:

pipx install tesserae

uv でも問題ありませんが、extra は引用符の内側に書きます。 uv tool install に --extra フラグはないため（uv 0.10 で確認）、uv tool install tesserae --extra semantic は unexpected argument '--extra' で終了し、extra は一切入りません:

uv tool install "tesserae[semantic]"        # extra は引用符の内側
uv tool install --with model2vec tesserae   # 等価

スクリプト化する場合は終了ステータスを確認してください。semantic のインストールが 黙って飛ばされることが、hybrid retrieval と associate が非セマンティックのスタブに フォールバックする原因です。

アップグレード

pip install --upgrade tesserae

マシン全体のセットアップ（1 回設定すれば全プロジェクトに適用）

プロジェクトごとではなく一度だけ Tesserae を設定し、オプションの依存関係を 1 つのコマンドでインストールします:

# 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)

既知のオプション依存関係: memex（高速トランスクリプト検索）と raganything。プロジェクトごとの .tesserae/config.json はこれらのグローバルデフォルトを引き続き上書きします（解決順序: env → project → global → built-in）。tesserae init もインタラクティブなセットアップ中に memex のインストールを提案します。

オプションの統合（プロジェクトごと）

デフォルトの wheel は意図的に軽量であり、オプションのメモリバックエンドは デフォルトで無効です。tesserae init はプロジェクトごとの唯一のオンボーディングステップです — そのウィザードが LLM プロバイダと検出されたソースを選択します。より重い コンパニオン/ランタイム部品は tesserae setup --install …（または tesserae config deps --install …）でマシン全体にインストールし、 .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`)

高度なワークフローのために、手動でのパッケージインストールも引き続き利用できます:

pip install kuzu graphiti-core

• kuzu — Kuzu グラフの永続化。
• RAG-Anything — pip install 'raganything[all]' 経由でインストールされます（tesserae setup --install raganything）。Tesserae はマルチモーダルパーサー実行のための管理されたリフレッシュラッパーを保存します。
• graphiti-core — ライブの Graphiti/Neo4j 同期。export graphiti と export graphiti --sync --dry-run はこれがなくても動作します。

Anthropic を利用する synthesis パスは extras マーカーを使います:

pip install "tesserae[synthesis-llm]"

実際のセマンティック埋め込み（v0.5.0 以降のデフォルト検索レーン）は semantic extra の背後で提供されます:

pip install "tesserae[semantic]"

これは model2vec を取り込み、軽量でオフライン、torch 不要の静的モデル（約 8 MB の potion-base-8M、初回使用時に一度だけ取得）をダウンロードします。これがない場合、hybrid/embedding 検索は非セマンティックなハッシュバケットのスタブにフォールバックし、目立つ警告を発するため、tesserae ask、tesserae context、または MCP の compile_context ツールを使うすべての人に、この extra のインストールを推奨します。

すべてのパーサーがプリインストールされたマルチモーダル RAG-Anything スタックには:

pip install 'tesserae[raganything-all]'

システム前提条件: .doc/.docx/.ppt/.pptx/.xls/.xlsx のパースにはホスト上の LibreOffice が必要です。プラットフォームのパッケージマネージャでインストールしてください（例: brew install --cask libreoffice、apt-get install libreoffice）。LibreOffice がない場合、RAG-Anything は警告を出して Office ドキュメントをスキップします。

ソースからのインストール（コントリビューター向け）

コードベースをいじりたい場合は、代わりに編集可能なチェックアウトをインストールします:

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

便利なインストーラも同梱されています — クローンし、プロジェクトローカルの .venv を作成し、pip install -e . を実行し、ラッパーを ~/.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 を使った場合は、シェルを再起動するか、次を実行してください:

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

インストールの確認

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