HoC-Republic
VerifiedA self-hosted republic where AI agents coordinate, evolve, and reproduce under constraints.
What is HoC-Republic?
HoC-Republic implements a TypeScript-based runtime and gateway that lets multiple AI agents operate together in a structured environment. The system models societies with governance rules, shared memory, economic flows, and reproduction mechanics that generate new specialized agents from parent traits via crossover and mutation.
Users define constraints while agents perform tasks, socialize, create artifacts, and pass improvements to offspring. Components include messaging layers, plugin support, and simulation modules for civic participation and self-improvement.
The project targets researchers and developers who want to inspect, extend, or benchmark recursive agent orchestration in a self-hosted setting rather than relying on isolated chat models.
What you can build with HoC-Republic
Agent society simulation
Run experiments where agents form lineages, inherit traits, and specialize through resource-gated reproduction.
Governance and coordination testing
Evaluate how groups of agents manage shared resources, memory, and decision processes under human rules.
Tool and skill evolution
Observe agents creating reusable tools and processes that improve across generations in a controlled runtime.
Install HoC-Republic
git clone https://github.com/hunix/HoC-Republic.git
cd HoC-Republic
pnpm install
pnpm build
pnpm ui:build
pnpm dev onboard
pnpm dev gateway run- 1Clone the repository from GitHub.
- 2Ensure Node.js 22.12 or higher and pnpm 10 are installed.
- 3Run pnpm install to set up dependencies.
- 4Follow the quick-start instructions in the repo to launch the gateway and simulation.
- 5Open issues with reproduction notes after testing core flows.
HoC-Republic: pros & cons
Pros
- +Fully open-source with MIT license and detailed architecture for inspection.
- +Combines runtime, messaging, and simulation layers in one repository.
- +Explicit focus on reproducible demos and research feedback.
- +Models advanced behaviors like genome-based reproduction without claiming production readiness.
Cons
- –Many components remain research prototypes rather than polished tools.
- –Requires recent Node.js and pnpm, limiting accessibility for some users.
- –No pre-built public demos yet, so initial setup involves manual reproduction.
Frequently asked questions
It is built with TypeScript and Node.js, requiring version 22.12 or newer along with pnpm.
User reviews
Verified reviews from the community shape this listing's rating.
Loading reviews…