gastownhall/gascity

Gas City – 다중 에이전트 코딩 워크플로우용 오케스트레이션 SDK

정의

• 코딩 관련 작업을 수행하는 에이전트(beads라고 함)의 모음인 cities를 선언적으로 정의하고 실행할 수 있는 Go 기반 SDK입니다.
• 더 큰 Gas Town 플랫폼에서 배관을 추출하여 조정된 AI 에이전트, 스크립트 또는 하위 프로세스가 필요한 모든 프로젝트에서 재사용할 수 있게 만드는 도구 상자로 생각하십시오.

핵심 개념

• city.toml – 에이전트의 원하는 상태, 런타임 및 작업 라우팅 방법을 설명하는 간단한 TOML 파일입니다.
• 런타임 제공자 – 에이전트를 실제로 실행하는 플러그인 백엔드입니다. 내장 옵션은 다음과 같습니다:
  • tmux(기본값, 각 에이전트를 자체 창에서 실행)
  • subprocess / exec
  • ACP(원격 실행)
  • Kubernetes
  • herdr(경량 세션 관리자)
• Beads – 영구 작업 추적 저장소입니다. 기본적으로 Dolt를 기반으로 하는 bd(Beads) 제공자를 사용하지만 파일 기반 저장소도 지원됩니다.
• 감독자 루프 – 원하는 도시 상태(선언한 것)와 실제 실행 상태를 지속적으로 조정하여 필요에 따라 에이전트를 생성, 중지 또는 재시작합니다.
• 팩 및 오버라이드 – 중복 없이 다중 프로젝트 설정을 구성할 수 있는 모듈식 구성 번들입니다.

주요 기능

• 재현 가능한 환경을 위한 선언적 구성(city.toml).
• 로컬 tmux 세션에서 Kubernetes 클러스터까지 여러 실행 백엔드.
• 내장 작업 추적, 수식 및 에이전트 간 메시징.
• 감독자를 통한 상태 확인 및 자동 복구.
• 프로젝트 간 공통 패턴 공유를 위한 확장 가능한 "팩".

일반적인 사용 사례

• 코드를 생성, 테스트 및 커밋하는 여러 LLM 기반 코딩 어시스턴트 조정.
• 데이터를 스크래핑하고, 처리하고, 결과를 다운스트림 모델에 공급하는 AI 에이전트 파이프라인 실행.
• 일부 에이전트는 로컬(tmux)에서 실행되고 다른 에이전트는 클라우드(K8s, ACP)에서 실행되는 하이브리드 워크로드 관리.

시작하기

1. CLI를 설치합니다(Homebrew 또는 make install).
2. 도시를 초기화합니다: gc init ~/my-city && cd ~/my-city.
3. gc rig add .로 rig(프로젝트 폴더)를 추가합니다.
4. 비드(작업 단위)를 생성합니다 – 예: bd create "Create a script that prints hello world".
5. 감독 세션에 연결합니다: gc session attach mayor를 실행하고 에이전트가 실행되는 것을 확인합니다.

아키텍처 개요

• cmd/gc/ – 진입점 CLI, 명령을 구문 분석하고 컨트롤러를 연결합니다.
• internal/runtime/ – 제공자용 추상화 계층; 각 제공자는 에이전트가 시작되고 모니터링되는 방법을 구현합니다.
• internal/config/ – city.toml을 구문 분석하고, 팩/오버라이드를 해결하고, 스키마를 검증합니다.
• internal/beads/ – 작업 항목, 메시지 및 대기 조건을 위한 저장 계층.
• internal/convergence/ – 감독자 루프를 구동하는 조정 엔진.
• internal/api/ – 외부 도구용 선택적 HTTP API.

문서 및 커뮤니티

• 전체 문서: https://docs.gascityhall.com (Mintlify 사이트).
• 빠른 시작 튜토리얼, 설계 문서 및 아키텍처 개요는 저장소의 docs/ 및 engdocs/에 있습니다.
• 도움말과 공지사항을 위해 Discord 커뮤니티에 가입하세요.

라이선스

• MIT – 자유롭게 사용, 수정 및 배포할 수 있습니다.

---

Gas City는 정교한 다중 에이전트 AI 또는 자동화 파이프라인을 구축하는 개발자를 위한 실제 프로덕션급 프로젝트입니다. 다양한 실행 환경에서 에이전트를 정의, 시작 및 건강하게 유지하는 데 필요한 배관을 제공합니다.