OpenWorker README — 한국어 전문 번역

주의 원문은 커밋마다 변할 수 있다. 이 문서는 위 확보 일시 기준 스냅샷의 번역이다.

OpenWorker

openworker.com · 다운로드 · 이슈

베타 — OpenWorker는 오픈 베타 상태입니다. 완전히 사용 가능하고, 스스로 업데이트되며, 거친 부분들을 적극적으로 다듬는 중입니다. 이슈 제보를 환영합니다.

당신의 일상 업무를 끝내주는 AI. OpenWorker는 데스크톱에 상주하며 단순한 채팅이 아니라 완성된 결과물을 전달하는 오픈소스 AI 동료(coworker)입니다: 다듬어진 문서, 수치가 담긴 슬랙 답장, 갱신된 캘린더, 분류가 끝난 받은편지함.

당신의 기기에서 실행되며 어떤 모델에도 종속시키지 않습니다: OpenAI, Anthropic, Google 또는 오픈웨이트 제공자의 API 키를 직접 가져오거나, Ollama로 완전히 로컬에서 실행하세요. 당신의 데이터는 당신이 선택한 모델과 연동 서비스를 통해서만 기기를 떠납니다.

다운로드

⬇ macOS (Apple Silicon) — macOS 12+ · 서명 및 공증 완료 · 자동 업데이트

⬇ Windows 10/11 (x64) — 빌드는 아직 코드 서명이 되지 않아 SmartScreen이 경고를 표시합니다. 서명 작업이 진행 중입니다.

앱을 열고, 모델 키를 추가하거나 Ollama를 지정한 뒤, 실제 업무를 요청해 보세요.

작동 방식

1. OpenWorker에게 원하는 결과를 말합니다 — "고객 브리프를 준비해줘", "내 캘린더를 정리해줘", "보고서 초안을 작성해줘", "릴리스가 Jira와 GitHub에서 어디까지 왔는지 확인해줘".
2. 작업을 단계로 분해하고, 데스크톱·파일·연결된 앱들을 오가며 일합니다.
3. 중대한 일을 하기 전에는 — 메시지 전송, 캘린더 변경, 명령 실행 — 확인을 요청하며, 당신이 승인하거나 방향을 바꿉니다.
4. 할 일 목록이 아니라 완성된 결과물을 받습니다.

내부 구조:

┌────────────────────────────────────────────────┐
│              OpenWorker desktop app            │  native shell + GUI
├────────────────────────────────────────────────┤
│           local agent server (Python)          │  engine · tools · connectors - built on aisuite
├───────────────┬────────────────┬───────────────┤
│  your files   │   your tools   │  your model   │  everything runs with your keys,
│  & terminal   │ 25+ connectors │  any provider │  on your machine
└───────────────┴────────────────┴───────────────┘

[역주] 다이어그램 주석 번역: 데스크톱 앱 = 네이티브 셸 + GUI / 로컬 에이전트 서버(Python) = 엔진·도구·커넥터, aisuite 기반 / 하단 3열 = 당신의 파일과 터미널 · 당신의 도구(25개 이상 커넥터) · 당신의 모델(모든 제공자) — 모든 것이 당신의 키로, 당신의 기기에서 실행됨.

무엇을 할 수 있나

• 실제 결과물 생산 — 문서, 스프레드시트, 보고서, 웹 페이지가 열어보고 공유할 수 있는 파일로 만들어집니다.
• 슬랙에서 일 시키기 — 채널에서 @OpenWorker를 멘션하면 데스크톱에서 세션이 열리고, 당신의 도구로 작업이 수행되며, 답변이 스레드 답글로 돌아옵니다.
• 일상 도구 사용 — GitHub, Slack, Jira, Notion, Linear, HubSpot, Outlook, monday.com, Gmail, Google Calendar를 포함한 25개 이상의 연동, 그리고 터미널과 로컬 파일. MCP로 접근 가능한 어떤 도구든 도구별 제어와 함께 연결됩니다.
• 일정 기반 실행 — 반복 업무를 위한 자동화: 아침 브리핑, 주간 보고서, 채널 상시 모니터링. 실행 결과는 전체 기록(transcript)과 함께 앱에 저장됩니다.
• 행동 전에 묻기 — 쓰기, 전송, 셸 명령은 승인 게이트를 거칩니다. 무인 실행(unattended runs)은 스스로 행동하는 대신 요청을 받은편지함(inbox)에 대기시킵니다.

모델은 직접 가져오세요 (Bring your own model)

모델 접근 권한은 당신의 것입니다: 제공자를 고르고, 키를 붙여넣고, 언제든 바꾸세요. 기본 지원:

OpenAI · Anthropic · Google Gemini · Inkling (Thinking Machines) · GLM (Z.ai) · DeepSeek · Kimi (Moonshot) · Qwen · MiniMax · Mistral · Grok (xAI) — 그리고 Together와 Fireworks를 통한 오픈웨이트 모델, Ollama를 통한 완전 로컬 모델.

큐레이션된 모델 목록에는 도구 호출(tool-calling) 작업용으로 우리가 검증한 모델이 표시됩니다. 임의의 모델 문자열 추가도 동작하지만 책임은 사용자에게 있습니다.

프라이버시

