빠른 시작

요구사항

• Python 3.12 이상
• uv 패키지 매니저 (설치 안내)
• 최소 한 개의 프로바이더 API 키 (Anthropic, OpenAI 또는 GLM)

설치

PyPI 배포명은 geode-agent이고, 설치되는 실행 명령은geode입니다.

uv tool install geode-agent
geode version

현재 릴리즈가 아직 PyPI에 공개되지 않았거나 GEODE 자체를 개발한다면 소스 체크아웃으로 설치합니다.

git clone https://github.com/mangowhoiscloud/geode.git
cd geode
uv sync
uv tool install -e . --force

설정

프로바이더 API 키는 ~/.geode/config.toml 또는 환경 변수에 지정합니다. 활성화하려는 폴백 체인에 따라 필요한 키가 달라집니다.

export ANTHROPIC_API_KEY=sk-ant-...
export OPENAI_API_KEY=sk-...
export GLM_API_KEY=...           # optional, third fallback chain
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318 # optional, with [obs] extra

실행

# Interactive REPL
geode

# One-shot natural language
geode "summarize the latest AI research trends"

# Daemon mode (long-running, IPC-served)
geode serve

업데이트와 삭제

uv tool upgrade geode-agent   # PyPI 설치 업데이트
geode update                  # 소스 체크아웃 업데이트
geode uninstall               # 런타임 데이터 + 설치된 CLI 제거
uv tool uninstall geode-agent # CLI만 제거

방금 일어난 일

geode를 실행하면 thin CLI가 serve daemon에 연결되고, 자연어 요청은 AgenticLoop를 통해 tool/MCP/skill 경로로 처리됩니다.

1. serve daemon 자동 기동 또는 기존 daemon 재사용
2. 프로젝트/사용자 memory, MCP, skill registry 초기화
3. LLM provider routing과 tool registry 연결
4. 대화 세션과 실행 로그를 지속 저장

다음 단계

• 4-계층 스택. 코드베이스가 어떻게 구성되어 있는지 확인합니다.
• 시스템 색인. 모든 서브시스템과 파일 경로를 정리합니다.
• 프롬프트 시스템. 프롬프트 어셈블리 파이프라인을 살펴봅니다.