개인 AI 에이전트를 구축하기 위한 경량 셀프 호스팅 Python 프레임워크입니다.
한국어는 runchr 제공 번역입니다. 원문 README는 English tool page.
holaOS
앱과 에이전트가 나란히 배치되는 오픈소스 Electron 워크스페이스. 100개 이상의 통합, MCP, 채팅 도구, 로컬 파일을 공유 메모리와 연결합니다. 실행
- Kind
- desktop workspace
- Platform
- macOS, Windows, Linux (Electron)
- Models
- Any model, Claude Code, Codex, BYOK
프로젝트 README (번역)
GitHub ↗Written by the project's own authors, not by runchr. Snapshot taken 2026-10-30.
앱과 에이전트가 나란히 자리하는 에이전틱 워크스페이스
모든 회사는 다르게 일합니다. HolaOS는 당신의 업무 방식에 맞게 조형하는 워크스페이스입니다 — 이미 쓰고 있는 시스템과 채팅 도구를 연결하고, 팀에 필요한 스킬과 앱을 추가하고, 어떤 모델이나 에이전트든 실행하세요. 몇 달이 아니라 클릭 몇 번으로 설정합니다. 로컬 우선이므로 그 무엇도 당신의 머신 밖으로 나가지 않습니다.
웹사이트 ·
문서 ·
로그인 ·
빠른 시작
⭐ holaOS가 유용하다면, 스타 하나가 더 많은 빌더들이 찾도록 도와줍니다.
✨ HolaOS가 다른 이유
대부분의 에이전트 제품은 완성된 제품을 건네고 그것이 당신의 업무에 맞기를 바랍니다. HolaOS는 부품을 건넵니다. 앱, 채팅 도구, 스킬, 통합, 모델, 에이전트, 메모리 — 당신의 업무가 실제로 돌아가는 방식에 맞춰 워크스페이스를 조립하고, 업무가 바뀔 때마다 바꾸세요. 모든 것이 로컬에서 실행되므로, 커스터마이징한다고 해서 당신의 업무를 남의 클라우드에 넘기는 일은 결코 없습니다.
🪟 HolaApps — 앱과 에이전트, 나란히
워크스페이스 내 마켓플레이스에서 앱을 설치하면 에이전트 바로 옆에 실제 상호작용 가능한 화면으로 열립니다. 에이전트가 앱 안에서 작업하는 것을 지켜보고, 원할 때 언제든 개입하세요. 결과는 채팅 텍스트의 벽이 아니라, 에이전트가 구동하는 실제 앱이 에이전트 옆에 제자리에 놓입니다.
채팅이 아닌 실제 화면 — 모든 앱은 대화 기록이 아니라 살아 있는 UI(Notion, 브라우저, 당신의 앱)입니다.
설계부터 나란히 — 앱과 에이전트가 화면을 공유하므로 무슨 일이 일어나는지 항상 보이고 직접 넘겨받을 수 있습니다.
클릭 한 번으로 설치 — 워크스페이스 내 마켓플레이스를 둘러보고 어떤 앱이든 즉시 여세요.
직접 가져오기 — HolaApp을 어떤 URL과 MCP 서버에도 연결하세요. 당신의 머신에 살고, 열고 구동하는 것은 당신 몫입니다.
컨텍스트는 양방향으로 동기화 — 앱을 직접 조작해도 에이전트가 따라옵니다. UI에서 클릭하거나 입력하거나 연 모든 것이 에이전트가 이미 가진 컨텍스트가 되므로, 방금 한 일을 다시 설명하느라 멈출 필요가 없습니다.
💬 IM — 팀이 이미 쓰는 채팅 도구를 연결하세요
대부분의 업무 컨텍스트는 문서에 담기지 않습니다. Slack 스레드, Feishu 그룹, DingTalk 메시지에 있습니다. 팀이 이미 쓰는 채팅 도구를 연결하면 에이전트가 당신의 요약이 아니라 실제 대화에서 작업합니다.
컨텍스트가 실제로 있는 곳 — 결정, 요구사항, 변경 사항은 채팅에서 이루어지고 그곳에 남습니다. 에이전트가 이를 직접 읽으므로 이미 나눈 말을 다시 설명하지 않아도 됩니다.
팀이 이미 있는 도구 — Slack, Feishu, DingTalk, WeChat. 쓰는 것은 연결하고, 안 쓰는 것은 건너뛰세요.
무엇을 볼지 당신이 결정 — 접근 권한은 도구별, 범위별로 부여되며, 당신이 승인하기 전까지 에이전트는 아무것도 읽지 않습니다.
🧩 스킬, 통합, MCP — 만들지 않고도 어떤 역량이든 추가
통합 — Gmail, Notion, Slack, GitHub, Linear 등 50개 이상을 원클릭 OAuth로 연결하세요. 에이전트가 글루 코드 없이 당신의 도구 전반에서 읽고 행동하며, 모든 에이전트가 같은 연결을 상속합니다.
MCP — 어떤 Model Context Protocol 서버든 연결해 에이전트에 새 도구를 부여하세요. 직접 가져오거나, 커뮤니티 MCP 서버를 클릭 한 번으로 설치하세요.
스킬 — 워크플로를 한 번 패키징하면 어떤 에이전트든 필요할 때 실행합니다.
콤보 — 스킬과 통합을 하나의 원클릭 설치로 묶으세요.
💸 모델은 당신 방식대로 — 작업별로 알맞은 것을 고르거나 직접 가져오세요
하나의 계정, 모든 모델 — 키도, 설정도, 제공자 전환도 없습니다. 최신 프런티어 모델이 내장되어 있습니다 : 일상적인 물량에는 비용 효율적인 Kimi K3와 GLM 5.2, 어려운 문제에는 최상위 GPT 5.6 , Claude Opus 5 , Fable 5. 직접 쓰는 제공자를 선호하시나요? OpenAI, Anthropic 또는 OpenAI·Anthropic 호환 엔드포인트용 키를 직접 가져오세요 — 이는 holaOS 요금제가 아니라 당신의 계정으로 실행됩니다.
설정 없는 기본값 — 하나의 계정, 모든 SOTA 모델, 관리할 API 키 없음.
원할 때 BYOK — 당신의 키, 당신의 제공자, 당신의 요율.
작업별 알맞은 모델 — 작업별, 에이전트별로 선택.
🔀 에이전트 — 우리가 고른 것이 아니라 당신이 선호하는 에이전트를 실행
Claude Code, Codex, 내장 holaOS 에이전트 — 전환 없이 나란히. 무엇을 실행하든 같은 메모리, 도구, 스킬, 앱을 공유합니다. 매번 설정을 다시 만들지 않고 작업에 가장 좋은 에이전트를 사용하세요.
락인 없음 — Claude Code, Codex 또는 holaOS 자체 에이전트를 같은 워크스페이스에서, 같은 도구·파일·메모리 위에서 실행하세요.
모든 것을 공유 — 하나의 컨텍스트, 하나의 도구 세트, 하나의 워크스페이스.
일관된 결과 — 무엇이 구동하든 같은 스킬과 통합.
🧠 하나의 메모리, 모든 에이전트
컨텍스트, 선호도, 프로젝트 이력이 하나의 공유 메모리에 저장됩니다 — 로컬에, 읽고 편집할 수 있는 평범한 파일로. 에이전트를 바꾸고, 앱을 닫고, 다음 주에 돌아오세요: 어디서 멈췄는지 이미 알고 있습니다.
결코 제로에서 시작하지 않음 — 세션과 에이전트를 넘나드는 지속적인 메모리.
로컬 우선 & 당신의 것 — 당신의 머신에, 보이고 편집 가능하며, 남의 클라우드에 갇히지 않습니다.
실제로 회상 가능 — 구조화되고 임베딩되어, 필요할 때 알맞은 컨텍스트가 돌아옵니다.
🛠️ 당신의 워크스테이션 전체를, 에이전트가 조작 가능하게
🌐 에이전트가 구동하는 실제 브라우저 — 에이전트가 탐색하고 클릭하고 추출하도록 구동하는, 로그인된 브라우저 — 당신의 통제 아래.
🎨 프런티어 생성 기능 내장 — 모든 에이전트 안에 최신 이미지, 비디오, 오디오 모델. 비디오 스토리보드, 포스터 디자인, 스크립트 보이스오버 — 프롬프트 하나로.
📄 실제 결과물 — 보고서, 스프레드시트, 슬라이드가 보내고 공유할 수 있는 실제 .xlsx , .pptx , .docx 파일로 저장됩니다. 채팅에 갇힌 텍스트가 아닙니다.
⏰ 자동화 — 일정이나 트리거로 실행. 다이제스트, 모니터, 보고서가 스스로 완료되고 정리됩니다.
🔒 당신의 업무는 당신 편에 머뭅니다
당신의 도구, 채팅, 머신 전체에 접근할 수 있는 에이전트는 당신이 통제권을 유지할 때만 의미가 있습니다. 그 통제는 설정으로 덧붙인 것이 아니라 HolaOS가 작동하는 방식에 내장되어 있습니다.
로컬 우선, 클라우드 우선 아님 — 워크스페이스 파일, 메모리, 임베딩, 세션 이력이 모두 당신의 디스크에 있습니다. 우리 서버에 당신의 업무 사본은 없습니다.
우리는 당신의 데이터를 볼 수 없습니다 — 파일도, 메모리도, 대화도 아닙니다. 그것은 우리가 약속하는 정책이 아니라, 당신의 데이터가 결코 가는 곳이 아닙니다.
모든 행동은 당신이 승인 — 도구 연결, 스레드 읽기, 파일 편집. 에이전트가 먼저 묻고, 무엇에 접근할 수 있고 무엇이 금지되는지 당신이 결정합니다.
보이고 되돌릴 수 있음 — 에이전트가 기억하는 것을 열고, 편집하고, 삭제하세요. 메모리는 블랙박스가 아니라 읽을 수 있는 폴더입니다.
당신의 키, 당신의 계약 — 정책상 필요하다면 추론을 당신의 모델 제공자를 통해 라우팅하세요.
🌐 HolaHub — HolaOS 안의, 에이전트를 위한 레시피 플랫폼
워크스페이스를 설정하는 가장 빠른 방법은 다른 사람의 작동하는 설정에서 시작하는 것입니다. HolaHub에서 크리에이터는 이미 작동하는 에이전트 레시피 — 모델, 프롬프트, 스킬, MCP, 통합 — 를 게시하고, 누구든 클릭 한 번으로 설치해 같은 결과를 얻습니다. 만든 것을 공유하고, 다른 사람이 만든 것을 실행하세요.
공유는 클릭 한 번 — HolaOS의 어떤 실행이든 패키징해 프로세스와 결과를 함께 Hub에 게시하세요. 내보내기도, 다시 쓰기도, 두 번째 계정도 없습니다.
재현은 클릭 한 번 — Hub의 모든 스킬, MCP, 이미지, 비디오가 당신의 워크스페이스에서 즉시 실행됩니다. 발견과 설치가 같은 동작입니다.
결과물이 아닌 레시피 — 각 게시물은 어떻게 만들어졌는지로 펼쳐집니다: 스킬 뒤의 세션, 이미지나 비디오 뒤의 프롬프트. 결과만이 아니라 결과의 재료를 봅니다.
🚀 당신 방식대로 실행하세요
🖥️ 데스크톱 앱
다운로드하고 바로 시작. 설정할 것 없음 — 프런티어 모델 내장, 무료로 시작.
🔓 오픈 소스
셀프 호스팅. 수정된 Apache 2.0, 키 직접 가져오기, 전적으로 당신의 머신에서 실행.
🏢 엔터프라이즈
모든 에이전트, 스킬, 앱에 대한 역할별 권한이 있는 SSO. 내부 시스템을 노출하지 않고 연결. 모든 행동에 감사 로그. 온프레미스 또는 당신의 클라우드.
목차
빠른 시작
수동 설치
OSS 릴리스 노트
빠른 시작
원라인 설치
macOS, Linux, WSL에서 새 머신 부트스트랩에는 저장소 설치 프로그램을 사용하세요:
curl -fsSL https://raw.githubusercontent.com/holaboss-ai/holaOS/refs/heads/main/scripts/install.sh | bash -s -- --launch
각 설정 단계를 제어하고 싶다면 수동 경로를 따를 수도 있습니다.
저장소에 스타 주기
holaOS가 유용하거나 흥미롭다면 GitHub Star를 주시면 큰 힘이 됩니다.
수동 설치
원라인 설치가 같은 설정을 실행하므로 이 섹션은 대개 필요하지 않습니다. 각 단계를 검토하거나 제어하고 싶을 때 수동 설치를 사용하세요. 수동 경로를 사용한다면 먼저 일반적인 사전 요구사항을 확인하세요:
git --version
node --version
npm --version
저장소는 루트 .nvmrc 에 Node 버전을 고정합니다. 이미 nvm 을 사용한다면 저장소 루트에서 nvm use 를 실행하면 자동으로 선택됩니다 — nvm 은 선택 사항이며 holaOS 설정에 필수는 아닙니다.
원라인 에이전트 설정
Codex, Claude Code, Cursor, Windsurf 또는 다른 코딩 에이전트를 사용한다면 설정 지침을 한 문장으로 넘길 수 있습니다:
https://raw.githubusercontent.com/holaboss-ai/holaOS/refs/heads/main/scripts/install.sh 에서 holaOS 설치 스크립트를 실행하세요. git과 Node.js 24.14.1/npm이 없으면 설치하고, 내가 다른 --dir을 지정하지 않는 한 저장소를 ~/holaboss-ai에 클론하거나 업데이트하고, desktop:install을 실행하고, 필요하면 apps/desktop/.env.example에서 apps/desktop/.env를 생성하고, desktop:prepare-runtime:local과 desktop:typecheck를 실행하며, 내가 --launch를 요청한 경우에만 desktop:dev를 실행하세요. Electron이 열리지 않으면 검증 후 중단하고 다음 수동 단계를 알려주세요.
이 핸드오프는 상세한 부트스트랩 단계를 저장소 내 INSTALL.md 런북에 두면서 설치 흐름을 자체 완결적으로 유지합니다.
이것이 로컬 데스크톱 개발을 위한 기본 설치 흐름입니다.
저장소 루트에서 데스크톱 의존성을 설치하세요:
npm run desktop:install
로컬 환경 파일을 생성하세요:
cp apps/desktop/.env.example apps/desktop/.env
저장소를 그대로 따르는 경우 파일을 템플릿에 가깝게 유지하고 제공자나 머신에 필요한 값만 변경하세요.
표준 경로는 apps/desktop/.env 입니다. 기존 레거시 desktop/.env 파일도 당분간 허용되지만, 새 설정은 apps/desktop/.env 를 사용해야 합니다.
로컬 런타임 번들을 준비하세요:
npm run desktop:prepare-runtime:local
Electron 실행 전에 빠른 검증을 원한다면 다음을 실행하세요:
npm run desktop:typecheck
개발 모드에서 데스크톱 앱을 시작하세요:
npm run desktop:dev
predev 훅이 환경을 검증하고, 네이티브 모듈을 재빌드하며, 스테이징된 런타임 번들이 존재하는지 확인합니다.
데스크톱 앱을 열기 전에 런타임을 스테이징하려면 두 가지 일반적인 경로가 있습니다:
로컬 런타임에서 빌드:
npm run desktop:prepare-runtime:local
최신 게시된 런타임 가져오기:
npm run desktop:prepare-runtime
런타임 코드를 적극적으로 변경 중일 때는 로컬 경로를 사용하세요. 알려진 릴리스 아티팩트에 대해 데스크톱을 검증하고 싶을 때는 게시된 번들을 사용하세요.
작동하는 로컬 데스크톱 환경으로 가는 가장 빠른 경로를 원할 때는 원라인 설치를 사용하세요. 각 설정 단계를 직접 검토하거나 제어해야 할 때는 수동 설치를 사용하세요.
OSS 릴리스 노트
라이선스: 추가 상업적 배포 및 브랜딩 조건이 있는 수정된 Apache 2.0. LICENSE 참조.
보안 이슈: [email protected] 로 비공개로 보고하세요. SECURITY.md 참조.
Star History
No comments yet.
to comment.