설치

<!-- translations:start -->

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

<!-- translations:end --> Tesserae는 PyPI에 게시되어 있으며, 사용자가 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이 선택되면 upstream 설치 프로그램으로 설치됩니다. Tesserae는 사용자에게 셸 명령을 만들라고 요구하는 대신 관리형 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를 사용했다면 셸을 다시 시작하거나 다음을 실행하세요.

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

설치 확인

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