모든 LLM(Large Language Model)에 자체 컴퓨터를 부여하는 MCP (Model Context Protocol) 서버 — 라이브 브라우저, 터미널, 코드 실행, 문서 작업 능력 및 자율적인 서브 에이전트(sub-agents)를 갖춘 관리형 Docker 워크스페이스를 제공합니다. 셀프 호스팅이 가능하며, 오픈 소스(open-source)이고, 어떤 모델에도 플러그인(pluggable) 방식으로 연결할 수 있습니다.

온라인 데모: chat.yambr.com — Computer Use가 이미 설정된 Open WebUI입니다. GitHub 또는 Google로 로그인하세요. (아래에서 더 많은 시도 방법을 확인하세요.)

실제 작동 모습 확인: docs.yambr.com의 데모 코스 — 위 채팅에서 캡처한 8가지 라이브 시나리오(피치 덱, Word 문서, Excel, PDF 인보이스, 데이터 차트, 실시간 렌더링 랜딩 페이지, 웹 스크래핑, 커스텀 스킬 구축)를 제공합니다. 실제 프롬프트, 실제 스크린샷, 복사하여 붙여넣기 가능한 형태입니다. 이 내용이 유용하다고 생각되신다면, 저장소(repo)에 ⭐를 눌러주시면 큰 도움이 됩니다 — 감사합니다!

모든 LLM에 격리된 Docker 컨테이너가 포함된 완벽하게 갖춰진 Ubuntu 샌드박스를 제공하는 MCP 서버입니다. 이것을 당신의 AI를 위한 컴퓨터라고 생각하세요 — 개발자가 할 수 있는 모든 것을 할 수 있습니다:

코드 실행 (Execute code) — 격리된 컨테이너 내에서 bash, Python, Node.js, Java 실행
문서 생성 (Create documents) — 스킬(skills)을 통해 전문적인 스타일링이 적용된 Word, Excel, PowerPoint, PDF 생성
웹 브라우징 (Browse the web) — Playwright + 라이브 CDP 브라우저 스트리밍 (AI가 보는 것을 실시간으로 확인 가능)
Claude Code 실행 — 대화형 터미널과 MCP 서버가 자동 구성된 자율적인 서브 에이전트(sub-agent)
13개 이상의 스킬 사용 (Use 13+ skills) — 문서 생성, 웹 테스트, 디자인 등을 위한 검증된 워크플로우(workflows)

프로덕션 환경의 멀티 유저 배포를 위해 구축되었습니다. 1,000명 이상의 MAU(Monthly Active Users)로 테스트되었습니다. 각 채팅 세션은 자체적인 격리된 Docker 컨테이너에서 실행되므로, AI가 패키지를 설치하고, 파일을 생성하고, 서버를 실행할 수 있지만 사용자 간에 데이터가 유출되지 않습니다. MCP 클라이언트 전반에서 원활하게 작동합니다: 오늘 Open WebUI로 시작하여, 내일 Claude Desktop이나 n8n으로 전환하더라도 동일한 백엔드를 사용하며 마이그레이션(migration)이 필요 없습니다.

모든 MCP 호환 클라이언트와 함께 작동합니다: Open WebUI, Claude Desktop, LiteLLM, n8n 또는 사용자의 자체 통합 환경. 대안들과의 상세한 비교는 docs/COMPARISON.md를 참조하세요.

복사하여 붙여넣을 수 있는 프롬프트가 포함된 8가지 라이브 시나리오는 **데모 코스 (Demo course)**를 확인하세요. 아키텍처에 대한 자세한 내용은 docs/FEATURES.md를, 모든 스크린샷은 docs/SCREENSHOTS.md를 참조하세요.

전문가 팁: 터미널에서 Claude Code로 스킬을 생성한 다음, 채팅에서 어떤 모델과도 해당 스킬을 사용할 수 있습니다. 스킬은 모델에 구애받지 않습니다(model-agnostic). 한 번 작성하면 어디서든 사용할 수 있습니다.

