HugAgentOS

给智能体装上可验证的推理骨架，让每一步决策都有据可查。

HugAgentOS 是一个用 Python 编写的自进化智能体操作系统，核心思路是把智能体的推理过程锚定在显式的本体（ontology）之上，从而让决策可追溯、可验证，缓解大模型智能体常见的幻觉与不可信推理问题。项目提供 agent 框架、harness 工程与桌面应用形态，支持在运行中持续演化知识结构与推理策略，让智能体不只是调用工具，而是基于结构化语义做判断。它适合需要可信推理链的复杂任务，例如多步规划、知识密集型问答和需要审计的自动化流程。技术栈涵盖 agent、agent-framework、desktop-app、harness 与 harness-engineering，强调可测试、可复现的智能体工程实践。目前星标约 1.1k，属于成长中的早期项目，生态与文档仍在完善，适合愿意参与共建或做前沿探索的开发者。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1106

维护状态活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队ZJU-REAL

所属国家

官网地址

GitHubhttps://github.com/ZJU-REAL/HugAgentOS

定价模式free

价格说明开源项目，定价信息待确认

访问状态

是否开源是

开源协议NOASSERTION

主要语言Python

技术栈/模型agent,agent-framework,desktop-app,harness,harness-engineering

GitHub 星标★ 1106

30天Star增速

HF 下载量

上线时间2026-07-19 00:00:00

最近更新2026-09-18 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-16

浏览次数0

使用教程

难度：入门约 10 分钟部署方式：本地安装 7 步

环境要求

一键安装需 Linux / macOS / WSL2，且已装 Python 3.11+、Node.js 20+、Git 和 curl
Docker 方式需 Git、Docker 及 Compose v2
需要一个 OpenAI 兼容模型或本地模型
一键安装默认占用 127.0.0.1:3001，Docker 方式访问 localhost:3002

安装与启动步骤

1确认环境依赖

一键安装走 Linux / macOS / WSL2，先备好 Python 3.11+、Node.js 20+、Git 与 curl；此方式不需要 Docker、PostgreSQL、Redis。
2一键安装并启动

脚本会把源码拉到 ~/.hugagent/source，建独立 Python 环境、构建 Web 应用并引导首次设置，随后自动打开 127.0.0.1:3001。
```
curl -fsSL https://raw.githubusercontent.com/ZJU-REAL/HugAgentOS/main/install.sh | bash
```
3首次登录改密

浏览器打开 http://127.0.0.1:3001，用初始账号 admin / 密码 admin 登录，并在首次登录时修改密码。
4连接模型服务

进入 Settings → System → Model services，配置一个 OpenAI 兼容或本地模型，否则智能体无法真正工作。
5日常再次启动

安装完成后，之后用安装目录里的可执行文件重新拉起服务，不需要再跑安装脚本。
```
~/.hugagent/venv/bin/hugagent
```
6Docker Compose 部署

需要 PostgreSQL、Redis、隔离沙箱和持久化卷时用这条路径：克隆仓库、复制环境文件、建数据目录并后台构建启动。
```
git clone https://github.com/ZJU-REAL/HugAgentOS.git
cd HugAgentOS
cp .env.example .env
mkdir -p data/storage
docker compose up -d --build
```
7打开 Docker 界面

容器起来后访问 http://localhost:3002，同样在 Settings → System → Model services 里连接模型，再用 admin 登录改密。

关键配置

配置项	必填	说明	示例
`.env`	是	Docker 方式的环境变量文件，从 .env.example 复制后按需调整	`.env.example 的默认内容`

如何确认成功

浏览器能打开 http://127.0.0.1:3001（Docker 为 http://localhost:3002），并用 admin / admin 登录成功即正常。

常见问题

Q：初始账号密码是什么？

A：初始账号和密码都是 admin，首次登录必须修改；社区版没有自助注册入口，无法自行注册账号。

Q：一键安装需要 Docker、PostgreSQL 或 Redis 吗？

A：不需要。该方式使用 SQLite、进程内状态和本地子进程沙箱，适合个人使用与开发；需要 PostgreSQL、Redis 和隔离沙箱时改用 Docker Compose。

Q：必须配置模型吗？

A：是。两条路径都需要一个 OpenAI 兼容或本地模型，在 Settings → System → Model services 中连接后才能正常使用。

Q：服务怎么重新启动？

A：一键安装后执行 ~/.hugagent/venv/bin/hugagent 再次启动；Docker 方式在仓库目录执行 docker compose up -d。

注意事项

一键安装默认只监听 127.0.0.1；确需远程访问可执行 hugagent serve --host 0.0.0.0 --port 3001 --no-browser，但请先设置强密码、防火墙与 HTTPS。
不要把服务直接暴露在不可信网络上。
社区仓库由上游主仓库按每次发布生成。

核心亮点

以本体为推理锚点，输出可追溯、可审计，直击智能体幻觉痛点
自带 harness 工程与桌面应用，便于复现实验和调试智能体行为
支持自进化机制，知识结构与策略可在运行中持续更新

不足之处

项目较新，文档与社区生态尚不成熟，上手门槛偏高
本体构建与维护需要额外领域知识，落地成本不低
自进化机制的实际稳定性与效果缺乏大规模验证

适用场景

需要审计推理链的金融、医疗等合规场景
知识密集型多步问答与规划任务
智能体行为可复现的科研与实验平台

替代项目

LangGraph、AutoGen、CrewAI

项目介绍

HugAgentOS 是一个智能体领域的开源项目，官方简介：HugAgentOS: The Self-Evolving AgentOS for Ontology-Grounded Trustworthy Reasoning。项目使用 Python 开发，在 GitHub 上获得 1098 星标。

上一篇：dsh-crew

下一篇：semantix