English · 한국어

Open Agent OS

내 에이전트, 내 머신, 내 규칙.

URL 하나로 시작해 1인 미니PC에서 50인 기업까지 함께 성장하는 셀프 호스팅 에이전트 OS. Hermes Agent 기반 · Personal·Project는 오픈소스(Apache 2.0), Company는 소스 공개(BSL 1.1).

URL 하나로 시작 — Hermes Agent를 설치하고 이 저장소를 건네주세요
또는 GitHub에서 소스와 부트스트랩 스킬을 확인하세요

셀프 호스팅 · 사용자당 과금 없음 · Telegram, Mattermost, Slack, Outline, Notion, Google Workspace, Microsoft 365는 연결 — 대체가 아닙니다.

왜 OPEN AGENT OS인가요?

내 것, 빌린 것이 아닙니다.

에이전트가 내 하드웨어(집의 미니PC, 팀의 VPS, 회사 서버)에서 삽니다. 대화·파일·지식이 그 안에 남습니다. 사용자당 클라우드 요금도, 데이터의 외부 유출도, 떠날 수 없는 서비스도 없습니다.

설치는 URL 하나로 끝납니다.

부트스트랩이 대화입니다. 에이전트가 저장소를 읽고, 선택지를 설명하고, 설치를 실행하고, 실제 검증으로 단계마다 확인한 뒤, 동작하는 시스템을 건네줍니다. 이해하지 못하는 명령을 붙여넣을 일이 없습니다.

인디 비용, 엔터프라이즈 역량.

Personal 에디션은 N100급 미니PC와 저가 정액 LLM 플랜(월 약 $10)으로 돌아갑니다. 이미 쓰는 도구(Telegram·Mattermost·Outline·Slack·Notion·Google Workspace·Microsoft 365)는 연결될 뿐 대체되지 않습니다. 새로 추가되는 구독은 없습니다.

쌓이는 세컨드 브레인.

대화·문서·결정이 내 위키에 기록되고, 에이전트가 상호참조와 일관성을 관리합니다. 상태를 기억하지 못하는 챗봇과 달리, 내 맥락이 자산으로 쌓입니다 — 그리고 그 자산은 내 것으로 남습니다.

작게 시작하고, 다시 만들 필요 없습니다.

Personal → Project → Company가 하나의 코어 위에 있습니다. 혼자 시작해서, 준비되면 팀원·공유 지식·거버넌스를 더하면 됩니다. 같은 스킬, 같은 파일, 같은 에이전트 — 규모만 커집니다.

안전은 기본값, 규모에서도 통제.

파괴적 작업은 승인 후에만 실행됩니다. 시크릿은 한 곳에만 보관되고 채팅·로그에 재출력되지 않습니다. 기업 규모에서는 정책·감사·관리 콘솔이 더해집니다 — 이미 상용 운영 중인 플랫폼에서 이어받은 기능입니다.

URL 하나의 경험

에이전트에게 URL 하나를 건네고, 원터치 게이트 몇 개만 통과하면 끝입니다. 그게 설치의 전부입니다.


나      github.com/openit-ai/open-agent-os 설치해줘

에이전트  에디션이 3개입니다: Personal(1인), Project(소규모 팀),
         Company(5~50인). 이 머신에는 Personal이 맞습니다. 진행할까요?

나      응

에이전트  설치 중… ✓ Hermes  ✓ 게이트웨이  ✓ Telegram 연결
         게이트 2개만 부탁드릴게요: 봇 토큰 붙여넣기, 사용자 ID 붙여넣기.
         ✓ LLM 플랜 연결  ✓ 위키 시딩  ✓ 예약 작업 등록
         ✓ 재부팅 생존은 Ubuntu에서 검증

에이전트  완료 — 전 과정 검증됐습니다. 이걸 시도해보세요:
         "매일 아침 8시에 브리핑해줘". 전체 레시피: docs/cookbook.md

설치는 매뉴얼이 아니라 대화입니다.

에디션

세 가지 에디션, 하나의 코어

Personal — 1인용

미니PC(N100급·16GB), Telegram 대화, 그리고 내가 소유한 세컨드 브레인. 월 약 $10 LLM 플랜. 서버 불필요.

