HoC-Republic
HoC-Republic is a self-hosted research platform where AI agents can live, coordinate, sustain, evolve, and reproduce specialized agents under human-defined constraints. It combines a TypeScript/Node.js agent runtime, a gateway, multi-channel messaging, a plugin SDK, and a large simulation of agent societies. It is for developers and researchers interested in recursive agent orchestration, multi-agent governance, and digital civilization experiments.
✨ Key features
- Self-hosted gateway with HTTP/WebSocket APIs and real-time agent control.
- Multi-channel messaging: WhatsApp, Telegram, Discord, Slack, Signal, iMessage, Matrix, LINE.
- Agent runtime with tool execution, routing, memory, subagents, and approvals.
- Republic simulation: governance, economics, citizens, family lineages, six-store memory.
- Plugin SDK for tools, channels, model adapters, and automation backends.
- Native surfaces: macOS, iOS, Android, browser, web, terminal, Windows companion.
🎯 Use cases
- Build always-on AI agents that operate across chat apps and web/mobile surfaces.
- Simulate digital civilizations with governance, memory, and evolution.
- Create recursive agent workflows where agents spawn specialized subagents.
- Experiment with multi-agent governance and collective decision-making.
- Develop self-improving agents that synthesize and test new tools.
📦 Installation
🧰 Requirements: Node.js >= 22.12, self-hosted deployment, no external API keys required for basic setup.
git clone https://github.com/hunix/HoC-Republic.git
cd HoC-Republic
npm install
(Assuming standard Node.js setup; README does not provide explicit install steps beyond cloning and running setup.)
🚀 Usage
# After cloning and installing dependencies, run the quick start from source.
# The README references a 'Quick start' section but does not provide a concrete command.
# Refer to the repository's documentation for detailed usage.
⚠️ Good to know
The repository is a large research monorepo with mature gateway and documentation work alongside experimental systems that require review before production use; public-release hygiene and security posture need human review.
❓ FAQ
What is HoC-Republic?
HoC-Republic is a self-hosted research platform where AI agents can live, coordinate, sustain, evolve, and reproduce specialized agents under human-defined constraints. It is the public home of HoC (Hani's OpenClaws).
What are the main components?
It includes a gateway, channels, agent runtime, Republic simulation, plugin SDK, and native surfaces. These are organized in the monorepo under src, apps, and ui.
What is the Republic simulation?
It models a persistent digital civilization with governance, economics, citizens, family lineages, six-store memory, cognition, self-improvement, compute routing, and federation.
Is it production-ready?
No, it is a research monorepo with some production-oriented components and many experimental systems. The README states that some components are research-grade prototypes and require review before production use.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.