AgentHub

Offline-Ready Enterprise AI Agent Runtime Platform

JupyterHub처럼 각 사용자와 영속 Workspace마다 격리된 OpenCode 및 Hermes 런타임을 제공하는 엔터프라이즈 제어면

🌐 웹 쇼케이스 둘러보기 · 📖 사용자 매뉴얼 · 🚀 CRU 실전 워크스루 · 📐 시스템 아키텍처

• 🔒 완전 폐쇄망 (Offline-Ready): 외부 인터넷 연결 없이 로컬 Docker 레지스트리와 내부 Kubernetes 클러스터 상에서 100% 결정론적으로 동작합니다.
• 📦 영속 Workspace & CSI 스냅샷: Agent Pod가 종료/재생성되어도 사용자의 소스 코드와 데이터는 PVC에 보존되며, CSI VolumeSnapshot을 통해 언제든 원하는 시점으로 복원할 수 있습니다.
• 🤖 3대 엔터프라이즈 에이전트 런타임: 인터랙티브 코딩 워크스페이스(OpenCode) 및 자율 에이전트 어시스턴트(Hermes / Qwen Paw)를 사용자 전용 비루트(Non-root) Pod로 격리 기동합니다.
  • Qwen Paw (AgentScope): 3계층 ReMe 메모리, 커널 샌드박스 보안 가드, 스킬/MCP 확장 및 Qwen/Ollama 모델 자율 추론을 지원하는 개인 에이전트 워크스테이션
  • OpenCode: 브라우저 기반 풀스택 코딩 IDE 및 실시간 파일/터미널 워크스페이스
  • Hermes Agent: 장기 기억(Long-term Memory) 및 도구 실행 자율 에이전트
  • custom: 사내에서 직접 만든 에이전트도 시작 명령과 포트만 지정하면 동일한 격리·정책·실행 플레인 위에서 운영할 수 있습니다.
• 🤖 자율 실행 플레인: Agent에 Goal과 Trigger를 주면 예약·Webhook·수동으로 스스로 Task를 수행하고, 완료 조건을 플랫폼이 검증한 뒤 산출물과 실행 타임라인을 남깁니다. 기존 Interactive 방식은 그대로 유지됩니다.
• 📄 GitOps 정의 내보내기/가져오기: 에이전트 정의를 YAML로 주고받아 형상 관리와 클러스터 간 이관이 가능합니다. 참조는 이름으로 기록되며, 대상 클러스터에 없는 항목은 이름을 알려주고 거절합니다.
• 💰 토큰 사용량·비용 가시화: 실행 기록에 이미 남는 토큰 수를 그대로 집계해 에이전트별 입력·출력 토큰과 금액을 보여줍니다. 단가가 없는 모델은 금액 0이 아니라 '미산정'으로 구분해 합계를 왜곡하지 않습니다.
• 🛡️ MCP 도구 정책: MCP 서버 단위가 아니라 도구 단위로 호출 권한을 제한합니다. Pod 내부 게이트웨이가 강제하므로 에이전트가 우회할 수 없고, 차단된 도구는 목록에서도 숨겨지며, 자격 증명은 에이전트 컨테이너에 들어가지 않습니다.
• 📡 이벤트 Trigger: 작업 실패·런타임 장애·승인 처리·산출물 생성 같은 플랫폼 이벤트에 다른 Agent가 반응해 후속 작업을 시작합니다. 이벤트는 DB 아웃박스에 적재되어 재시작에도 유실되지 않으며, 페이로드 필터와 순환 방지로 불필요한 기동을 막습니다.
• 🧭 자율 제어(Planner · Approval · Memory · Delegation): 실행 전 계획을 수립하고, 상태 변경 작업은 사람의 승인을 받은 뒤 재개하며, 학습한 사실을 Agent 범위로 영속화하고, 권한 밖의 일은 순환·깊이 제한 아래 다른 Agent에게 위임합니다.
• 🇰🇷 한국어 우선 관리 콘솔: 메뉴, 상태, 안내 문구를 한국어로 제공하며 빠른 이동(⌘K)은 한글·영문 키워드를 모두 검색합니다.
• 🔀 Multi-Agent Workflow DAG: 복수 에이전트 간의 순차/병렬/Supervisor 협업 그래프를 시각화하고, 실행 전 순환 참조(Cycle) 및 깊이 제한을 자동 검증합니다.
  • 합의(Consensus) 모드: 같은 질문을 독립적으로 물어 표결로 결론을 냅니다. 집계는 플랫폼이 직접 계산하며 만장일치·다수결·동률을 구분하고, 소수 의견과 기권까지 기록에 남깁니다.
  • 감독자(Supervisor) 모드: 감독 에이전트가 결과를 검토해 보완이 필요한 에이전트만 다시 실행시키고, 개정된 결과를 재검토해 승인합니다. 검토 횟수는 제한되며 승인 여부가 실행 기록에 남습니다.