Project — 소규모 팀(2~6인)용

VPS 1대(4 vCPU·16GB·200GB), Mattermost 속 팀 어시스턴트, Outline 지식베이스, 봇 전용 메일함. Personal → Project 이전 스크립트 포함.

Company — 기업(5~50인)용

Project의 전부에 거버넌스 레이어를 더합니다: 정책, JIT 승인, 감사 원장, Secret Vault, 관리 콘솔, 선택적 Slack / Notion / Workspace / 365 연동, 멀티 LLM 라우팅.

	Personal	Project	Company
대상	1인	소규모 팀(2~6인)	중소기업(5~50인)
구동	미니PC(N100급·16GB)	VPS 1대(4 vCPU·16GB·200GB)	Project + 거버넌스 레이어
설치	Linux / macOS / Windows 11(Git Bash)	서명된 apt 패키지 + 고정 Outline(systemd)	Project 호스트 서비스 승계
대화 창구	Telegram	Mattermost + Telegram	+ Slack (옵션)
지식	git 위키 + Obsidian	Outline + git 위키	+ Notion (옵션), 권한 인식 인덱스
메일	개인	봇 전용 메일	기존 스위트 연동
모델	저가 정액 1종	저가 정액 중심	멀티 LLM 라우팅(프리미엄 선택)
거버넌스	최소	팀 계정	정책·승인·감사·Vault·관리 콘솔
신규 비용	월 약 $10(LLM 정액)	+ 서버	+ 거버넌스 인프라

Google Workspace·Microsoft 365·Slack·Notion은 기업이 이미 사용하며 지출 중인 서비스입니다. OAOS는 이들에 연결할 뿐이며, 본 솔루션의 추가 비용이 아닙니다. 새로 드는 비용은 솔루션 자체(서버·LLM 정액)뿐입니다.

이걸로 무엇을 하나요?

Personal — 아침 브리핑, 메일 분류, 위키에 지식 기록, 예약 알림, 리서치 요약. 전부 폰의 Telegram에서.

Project — Mattermost 속 팀 어시스턴트, 회의록이 위키 문서로, 주간 리포트, 공유 문서 검색, 봇 전용 메일함.

Company — 구성원마다 거버넌스가 적용된 개인 에이전트, 권한을 지키는 사내 지식 검색, 전사 정책·감사, 선택적 Slack·Notion·Workspace·365 연동.

컴퓨터 사용

컴퓨터 사용 — 에이전트의 손

에이전트는 답만 하지 않고, 자신이 돌아가는 머신의 브라우저와 프로그램을 직접 다룹니다.

한글 문서 작성 — 양식 기반 HWPX 문서(정부과제·제안서·입찰·공문서) 초안을 만들어 줍니다. 최종 다듬기는 한컴독스(웹)나 보유한 한컴오피스에서 하면 됩니다.
업무 사이트 입력·제어 — 회계·세무·ERP 사이트의 로그인과 반복 입력을 자동화합니다. 공동인증서는 로컬 볼트에 보관하고, 서명·제출은 승인 후에만 실행합니다.
정부 사이트 서류 발급 — 신청 → 결제 → 발급 → 저장 → 위키 기록까지. 결제 단계에서는 멈추고 승인을 요청합니다.

결제·발송·삭제처럼 위험한 동작은 항상 승인을 거칩니다. 자격증명 직접 입력은 기본 금지(볼트 전용)입니다.

빠른 시작

빠른 시작 — "URL 하나로"

Hermes Agent 설치 — 공식 설치기 안내.
이 저장소 URL 전달 — 예: "openit-ai/open-agent-os 설치해줘".
에이전트 안내 따라가기 — README → START-HERE → oaos-bootstrap 스킬 설치.
에디션 선택 — Personal / Project / Company.
게이트 통과(3~6개) — 링크 클릭·선택·키/토큰 붙여넣기. 즉시 검증됩니다.
최종 테스트·보고 — 서비스·응답·파일·위키·예약 작업까지 확인.

읽기·파일 편집·명령은 에이전트가 합니다. 사용자는 게이트만 처리합니다.

스킬

스킬 — 성장하는 방식

