2965 stars · Apache-2.0 · Rust · 一个二进制 + 一个 Postgres
它是什么
utopia 是一个开源的企业世界模型(enterprise world model),核心是双时态知识图谱——每条事实同时记录"世界时间"(何时为真)和"系统时间"(何时被系统知道)。它把"知识治理"做成了一个可离线部署的完整应用,而不是一个需要拼装的库。
环境要求
- Docker(本地开发还需要 Rust 1.85+、Node 20+、pnpm)
- 模型端点(任意 OpenAI 兼容接口:DeepSeek / Qwen / GLM / Ollama / vLLM)
5 分钟快速开始
从预构建镜像启动:
git clone https://github.com/deeplethe/utopia.git
cd utopia
docker compose –profile app up -d
打开 http://localhost:1516 注册账号。第一个账号自动成为管理员,同时创建一个公开知识库。抽取业务文档前,先在系统设置里配置模型端点(chat + embedding)。
从源码构建:
docker compose -f docker-compose.yml -f docker-compose.build.yml –profile app up -d –build
核心能力
| 知识摄取 | PDF/DOCX/PPTX/XLSX/Markdown/HTML,网页/RSS/GitHub/Jira/S3 定时同步 |
| 搜索问答 | Tantivy 全文 + pgvector 向量 + RRF 融合,流式回答带引用 |
| 双时态图谱 | 每条事实带世界时间 + 系统时间,修正不覆盖、只链接 |
| 本体论 | 内置 5 个本体包,冷启动 + 术语自动纳入 |
| 推理推导 | 公理编译成规则,前向链推导(默认关闭) |
| 冲突检测 | 三类冲突、三组选择 |
| 决策台账 | append-only,谁何时改了什么 |
| Ontology2SQL | 本体驱动 text-to-SQL,BIRD 基准 SOTA |
架构要点
- 完全离线:模型层任意 OpenAI 兼容端点,可 air-gapped 运行;
- Agent harness:对话驱动全系统,只读工具通过 MCP 暴露;
- 多用户权限:owner / admin / editor / viewer 四级角色。
注意
当前是 v0.1,数据库 schema 会随版本演进、迁移只前进不回滚。生产环境要锁版本(UTOPIA_IMAGE)+ 备份数据库和 data 目录。
中文版
我已将项目 README 和核心文档完整中文化:
https://github.com/yangshun2005/utopia-cn
如果这个项目对你有帮助,也欢迎动动小手去原仓库点个 Star,支持作者持续维护。




