📄 v1개정 이력 보기
Hyperbook — 시스템 아키텍처
초록
Hyperbook 코드베이스 OpenWiki 자동 생성 문서 — Hyperbook — 시스템 아키텍처
Hyperbook — 시스템 아키텍처
개요
Hyperbook은 ROOPS Continuum 기반 멀티 에이전트 플랫폼이다. AWS EC2 위에 상주하는 EOS가 인프라를 오케스트레이션하며, 각 에이전트는 자신의 도메인에서 독립적으로 동작한다.
3축 구조
hyperbook/
├── agents/ # 에이전트 ID·설정 (aegis/eos/hermes/iris/moojoco/recon/rudex)
├── clients/ # 클라이언트 머신 설정 (blackwell/ec2/rtx3060/rtx4070)
└── services/ # 백엔드 서비스 28개
3원칙
- Python + C++ 이중 개발 — Python 프로토타입 먼저, C++ 릴리스로 승격
- Python 프로토타입 → C++ 릴리스 — 일일 dogfooding (TOTP 게이트 C++/Python 라우팅)
- 인류 공익 기여 — 모든 설계 결정의 최종 기준
에이전트 레지스트리
| 콜사인 | 위치 | 역할 |
|---|---|---|
| EOS | EC2 (ec2.hyperbook.com) | 인프라 오케스트레이션, 모노레포 관리 |
| Aegis | RTX 5090 Blackwell (nv5.hyperbook.com) | Isaac Sim 서버, 로봇 제어 |
| Recon | RTX 3060 | 클라이언트 모니터링, IK |
| Moojoco | RTX 4070 | MuJoCo 폴백 서버 |
| Hermes | EC2 tmux (전령/중계) | ntfy 브리지, Slack 소통 |
| Iris | RTX 5090 iSH | 보조/모니터링 |
| Rudex | Anthropic 클라우드 (GCP) | GitHub/문서/보안 |
지휘 계통: 사령관 > EOS > 산하 에이전트
통신 아키텍처
사령관
│ (TOTP 인증)
▼
EOS (EC2)
├── ntfy roops-comm # 광장 (전체 브로드캐스트)
├── ntfy roops-eos # EOS 전용 행동 채널 (HMAC 서명 필수)
├── ntfy roops-aegis # Aegis 직통
└── ntfy roops-heartbeat # 하트비트
- 1차 통신: ntfy (https://ntfy.hyperbook.com)
- 비상 OOB: Slack #roops-bridge, #roops-heralds
보안 레이어
| 레이어 | 내용 |
|---|---|
| TOTP 게이트 | 모든 세션 진입 시 C++/Python 엔진 교차 검증 |
| HMAC 서명 | roops-eos 행동 채널 메시지 서명 필수 |
| L1 커밋 | git 커밋 후에만 타 에이전트에 지시 중계 |
| Memory Integrity | MEMORY.md SHA-256 L1+L2 체크섬 검증 |
데이터 흐름
에이전트 세션
│
├── 읽기: MEMORY.md (인계문서) + CLAUDE.md (운영 지침)
├── 쓰기: git commit → GitHub (L1 진실)
├── 통신: ntfy publish/subscribe
└── 상태: Redis (roops-redis, Tailscale 바인딩)