4,014· 381 forks· Rust· Apache-2.0自托管

Utopia:首个开源企业级世界模型与双时态知识图谱

deeplethe/utopia

基于 Rust + PostgreSQL 的企业知识治理平台,内置双时态图谱、本体推理与智能体框架,可离线部署的可信决策底座

成熟度维护活跃,最近提交0天前,15个 open issues,0.1.0-rc5 候选版本阶段

项目体检

部署 · docker compose 一键部署(默认端口 1516 应用 + 1517 数据库),数据库绑定回环避免端口冲突,支持受限角色分离迁移与业务连接

成本 · 开箱即用,可选配任意 OpenAI 兼容端点(DeepSeek/Qwen/Ollama 等)实现完全离线,JWT/加密密钥首次启动自动生成,需 32 字节 secret key 封印凭据

技术 · Rust + PostgreSQL 16 + pgvector,Axum Web 框架,Tantivy 全文检索,SQLx 数据库驱动,支持 MySQL 协议查询引擎

许可 · Apache-2.0 协议,允许商用、修改与分发,需保留版权声明与许可副本

活跃 · 活跃开发中,7 位贡献者,最近提交 0 天前,当前 0.1.0-rc5 候选版本

解决什么

企业决策系统面临三大困境:知识无法溯源(不知道某个结论何时、基于什么得出)、变更无法追踪(历史认知被覆盖导致审计断链)、智能体不可信(RAG 系统缺乏逻辑约束)。Utopia 通过双时态知识图谱(记录事实的真实时间与系统认知时间)+ 本体推理 + 智能体框架,构建可审计的企业知识底座。与传统向量库或知识图谱只关注"当前正确答案"不同,它保留完整演化历史:合并实体可撤销、修正事实保留旧版本、推理结果标注来源,形成符合合规要求的决策链条。

为何火

  1. 首个开源企业世界模型:在 Palantir 等商业方案垄断的领域提供开源替代,4000+ stars 证明企业对可控知识基础设施的需求
  2. 时间感知架构:双时态设计让系统能回答"2025 年 3 月我们认为客户 X 的信用评级是多少"(当时的认知)与"客户 X 的评级在 2024 年实际是什么"(事实时间),满足金融/法律等强审计场景
  3. 真正的离线能力:一个 Rust 二进制 + PostgreSQL 即完整系统,支持国产模型(DeepSeek/Qwen/GLM)与 Ollama,无需外部依赖可部署在内网
  4. 工程化本体管理:内置 schema.org/FOAF 等五套本体包,支持冷启动与增量确认,避免从零定义概念体系的高门槛

核心功能

  • 知识摄入:支持 PDF/Office/Markdown/HTML,自动检测 GB18030 等遗留编码;定时同步 RSS/GitHub/Jira/Notion/WebDAV/S3
  • 双时态图谱:每个事实携带有效时间(valid time)与事务时间(transaction time),修正操作创建新版本而非覆盖,保留完整溯源链
  • 本体推理:公理编译为规则(传递性/对称性/逆关系),前向推理派生新事实,派生结果标注来源与置信度,与断言事实冲突时断言优先
  • 实体消解:三阶段去重(精确匹配 → 向量相似度 → 模型判断),不确定案例进入审核队列,所有合并可撤销
  • 智能体框架:内置工具可搜索文档、遍历图谱(查询任意时间点的实体状态或时段内变更)、查询外挂数据库,相同工具通过 MCP 协议暴露
  • 融合检索:Tantivy 全文 + pgvector 向量,RRF 算法融合,答案流式输出带行内引用可跳转原文

安装

# 克隆仓库
git clone https://github.com/deeplethe/utopia.git && cd utopia

# 复制配置(可选,默认值适合本地开发)
cp .env.example .env

# 一键启动(首次拉取镜像需 2-3 分钟)
docker compose --profile app up -d