OpenWorker는 로컬 우선(local-first)입니다. 모든 것이 당신의 기기에 있습니다: 에이전트 루프, 대화 내용, 커넥터 토큰, 모델 키 — 전부 앱의 로컬 시크릿 저장소에 보관됩니다. 유일한 클라우드 구성요소는 커넥터의 OAuth 핸드셰이크를 중개하는 작은 서비스뿐입니다. 로그인 없이도 앱을 사용할 수 있습니다 — 직접 생성한 자격증명/API 키로 커넥터를 이용하면 됩니다.

소스에서 실행하기

사전 요구사항: Python 3.10+, Node 20+, 그리고 (데스크톱 셸 구동에는) rustup을 통한 Rust 툴체인.

git clone https://github.com/andrewyng/openworker
cd openworker

# 1. One-time bootstrap - creates the Python venv at .venv
#    (on Windows, run from Git Bash or WSL)
bash packaging/setup_dev_env.sh

# 2. Start the local agent server
.venv/bin/openworker-server --cwd ~/some/project --port 8765
#    (Windows: .venv\Scripts\openworker-server.exe)

# 3. In a second terminal, start the UI
cd surfaces/gui
npm install
npm run dev        # browser UI on the Vite dev port

[역주] 코드 블록은 실행 가능성 보존을 위해 원문 그대로 둔다. 주석 번역: 1. 최초 1회 부트스트랩 — .venv에 파이썬 가상환경 생성(윈도우는 Git Bash 또는 WSL에서 실행) / 2. 로컬 에이전트 서버 시작(윈도우는 .venv\Scripts\openworker-server.exe) / 3. 두 번째 터미널에서 UI 시작 — Vite 개발 포트의 브라우저 UI.

브라우저 UI 대신 전체 데스크톱 앱을 실행하려면 3단계를 (surfaces/gui/에서) npm run tauri dev로 바꾸세요 — Tauri 셸이 창을 띄우고 서버를 직접 관리합니다.

테스트: .venv/bin/pytest (서버), surfaces/gui에서 npm test와 npm run e2e (GUI 단위 + 밀폐형(hermetic) 엔드투엔드). 데스크톱 번들은 packaging/build_dmg.sh / packaging/build_windows.ps1로 빌드합니다.

저장소 구조

aisuite 기반

OpenWorker의 엔진은 aisuite 위에 만들어졌습니다. aisuite는 여러 LLM 제공자를 아우르는 통합 채팅 컴플리션 API와, 도구·툴킷·MCP를 지원하는 에이전트 계층을 제공하는 경량 파이썬 라이브러리입니다. 우리 하네스를 쓰는 대신 자기만의 에이전트 하네스를 만들고 싶다면 거기서 시작하세요. 이 저장소는 aisuite가 무엇을 감당할 수 있는지 보여주는 동작하는 참조 구현입니다.

OpenWorker는 원래 aisuite 저장소 안에서 개발되다가 이곳으로 독립했습니다. 토대가 된 작업을 해준 aisuite 기여자들에게 감사합니다.

기여하기

기여와 버그 제보를 환영합니다 — 이슈나 풀 리퀘스트를 열어주세요. 앱이 스스로 업데이트되므로 수정 사항이 설치본에 빠르게 도달합니다.

모든 PR에는 무엇이 고장 났었고 어떻게 고쳐졌는지 스크린샷을 첨부해 주세요. 곧 여러분이 기여할 수 있는 기능들을 추가할 예정입니다.

우리는 내부 목록과 목표에 따라 활발히 개발 중이므로, 이미 개발 중이거나 우리 비전에서 벗어나는 기능을 추가하는 PR은 승인하지 않을 수 있다는 점을 양해해 주세요.

라이선스

MIT — LICENSE를 참조하세요.

---

부록 A — 라이선스 고지 (공개 시 필수)

이 문서는 MIT 라이선스로 배포되는 andrewyng/openworker 저장소의 README.md를 한국어로 번역한 것이다. 원저작권은 원저작자(Andrew Ng 및 openworker 기여자)에게 있으며, 원문 라이선스 전문은 저장소의 LICENSE 파일에서 확인할 수 있다. 번역 오류의 책임은 루프노트에 있으며, 원문과 번역이 다를 경우 원문이 우선한다.

부록 B — 용어집 (이 문서에서 확정된 번역어)

부록 C — 검증 메모

• 이 번역의 근거 원문은 2026-07-31 KST에 직접 수집한 README 스냅샷이다. 단 그 스냅샷 파일은 저장소에 남아 있지 않다(snapshots/ 에는 CANON-002 것만 있다) — 원문 대조를 재현하려면 v0.1.6 태그의 README 를 다시 받아야 한다.
• 원문 확보 시점의 저장소 표시값: 릴리스 3건(최신 v0.1.6, 2026-07-23), 언어 구성 Python 58.2% / TypeScript 32.9% / Rust 1.7% 외.
• README에 없는 것: 상호작용 12회 상한, 위험 4분류, 권한 5모드, FastAPI/Uvicorn — 이 스펙들의 정본화는 docs/ 및 코드 확인 후 별도 정본으로 진행한다(번호는 착수 시 부여).

개정 이력

원문이나 우리 판단이 바뀌면 여기에 추기한다. 기존 서술을 소리 없이 고치지 않는다.