← all repositories
ZJU-REAL/HugAgentOS

Self-Evolving Agents, But Only After You Sign Off

HugAgentOS is a self-hosted agent workspace that grounds reasoning in domain ontology and only lets its skills and memory evolve after human review.

622 stars Python AgentsCoding Assistants
HugAgentOS
Collecting fresh signals — velocity needs a few days of history.
collecting data…
star history

What it does HugAgentOS bundles chat, private RAG, sandboxed code execution, long-term memory, and MCP tool orchestration into a single self-hosted workspace for individual users. It runs model-agnostic, connecting to OpenAI-compatible or local models, and keeps all data on your own hardware. The open-source Community Edition is essentially a complete personal agent workstation; an Enterprise tier adds organization-wide governance.

The interesting bit The project treats domain ontology not as documentation but as a machine-executable control plane that governs reasoning, validation, and gated execution. Its “self-evolution” is genuinely cautious: the system distills new skills and memory from your work, versions them as ontology proposals, and applies them only after you approve each change—violations come back with the broken rule and a correction, never a silent pass.

Key highlights

  • ReAct orchestration of sub-agents, MCP servers, and sandboxed code execution for real file and data processing.
  • Three-layer personal memory (relational profile, optional vector store, optional graph store) with per-user isolated knowledge bases.
  • Gated execution with deterministic rule checks and risk-tiered evidence review before actions run.
  • Traceable, rollback-capable evolution where every skill or memory update requires explicit human approval.
  • Self-hostable via a local installer or Docker Compose, with SQLite or PostgreSQL backends.

Caveats

  • The ontology trust control plane is still being integrated in stages, and the README explicitly warns it does not promise “zero hallucination” for free text.
  • Several governance, persistent-sandbox, and collaboration capabilities shown in the architecture diagram are Enterprise-only and absent from the Community source tree.
  • The Community Edition ships with a hardcoded initial admin account and no self-registration, so it is effectively single-user out of the box.

Verdict A solid candidate if you want an all-in-one, self-hosted agent workstation with an unusual emphasis on audit trails and human-in-the-loop evolution. Look elsewhere if you need turnkey multi-tenant SaaS or fully mature hallucination-free guarantees—both are explicitly marked as works-in-progress or Enterprise-only.

Frequently asked

What is ZJU-REAL/HugAgentOS?
HugAgentOS is a self-hosted agent workspace that grounds reasoning in domain ontology and only lets its skills and memory evolve after human review.
Is HugAgentOS open source?
Yes — ZJU-REAL/HugAgentOS is an open-source project tracked on heatdrop.
What language is HugAgentOS written in?
ZJU-REAL/HugAgentOS is primarily written in Python.
How popular is HugAgentOS?
ZJU-REAL/HugAgentOS has 622 stars on GitHub.
Where can I find HugAgentOS?
ZJU-REAL/HugAgentOS is on GitHub at https://github.com/ZJU-REAL/HugAgentOS.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.