# 访问 http://localhost:1516
# 首个注册用户自动成为管理员

国内加速: 编辑 .env 添加 UTOPIA_DB_IMAGE=registry.cn-hangzhou.aliyuncs.com/xxx/pgvector:pg16(替换为可用镜像源)

生产部署注意:

  • 修改 UTOPIA_DB_PASSWORD 为强密码
  • 启用受限角色(见 .env.exampleUTOPIA_APP_DB_PASSWORD 段落),分离业务与迁移权限
  • 反向代理配置 X-Forwarded-Proto 头以自动启用 HTTPS cookie

适合谁

  • 金融/法律行业:需要完整审计链条,能回溯任意时间点的决策依据与知识状态
  • 合规团队:要求知识变更可追溯、推理过程可解释、数据不出内网
  • 研究机构:管理长期演化的知识体系(如医学指南更新、政策变迁),保留历史版本用于纵向研究
  • 企业 AI 团队:需要给智能体提供可信知识底座,而非直接让 LLM 访问原始文档库
  • 开发者:熟悉 Rust/PostgreSQL,愿意参与早期项目打磨(当前 rc 阶段)

社区评价

热度: HN 讨论 750 点 171 评论,但需注意该讨论针对的是同名但完全不同的 React 可视化设计工具,与本项目无关。GitHub 项目本身 4000+ stars 主要来自企业知识管理与 RAG 社区,尚未形成大规模公开讨论。

中立评估(基于项目本身):

  • 正面: 架构设计清晰(双时态 + 本体推理填补开源空白),工程化程度高(一个二进制 + 数据库即完整方案,无需 Kafka/Redis 等额外组件),文档详尽(哲学/部署/API 均有覆盖)
  • 争议点: 0.1.0-rc 阶段成熟度存疑,生产案例未公开;与 Palantir 的对比缺乏量化指标;Rust 技术栈对非系统级开发者有门槛
  • 观望因素: 7 位贡献者规模较小,长期维护能力待验证;本体管理对非领域专家仍有学习曲线

选型对比

维度UtopiaNeo4j + LangChainPalantir Foundry
时间模型双时态原生支持需自行建模 valid/transaction time支持版本控制但非双时态
部署单机 Docker,离线可用需 Neo4j + 向量库 + 编排层SaaS 或私有云,复杂部署
本体推理内置公理推理引擎需编写 Cypher 规则通过 Ontology SDK
成本开源免费Neo4j 企业版 $$$,开发成本高按席位计费,六位数起
适用场景中小企业合规场景灵活定制但需强开发能力大型企业全栈方案

取舍: Utopia 牺牲生态成熟度(Neo4j 有丰富插件与可视化工具)换取开箱即用与成本可控;相比 Palantir 缺少数据集成与协作 UI,但提供完全的代码控制权。

已知坑

  1. rc 阶段限制(README 明示):

    • 推理默认关闭(错误公理会派生错误事实),需手动启用并验证本体
    • 实体消解的模型判断阶段依赖外部 LLM,离线部署需配置 Ollama 等本地端点
  2. 部署注意(来自 docker-compose.yml 注释):

    • 默认数据库端口 1517 绑定回环,cargo run 本地开发时需确保能连通
    • 受限角色机制仅防应用层 bug/注入,无法防御容器内 psql 直连(需配合服务器访问控制)
    • 数据目录的 secret.key 不进数据库,备份时需单独保存
  3. 性能边界(推测自架构):

    • 全文索引在应用内存(Tantivy),大规模文档集可能需调整 JVM 式的内存配置
    • 单 PostgreSQL 实例,高并发写入需考虑分片或读写分离(当前未提供)
  4. 中文特定:

    • 文档提到支持遗留编码检测,但 PDF 中文提取质量取决于上游库(可能需预处理)
    • 国产模型兼容性已验证 DeepSeek/Qwen,但 prompt 工程可能需针对不同模型调优

安装方式:docker compose