endue OS 문서

endue OS 는 AI 에이전트를 위한 OS 예요. 여러 기기와 클라우드 컴퓨트를 설치형 에이전트로 연동하고, 그 위의 OS 기능을 REST API 로 제공해요 — 사람도, 프로그램도, AI 에이전트도 같은 API 로 기기를 다뤄요. 사용자는 자기 환경인 Station 을 만들어 컴퓨터 한 대처럼 써요.

무엇을 할 수 있나

클라우드에 만들어요. linux·chrome·android·windows virtual Device 를 만들면 OS 가 VM 과 영구 볼륨(Storage)을 띄우고 에이전트를 설치해요. → 클라우드에 만들기
내 기기에 설치해요. Mac·Linux·Windows·Chrome·Android 에 에이전트를 설치하면 actual Device 가 돼요. → 기기 연결하기
명령을 보내요. 에이전트가 알려 준 도구를 POST /devices/{id}/commands 로 실행해요. 오래 걸리면 202 로 넘어가고, 끝은 롱폴·이벤트·웹훅으로 알아요. → 명령
화면을 보고 기기 앱을 열어요. chrome·android 의 화면을 한 장씩 받고, android 앱을 App 으로 저장해 열어요. Dock 은 2단 — 1단은 기기, 2단은 그 기기의 앱이에요. → 화면과 설치된 앱, Dock 과 앱
변화를 구독해요. Station 이벤트를 SSE·WebSocket·웹훅으로 받아요. → 이벤트와 웹훅
프로젝트와 크레딧으로 관리해요. Station 은 프로젝트로 묶고, 사용량은 내 계정의 크레딧으로 계산해요. Station 마다 명령 지표와 저장 객체 트리도 봐요. → Station 과 OS
늘려요. 직접 만든 에이전트를 와이어 프로토콜로 붙이고, 컴퓨트 공급자를 바꿔 끼워요. → 내 에이전트 붙이기, 컴퓨트 공급자

짜임

사용자·외부 시스템 ─HTTPS (JWT | osk_ 키)─▶ api-gateway (유일한 공개 진입점)
                                                │
   station · resource · agent · storage · app-service · command-service · relay-service · billing
                                                ▲
                       기기·VM 의 에이전트 ─WSS (에이전트가 먼저 접속)─┘

공개 진입점은 api-gateway 하나예요. 나머지 서비스는 바깥에 주소가 없어요. 에이전트는 바깥으로 먼저 접속하므로 기기에 공인 주소가 필요 없어요.

지금 상태

무엇	상태
공개 REST API (95개) · OpenAPI 3.1	계약 확정 · 로컬 스택에서 동작
에이전트 4종 (linux · mac · chrome · android)	와이어 프로토콜 v1.2
windows 에이전트	프리뷰 컴파일 확인까지 — Windows 에서 돌려 보지 않았고, 프로그램 실행은 거절해요
클라우드에 만들기 — 로컬 (linux · chrome · android)	로컬 공급자(Docker · 에뮬레이터)에서 동작
클라우드에 만들기 — Fly.io (linux · chrome) · AWS (windows · android)	프리뷰 어댑터는 있고 가짜 Fly·EC2 로만 확인했어요. 실제 클라우드 계정은 아직
프로젝트 · 크레딧 · 감사 로그 · 모니터링 API	로컬 스택에서 동작
크레딧 결제	테스트 결제(`mock`)만. 실제 결제는 예정
관리 콘솔 (`console.endueos.com`)	예정
운영 배포 (`api.endueos.com`)	예정
endue AI 에이전트와의 연동	예정