Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
Galley는 사용자의 컴퓨터에서 구동되는 가볍고 범용적인 개인 AI 어시스턴트입니다. 브라우저, 터미널, 파일 등 다양한 환경을 제어하며, 시스템 구조(harness)를 최소화하여 모델 자체의 능력이 작업을 처리하도록 설계되었습니다. 이로 인해 새로운 모델이 출시될 때마다 즉시 성능 향상을 반영할 수 있습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub AI Tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기Galley는 사용자의 컴퓨터에서 구동되는 개인 AI 어시스턴트로, 실제로 작업을 수행합니다 — 브라우저, 터미널, 파일은 물론 휴대폰까지 제어할 수 있습니다. 이 시스템의 구조(harness)는 의도적으로 가볍습니다: 엔진이 도구 세트를 최소화하고 컨텍스트를 밀집시켜 모델 자체의 능력이 작업을 처리하게 하며, 모든 모델 업그레이드는 Galley 업그레이드로 즉시 반영됩니다 — 저희가 따라잡을 때까지 기다릴 필요가 없습니다.
하나의 어시스턴트로 충분하지 않을 때는 Galley가 팀이 됩니다. 여러 세션이 병렬로 진행되며, 언제든지 전환하거나, 인계받거나, 재개할 준비가 되어 있습니다. 사용자는 GUI에서 진행 상황을 확인하고 지침을 보내고; Supervisor Agent는 CLI를 통해 동일한 팀을 오케스트레이션합니다 — 두 가지 역할, 하나의 공유 상태, 모든 것이 사용자 기기에서 이루어집니다.
번들된 엔진(bundled engine)에 의해 구동됩니다 — GenericAgent의 파생 작업물이며, 설치 프로그램 내부에 포함되어 첫 실행 시 바로 사용할 수 있습니다.
Galley의 오케스트레이션 레이어입니다. 사용자는 GUI에서 작업하고, Supervisor Agent는 안정적인 galley CLI를 통해 작동합니다. 둘 다 동일한 세션과 히스토리를 공유하는 일급(first-class) 운영자이므로 분리된 세계가 아닙니다.
먼저 모델을 어떻게 연결할지 결정해야 합니다. 코딩을 위한 ChatGPT / Codex, OpenAI, Anthropic, DeepSeek, Kimi, MiniMax, OpenRouter, SiliconFlow, Xiaomi MiMo, Zhipu GLM에 대한 사전 설정(Presets)이 내장되어 있으며, 엔드포인트가 미리 채워져 있습니다: ChatGPT / Codex는 사용자의 ChatGPT 계정으로 로그인하며, 나머지는 API 키를 사용합니다. 다른 OpenAI 또는 Anthropic과 호환되는 모든 엔드포인트의 경우 'Custom'을 선택하고 해당 URL을 입력하면 됩니다. Ollama와 같은 로컬 서버는 키가 필요하지 않습니다.
| 플랫폼 | 설치 파일 |
|---|---|
| macOS Apple Silicon | filename에 macOS_aarch64.dmg 포함 |
| ... |
Galley는 아직 코드 서명(code-signed)되지 않았습니다. 만약 macOS가 첫 실행을 차단하면 다음 명령어를 실행하세요:
xattr -dr com.apple.quarantine /Applications/Galley.app
Windows에서는 SmartScreen이 게시자가 알 수 없다고 표시할 때 "추가 정보(More info)"를 선택한 후 → "실행(Run anyway)"을 선택합니다.
이미 GenericAgent 환경을 가지고 있다면, **설정(Settings) → 런타임(Runtime) → 더 보기(More) → 외부 GA 연결(Connect external GA)**에서 GA 폴더를 선택하세요. 한 번 연결되면 Galley는 엄격하게 읽기 전용으로 유지되며 사용자의 외부 GA의 코드, 메모리, SOP 또는 mykey.py에 절대 접근하지 않습니다. 브라우저 제어 및 채널은 패키징된 엔진(bundled engine)에서만 실행되며, 설정(Settings) → 모델(Models) 아래 제공업체들은 패키징된 엔진을 사용합니다. 외부 GA는 자체의 mykey.py를 계속 사용합니다.
실행 중인 GUI에서 **설정(Settings) → 에이전트(Agent)**를 여세요:
| 버튼 | 기능 |
|---|---|
| Copy SOP | 짧은 galley-supervisor-sop.md를 복사합니다. 이를 통해 에이전트가 Galley 작업을 검사하고, 계속 진행하거나, 시작하거나, 분할하거나, 기다릴 수 있습니다. 고급 세부 정보는 Supervisor 참고 자료에 있습니다. |
| ... | |
You don't need to learn the CLI yourself — tell your Supervisor Agent what you want in natural language and let it operate Galley. The copied SOP is a lightweight hot path; detailed commands and advanced orchestration stay in the reference and Agent API. Claude Code 사용자는 동일한 SOP를 스킬로 설치할 수 있습니다: galley-supervisor (Codex 사본은 .agents/skills/ 아래에 있습니다.). |
작업은 하나의 거대한 프롬프트가 되는 대신 오른쪽 컨테이너로 확장됩니다:
또한 설정(Settings) → 채널(Channels) 에서 WeChat / Feishu / Telegram / Discord에 연결하여 휴대폰에서도 동일한 어시스턴트에 접근할 수 있으며, 이 경우 더 긴 작업은 데스크톱 세션으로 전달됩니다.
<details> <summary>CLI 예시 보기</summary>Galley가 실행 중일 때, 같은 장치에 있는 Supervisor Agent는 galley를 통해 작업을 전송할 수 있습니다:
# 현재 무엇이 실행되고 있나요? (각 행의 live.busy가 진실된 신호이며;
# live.askPending은 세션이 질문을 기다리고 있음을 의미합니다)
galley status
...
명령어 작성 시 --supervisor와 --reason를 사용합니다. --supervisor를 설정하면 작업이 via=supervisor로 기록되고 (그렇지 않으면 via=cli) 합니다. Supervisor가 생성한 세션과 메시지는 사이드바와 타임라인에 Supervisor 표시를 가져서, 사람이 에이전트로부터 무엇이 왔는지 한눈에 볼 수 있습니다.
전체 명령어 참고 자료, JSON 스키마 및 종료 코드는 Agent API 문서에 있습니다。
</details>GUI와 CLI는 **동등한 프런트엔드(peer frontends)**입니다. 즉, GUI가 CLI를 감싸는 구조가 아니라, 두 개가 각각 동일한 Rust Core에 직접 연결됩니다. GUI는 앱 내부에서, CLI는 로컬 소켓을 통해 연결되는 방식입니다. Core가 단일 권한 주체로서 세션/프로젝트 상태, 예약된 작업, SQLite 쓰기, 그리고 Galley가 실행하는 모든 Python 프로세스를 관리합니다. 기본적으로 이들은 번들된 엔진 위에서 바로 사용할 수 있도록 준비되어 있습니다.
flowchart TB
GUI["Galley GUI<br/>Tauri · React"] -- in-process --> Core
CLI["Galley CLI<br/>Rust"] -- "local socket · named pipe<br/>no TCP · no token" --> Core
...
세 가지 종류의 프로세스 모두 Python을 실행합니다. 외부 GA(GenericAgent)를 연결할 때는 세션 러너가 대신 사용하며, IM 채널과 브라우저 브리지는 비활성화됩니다.
기술 스택: Tauri v2 + React 19 + TypeScript 5.8 + Tailwind v4 / Rust (Galley Core + Galley CLI) / Python (러너, GenericAgent 래핑) / SQLite + FTS5 trigram
더 많은 문서:
Architecture ·
Contributing ·
Docs index
기능 목록에는 없지만 Galley의 엔지니어링 품질을 결정하는 몇 가지 설계 선택 사항:
<details> <summary>여섯 가지 설계 선택 사항 보기</summary>GUI를 감싸는 CLI가 아닌, 동등한 프런트엔드(Peer frontends). GUI와 CLI는 각각 독립적으로 Rust Core에 접근하므로 어느 한쪽도 다른 쪽에 의존하지 않습니다. 창을 닫아도 Core, 그 세션들, 그리고 CLI는 백그라운드에서 계속 실행됩니다. 채팅 앱 역시 자체 프로토콜이 필요하지 않았습니다. 각 IM 채널 내부에서도 어시스턴트는 Supervisor가 사용하는 것과 동일한 CLI를 통해 Galley를 구동합니다.
Rust Core가 단일 권한 주체(Single authority)입니다. 세션/프로젝트의 상태 머신, 예약된 작업, SQLite 쓰기, 그리고 모든 자식 프로세스는 한 곳에 모여 있습니다. 프런트엔드는 투영(projections)을 읽고 의도(intents)를 보내는 역할을 하며, 자체적으로 쓸 수 있는 상태(writable state)를 보유하지 않아 근본적인 다중 엔드 상태 표류(multi-end state drift) 문제를 제거합니다.
로컬 우선 보안 모델. 프로세스 간 트래픽은 Unix 소켓(0600) 또는 Windows 이름 있는 파이프를 통해 전송되며, 로컬호스트에서만 작동하고 토큰이나 TLS가 필요 없습니다. 이는 신뢰 경계(trust boundary)가 '동일한 기기의 동일 사용자'이기 때문입니다. 네트워크 스타일의 인증을 로컬 도구에 강제하지 않는 것은 의도적인 생략입니다.
Agent API는 버전이 지정된 공개 계약입니다. CLI 출력에는 schemaVersion이 포함됩니다. 특정 버전 내에서는 변경 사항이 추가적(additive)일 수만 있으며, 하위 호환성을 깨는(breaking change) 변경은 새로운 버전을 사용합니다. 현재 버전은 3이며, 변경되지 않은 모든 명령어는 여전히 1과 2를 반환합니다. 명령어 작성 시 누가, 그리고 왜 요청했는지(via / supervisor / reason) 기록됩니다. 슈퍼바이저는 이를 신뢰하며 프로그래밍할 수 있습니다.