Guidedog 빌드와 설치¶
macOS에서 Homebrew로 설치하기¶
Apple Silicon 또는 Intel Mac에서 공식 tap insanai/homebrew-guidedog 를 사용하세요.
brew tap insanai/guidedog
brew install insanai/guidedog/guidedog
guidedog --version
Homebrew가 프로세서에 맞는 릴리스 패키지를 선택하고 SHA-256을 확인합니다. 패키지에는 Typst, Graphviz, tree-sitter가 포함되어 있습니다. HTML과 PDF를 만들 때 Odin 컴파일러, Python 환경, 별도의 Typst 설치가 필요하지 않습니다. macOS 12 이상이 필요합니다.
첫 프로젝트 에 따라 첫 프로젝트를 만드세요. 설치된 버전을 업데이트하려면 다음을 실행하세요.
brew update
brew upgrade insanai/guidedog/guidedog
brew test insanai/guidedog/guidedog 를 실행하면 프로젝트를 만들고 HTML과 PDF를 빌드하여 설치된 패키지를 확인할 수 있습니다.
소스에서 빌드하기¶
tools/odin-release.txt 에 지정된 Odin 도구 모음을 사용하세요. 릴리스는 Odin dev-2026-10 과 Typst 0.15.1을 사용합니다. 공유 라이브러리 빌드에는 Graphviz 개발 라이브러리가 필요합니다.
개발용 빌드¶
저장소 루트에서 실행하세요.
mkdir -p build
native/tree-sitter/build.sh
odin build cmd/guidedog -out:build/guidedog -o:speed -vet -strict-style
build/guidedog --version
build/guidedog formats
tree-sitter 빌드는 소스 기반 autodoc용으로 버전이 고정된 Python 문법을 제공한다. Graphviz 개발 파일은 시스템 패키지 관리자로 설치한다. Typst 브리지가 없는 빌드는 설치된 typst로 PDF를 만든다. --typst=/absolute/path/to/typst로 직접 선택할 수 있다.
내장 컴파일러¶
네이티브 의존성을 한 번 빌드한 뒤 Odin 실행 파일에 링크하세요.
cargo build --release --manifest-path native/typst_bridge/Cargo.toml
native/graphviz/build.sh
odin build cmd/guidedog -out:build/guidedog -o:speed \
-define:GUIDEDOG_TYPST_BRIDGE=true -define:GRAPHDOG_STATIC=true
Typst 브리지는 Rust 코드이며 Guidedoc의 무할당 경계 밖에 있다. 내장 빌드는 별도의 Typst 실행 파일을 띄울 필요를 없애지만 컴파일러 자체의 메모리 비용은 그대로다.
Windows에서는 출력 이름을 build/guidedog.exe로 한다. 경로 없이 guidedog을 쓰려면 실행 파일을 PATH에 넣는다.