Gas City - 다중 에이전트 시스템 orchestration-builder SDK

Gas City 는 다중 에이전트 시스템 (multi-agent systems) 을 위한 orchestration-builder SDK 입니다. Gas Town 에서 재사용 가능한 인프라를 추출하여 런타임 제공자 (runtime providers), 작업 라우팅, 공식 (formulas), 주문 (orders), 건강 감시 (health patrol), 그리고 선언적 도시 구성 (declarative city configuration) 을 갖춘 구성 가능한 툴킷으로 변환했습니다.

Coming from Gas Town? 에서 시작하세요. Gas City 의 기본형 중심 모델 (primitive-first model) 에 Town 역할, 명령어, 플러그인, 컨보이 (convoys), 그리고 디렉터리 습관 (directory habits) 을 매핑하여 경험 많은 Gas Town 사용자들이 전체 Town 아키텍처를字面적으로 포팅하는 대신에 쉽게 적응할 수 있습니다.

• city.toml 에 대한 선언적 도시 구성
• 여러 런타임 제공자: tmux, subprocess, exec, ACP, 그리고 Kubernetes
• Beads 기반 작업 추적, 공식 (formulas), 분자 (molecules), 대기 (waits), 그리고 메일
• 원하는 상태와 실행 중인 상태를 조정하는 컨트롤러/감독자 루프
• 다중 프로젝트 설정을 위한 팩스 (packs), 오버라이드, 및 리스크 범위 (rig-scoped) orchestration

설치 가이드를 docs/getting-started/installation.md 에서 확인하세요.

Gas City 는 시스템에 다음 도구를 필요로 합니다. gc init 및 gc start 는 자동으로 이를 확인하고 누락된 항목을 보고합니다.

Dependency	Required	Min Version	Install (macOS)	Install (Linux)
tmux	Always	—	brew install tmux	apt install tmux
git	Always	—	brew install git	apt install git
jq	Always	—	brew install jq	apt install jq
pgrep	Always	—	(included in macOS)	apt install procps
lsof	Always	—	(included in macOS)	apt install lsof
dolt	Beads provider bd	1.86.2 or newer	brew install dolt	releases
bd	Beads provider bd	1.0.0	releases	releases
flock	Beads provider bd	—	brew install flock	apt install util-linux
claude / codex / gemini	Per provider	—	See provider docs	See provider docs

bd (beads) 제공자는 기본값입니다. 파일 기반 스토어를 사용하려면 (dolt/bd/flock 필요 없음), GC_BEADS=file 를 설정하거나 city.toml 에 [beads] provider = "file" 를 추가하세요.

Managed Dolt 확인은 최종 Dolt 1.86.2 또는 최신 버전이 필요합니다. 이전 및 프리리리스 빌드는 dolthub/dolt 커밋 ccf7bde206 에서의 upstream GC/writer deadlock fix 을 놓칠 수 있으며, 이는 dolt_backup sync 를 중량한 쓰기 하중 (heavy write load) 에 걸려 멈출 수 있습니다.

Homebrew 에서 설치:

brew install gastownhall/gascity/gascity
gc version

또는 소스 (make 와 Go 1.25+ 필요) 에서 빌드:

make install
gc init ~/bright-lights
cd ~/bright-lights
...

더 긴 워크투를 위해 Tutorial 01 로 시작하세요.

문서는 docs/ 를 루트로 하는 Mintlify 구조를 사용합니다.

• Docs Home
• Installation
• Quickstart
• Repository Map
• Contributors
• Reference
• Architecture
• Design Docs
• Archive

로컬에서 문서를 미리 보려면:

make docs-dev
# 또는 리포지토리 루트 에서 직접
./mint.sh dev

cmd/gc/: CLI 명령어, 컨트롤러 와이어링, 및 감독자 통합
internal/runtime/: 런타임 제공자 추상화 및 구현
internal/config/: city.toml 스키마, 팩스 (pack) 구성, 및 유효성 검사
internal/beads/: 스토어 추상화 및 제공자 구현
internal/session/: 세션 bead 메타데이터 및 대기 헬퍼
internal/orders/: 주기적 공식 및 exec 디스패치
internal/convergence/: 제한된 반복적 정제 루프
examples/: 샘플 도시, 팩스, 공식, 및 구성
contrib/: 헬퍼 스크립트 및 배포 자산
test/: 통합 및 지원 테스트 패키지

PR 을 열기 전에 CONTRIBUTING.md 와 engdocs/contributors/index.md 를 읽으세요.

유용한 명령어:

make setup
make check

make check-docs

make test-integration

MIT