코어 스킬이 OAOS와 함께 SKILL.md 패키지로 배포됩니다. Hermes로 설치할 수 있습니다. MCP 서버와 스킬을 추가하면 코어 변경 없이 에이전트의 능력이 늘어납니다.

oaos-bootstrap — 부트스트랩 오케스트레이터: 환경 점검 → 에디션 선택 → 구축 → 게이트 → 검증 → 보고.
oaos-ops — 운영(day-2): 상태 점검, 백업, 업데이트, 복구, 로그 확인.

확장 스킬 (옵션 — 자체 API 키 필요):

promo-video-generation — 장소 하나로 20초 실사 홍보영상: 문답 → 실사 이미지 → 컷 문안 → 생성. 생성 전 견적·승인 절차 내장.
higgsfield-media-generation — 이미지·영상 생성 헬퍼. 비용 사전 견적 내장.
figma-design-generation — 채팅으로 Figma 디자인 제작: 화면·컴포넌트·다이어그램·디자인→코드 핸드오프.
naver-cafe-manager — 키워드 신규글 감시·알림, 초안 우선 글 작성, 댓글 확인·응답.
naver-blog-manager — 신규 글 감시, 초안 우선 작성, 본문 md + 원본 화질 이미지 수집 파이프라인.
sketchup-design-generation — 채팅으로 정확 치수 3D 모델 제작, SKP / PNG / STL 내보내기.
vps-youtube-content — VPS에서 YouTube 자막 차단 시 최저비용 순 복구 사다리.

하네스 & 설정

에이전트의 정체성은 평범한 markdown입니다

에이전트의 정체성과 기억은 내 머신 위의 markdown 파일들입니다 — 읽고, 고치고, 버전 관리할 수 있습니다.

SOUL.md — 사용자가 정의하는 페르소나와 일하는 원칙.
USER.md — 사용자 프로필. 에이전트가 대화에서 자동으로 관리합니다.
MEMORY.md — 에이전트의 메모. 에이전트가 작성하고, 사용자가 교정합니다.
AGENTS.md — 팀·기업 워크스페이스용 프로젝트별 지침.

설정·시크릿·스킬·예약 작업까지가 같은 표면입니다 — 템플릿과 시딩 가이드가 있어 빈 하네스가 아니라 제대로 갖춘 개인 하네스로 시작합니다.

아키텍처

아키텍처 한눈에


Company   5~50인 / 멀티 LLM, 거버넌스, 선택 연동
   ↑
Project   소규모 팀 / Mattermost, Outline, 봇 메일
   ↑
Personal  1인 / Telegram, 세컨드 브레인
   ↑
공통 코어   스킬, 지식, 정책 개념, 시크릿 규칙
   ↑
런타임 계층  Hermes Agent + 표면별 어댑터

Personal로 시작해 Project로 성장하고, Company 규모에서 통제합니다. 하나의 코어, 재구축 없음.

로드맵 & 라이선스

로드맵

P0 — 부트스트랩 MVP (Personal) — README / START-HERE, oaos-bootstrap 스킬, Personal 설치, verify.
P1 — Project — Project 설치·검증과 Personal → Project 이전 스크립트.
P2 — Company — 기존 엔터프라이즈 플랫폼 흡수, 선택 연동, 멀티 LLM 라우팅, 거버넌스.

라이선스

Personal·Project — Apache License 2.0. 오픈소스: 자유롭게 사용·수정·배포할 수 있습니다(상업적 사용 포함).
Company — Business Source License 1.1. 소스 공개: 평가·개발·테스트 허용, 프로덕션·상업적 사용은 별도 상업 라이선스가 필요합니다. Change Date(2030-08-27) 이후 Apache License 2.0으로 전환됩니다.

FOOTER CTA

URL 하나로 시작하세요

Hermes Agent를 설치하고 이 저장소를 건네준 뒤 에디션을 고르세요. 한 시간 뒤에는 온전히 내 것으로 남는, 검증된 에이전트가 돌아갑니다.

GitHub — github.com/openit-ai/open-agent-os
문서 — 아키텍처, 쿡북, FAQ, 하네스 가이드
에디션 — Personal · Project · Company