lhumina_code/hero_template
0
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
2 commits 1 branch 0 tags 203 KiB
  • Rust 42.9%
  • HTML 35.2%
  • JavaScript 12.3%
  • CSS 9.6%
Find a file
Exact
despiegk 89948ab45a Add hero_agent workspace with admin, web, SDK, and server crates 
Introduces a full Cargo workspace for the Hero Agent template:
- hero_agent_admin: Axum+Askama admin dashboard with OpenRPC proxy, SSE, git branch/worktree management, agent CRUD, and usage tracking
- hero_agent_web: end-user chat UI with session list, file browser, and streaming message support
- hero_agent_sdk: generated OpenRPC client bindings for hero_agent_server
- hero_agent_server: JSON-RPC server scaffold with OSchema-defined compute_playground domain models

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-18 11:39:18 +02:00
crates Add hero_agent workspace with admin, web, SDK, and server crates 2026-05-18 11:39:18 +02:00
Cargo.lock Add hero_agent workspace with admin, web, SDK, and server crates 2026-05-18 11:39:18 +02:00
Cargo.toml Add hero_agent workspace with admin, web, SDK, and server crates 2026-05-18 11:39:18 +02:00
README.md Add hero_agent workspace with admin, web, SDK, and server crates 2026-05-18 11:39:18 +02:00

README.md

hero_agent

Multi-provider AI agent service for Hero OS. Runs agents against any supported backend (Claude, OpenCode, Codex, …) and exposes them via a single JSON-RPC 2.0 API over Unix socket.

New here? See the architecture overview.

How It Works

hero_agent_server listens on $HERO_SOCKET_DIR/hero_agent/rpc.sock and dispatches agent jobs to the configured provider backend. hero_agent_admin provides a web dashboard for managing agents, and hero_agent_web provides a chat-style interface for direct interaction.

Requirements

  • Rust 1.95+
  • Hero OS (hero_proc running)

Quick Start

service_hero_agent install
service_hero_agent start

Or for development:

cargo build --release --workspace

Service Architecture

Binary Purpose
hero_agent Lifecycle CLI — --start, --stop, --status
hero_agent_server JSON-RPC 2.0 daemon (hero_agent/rpc.sock)
hero_agent_sdk Auto-generated typed client
hero_agent_admin Admin dashboard (hero_agent/admin.sock)
hero_agent_web Chat interface (hero_agent/web_chat.sock)

Sockets

Socket Protocol Purpose
hero_agent/rpc.sock OpenRPC Core agent API
hero_agent/events.sock SSE Live event stream
hero_agent/admin.sock HTTP Admin dashboard
hero_agent/web_chat.sock HTTP Chat web UI

Configuration

Runtime config is stored in hero_proc secrets. Key: hero_agent/*.

Documentation

License

Apache-2.0