• ⚡ Runtime 예열 & 워커 자동 확장: 예약 실행 전에 Runtime을 미리 띄워 콜드 스타트를 없애고, 대기열이 밀리면 워커가 동시 실행 수를 스스로 늘렸다가 한가해지면 되돌립니다. 예열된 Runtime은 사람이 손대는 순간 사용자 소유가 됩니다.
• 🔌 MCP Fabric (Model Context Protocol): 사내 MCP 도구 레지스트리와 번들을 관리하고, Sidecar 또는 전용 StatefulSet 모드로 에이전트에 안전하게 주입합니다.
• 🔐 Envelope Encryption Vault: 사용자별 개인 키(AES-256-GCM)로 Credential을 암호화하며, Agent 정의에는 원문 대신 식별 참조값만 주입됩니다.
• 🌐 Session Gateway: One-Time Launch Ticket을 발급하여 네이티브 Web UI에 대한 안전한 쿠키 격리 및 감사 추적(Audit Trail)을 보장합니다.

https://github.com/user-attachments/assets/agenthub_demo.mp4

💡 3분 데모 비디오 파일 직접 다운로드 / 보기
로그인 → Agent Builder 템플릿 생성 → Kubernetes Pod/Node 즉시 스케줄링 → Hermes TUI 및 Ollama Gemma 4 모델 실시간 추론 대화까지 전 과정을 3분(180초) Full HD 영상으로 확인하실 수 있습니다.

Hermes Live Workspace (Ollama Gemma 4 실시간 추론)	실시간 내 에이전트 (Kubernetes Pod / Node 즉시 할당)
Agent Builder 템플릿 생성 드로어	에이전트 상세 스펙 및 CRD 상태
OpenCode 영속 Workspace	Ollama 로컬 모델 카탈로그
MCP Fabric 도구 카탈로그 & 번들	운영 센터 실시간 감사 로그

📌 전체 33개 스크린샷과 상세 설명은 사용자 가이드 및 인터랙티브 쇼케이스 페이지에서 확인하실 수 있습니다.

Browser ──> AgentHub Portal / Session Gateway ──> PostgreSQL
                 │
                 ├──> AgentRuntime CRD (Kubernetes)
                 │          │
                 │          v
                 └──> Agent Operator ──> StatefulSet + Service + Persistent PVC
                                                │
                               ┌────────────────┴────────────────┐
                               v                                 v
                      OpenCode :4096 (Web IDE)          Hermes API :8642 + UI :9119

• 제어면(Control Plane)과 런타임(Data Plane)의 완전한 분리: AgentHub 포털 컨테이너 내부에서는 어떠한 사용자 코드나 에이전트 프로세스도 직접 실행되지 않습니다.
• Agent Definition vs Runtime Instance: Agent 설정 정의는 PostgreSQL에 안전하게 저장되며, 런타임 종료 시 Pod만 스케일 다운(0)되고 PVC와 설정은 영구 보존됩니다.

AgentHub는 단 4개의 필수 환경변수만으로 동작합니다:

# 1. 환경 설정 파일 생성
cp .env.example .env

# 2. PostgreSQL 데이터베이스 기동
docker compose up -d postgres

# 3. 프론트엔드 및 백엔드 빌드
cd web && npm ci && npm run build && cd ..
make build

# 4. AgentHub 서버 실행
set -a && . ./.env && set +a
./bin/agenthub

웹 브라우저에서 http://localhost:8080에 접속합니다.

• 초기 관리자 ID: admin
• 초기 비밀번호: local-development-password (또는 .env에 설정한 값)

# 1. Minikube 클러스터 시작
minikube start --driver=docker

# 2. Kubernetes CRD, RBAC 및 Operator 매니페스트 배포
kubectl apply -k deploy/kubernetes

# 3. AgentHub 런타임 베이스 이미지 빌드 및 로드
make image image-base
# base 이미지는 BASE_VERSION 파일을 따르며, 변경이 없으면 이전 태그를 그대로 사용합니다.
minikube image load agenthub:v0.13.0
minikube image load agenthub-base:v0.7.0

# 4. 파드 상태 확인
kubectl get pods -n agent-platform-system

• 📖 사용자 & 관리자 매뉴얼: 33개 스크린샷 기반의 전 메뉴 상세 기능 가이드
• 🚀 CRU 실전 운영 워크스루: Workspace, Agent, Workflow 생성/수정 10단계 튜토리얼
• 🌐 인터랙티브 웹 쇼케이스: 반응형 다크 테마 기반의 프로젝트 홍보 랜딩 페이지
• 📐 시스템 아키텍처 상세: 보안 경계, 세션 게이트웨이, 어댑터 명세
• 📦 오프라인 설치 가이드: 에어갭(Air-Gapped) 환경에서의 릴리스 아카이브 및 배포

Apache License 2.0. Copyright (c) 2026 AgentHub Contributors.