멀티 CLI 서브 에이전트 런타임 (Multi-CLI sub-agent runtime, v0.9.2.1+): 서브 에이전트 디스패치(dispatch)는 Claude Code (기본값), OpenAI Codex, 그리고 OpenCode (OpenRouter / qwen / DeepSeek / 75개 이상의 제공업체 포함)를 지원합니다. .env 파일에서 SUBAGENT_CLI=claude|codex|opencode를 전환하세요.

— OpenCode + qwen3-coder + OpenRouter 조합의 작동 레시피는 docs/multi-cli.md를 참조하세요.

향후 계획: 객체 스토리지(object-storage) 기반의 사용자 데이터와 squashfs로 패키징된 스킬을 갖춘 Kubernetes 친화적 아키텍처가 docs/future-architecture/에서 설계되고 있습니다. 현재는 Docker Compose가 주요 지원 경로로 유지됩니다.

OAuth 전용 — 이메일/비밀번호 없음, SMS 없음. chat.yambr.com에서 제공.

모델은 편의를 위해 무료로 번들링되어 제공되며, 호스팅된 API는 도구(tools)만 제공합니다. 공식 클라우드 문서: docs.yambr.com. 리포지토리 측 가이드: docs/CLOUD.md.

git clone https://github.com/Wide-Moat/open-computer-use.git
cd open-computer-use
cp .env.example .env
...

http://localhost:3000을 엽니다 — Computer Use 기능이 준비된 Open WebUI가 실행됩니다.

참고: 두 개의 별도 docker-compose 파일이 있습니다: docker-compose.yml (Computer Use 서버) 및 docker-compose.webui.yml (Open WebUI). 이들은 localhost:8081을 통해 통신합니다. 이는 서버와 UI가 서로 다른 호스트에서 실행되는 실제 배포 환경을 반영합니다.

Open WebUI에서 모델을 추가한 후, Model Settings로 이동하여 다음과 같이 설정하십시오:

Function Calling: Native 설정이 없으면, 모델이 Computer Use 도구를 호출하지 못합니다.

13개의 내장 공개 스킬 + 14개 예시:

14개 예시 스킬: web-artifacts-builder, copy-editing, social-content, canvas-design, algorithmic-art, theme-factory, mcp-builder 등.

자세한 내용은 docs/SKILLS.md를 참조하세요.

서버는 Streamable HTTP를 통해 표준 MCP(Messaging Communication Protocol)로 통신합니다. 호스팅되거나 자체 호스팅된 모든 MCP 클라이언트를 이 서버에 연결할 수 있습니다.

호스팅됨: https://api.yambr.com/mcp/computer_use

Authorization: Bearer <app.yambr.com의 키>

클라이언트 설정 및 전체 참조는 docs.yambr.com에서 확인하세요.자체 호스팅: http://localhost:8081/mcp

. 빠른 무결성 검사 (Quick sanity check): 전체 자체 호스팅 통합 가이드 (LiteLLM, Claude Desktop, 커스텀 클라이언트): docs/MCP.md. 채팅당 시스템 프롬프트 (system prompt)는 다음의 6가지 중복되는 MCP 네이티브 채널(도구 설명 (tool descriptions), 샌드박스 내 /home/assistant/README.md, InitializeResult.instructions, 업로드된 파일을 위한 resources/list, 그리고 레거시 통합을 위한 HTTP /system-prompt 엔드포인트)을 통해 전달됩니다 — 전체 지도는 docs/system-prompt.md에서 확인하세요.

curl -X POST http://localhost:8081/mcp \ -H "Content-Type: application/json" \ -H "X-Chat-Id: test" \ -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

모든 설정은 .env를 통해 이루어집니다:

Open WebUI에 임베딩할 때 필요 — Open WebUI 임베딩 시 필수 설정(Required setup when embedding Open WebUI) 참조 |
open-webui 컨테이너 |
POSTGRES_PASSWORD |
openwebui |
PostgreSQL 비밀번호 |
VISION_API_KEY |
— | Vision API 키 (이미지 설명용) |
ANTHROPIC_AUTH_TOKEN |
— | Anthropic 키 (Claude Code 서브 에이전트용) |
MCP_TOKENS_URL |
— | Settings Wrapper URL (선택 사항, 아래 참조) |
MCP_TOKENS_API_KEY |
— | Settings Wrapper 인증 키 |

기본적으로 13개의 내장 스킬(built-in skills)은 모두에게 제공됩니다. 사용자별 스킬 접근 권한 및 커스텀 스킬을 사용하려면 Settings Wrapper를 배포하세요 — settings-wrapper/README.md를 참조하십시오.

개인 액세스 토큰 (PATs): Settings Wrapper는 외부 서비스(GitLab, Confluence, Jira 등)를 위한 암호화된 사용자별 PAT를 저장할 수도 있습니다. 서버는 사용자 이메일을 통해 토큰을 가져와 샌드박스(sandbox)에 주입합니다. 따라서 각 사용자의 AI는 자격 증명을 공유하지 않고도 자신의 저장소(repos)나 문서(docs)에 접근할 수 있습니다. 토큰 주입을 위한 서버 측 코드는 구현되어 있으나 (docker_manager.py), Open WebUI 도구가 아직 필요한 헤더(headers)를 전달하지 않습니다. 이는 로드맵(roadmap)에 포함되어 있습니다 — PAT 관리가 필요한 경우 이슈(issue)를 생성해 주세요.

Computer Use Server는 표준 **Streamable HTTP 기반 MCP (MCP over Streamable HTTP)**를 사용하므로, MCP 호환 클라이언트라면 무엇이든 연결할 수 있습니다. Open WebUI가 주요 테스트된 프론트엔드이지만, 유일한 옵션은 아닙니다.

Open WebUI는 확장 가능한 셀프 호스팅 AI 인터페이스입니다. 우리는 도구 호출 (tool calling), 함수 필터 (function filters), 그리고 아티팩트 (artifacts)를 지원하기 때문에 이를 주요 프론트엔드로 사용합니다. 이 기능들은 Computer Use에 필요한 모든 요소입니다.

호환성 (Compatibility): 이 빌드는 엄격하게 Open WebUI 0.9.2 버전을 기준으로 빌드 및 검증되었습니다. 우리 빌드 버전의 처음 3개 세그먼트(v0.9.2.X)는 대상이 되는 Open WebUI의 베이스 버전과 항상 일치합니다. 만약 다른 버전의 Open WebUI를 실행 중이라면, 처음 3개 버전 세그먼트가 사용 중인 버전과 일치하는 Open Computer Use 빌드를 선택하십시오. 예를 들어, Open WebUI 0.8.12를 사용하는 경우 v0.8.12.Y 빌드를 사용하십시오.

왜 포크(fork)를 하지 않았나요? 우리는 의도적으로 Open WebUI를 포크하지 않았습니다. 대신, 모든 기능은 공식 플러그인 API (도구 + 함수)와 누락된 기능을 위한 빌드 타임 패치 (build-time patches)를 통해 결합되었습니다. 이는 여러분이 순정(stock) Open WebUI 0.9.2(우리 빌드 버전 v0.9.2.X의 처음 3개 세그먼트와 일치하는 버전)를 그대로 사용하면서 도구와 필터만 설치하면 된다는 것을 의미합니다. 패치는 Docker 빌드 시점에 적용됩니다. 이는 강력히 권장됩니다. 패치 중 4개는 사용자에게 보이는 UX(아티팩트 패널, 미리보기 iframe, 에러 배너, 대용량 도구 결과 처리)에 영향을 미칩니다. ghcr.io/open-webui/open-webui를 풀링(Pulling)...

이들을 모두 직접 건너뜁니다 — Open WebUI를 임베딩할 때의 필수 설정(Required setup)을 참조하여 전체 체크리스트를 확인하세요.

기업용 게이트웨이(LiteLLM, Azure, Bedrock)를 통해 Claude Code를 실행하시나요? 세 가지 경로의 운영 레시피는 docs/claude-code-gateway.md를 참조하세요.

openwebui/ 디렉토리는 다음을 포함합니다: