面向 AI Agent 的统一虚拟文件系统与上下文共享平面,提供版本控制、语义搜索、持久化记忆、ReBAC 权限、MCP 集成与联邦部署能力。
Nexus 是为 AI Agent 设计的文件系统与上下文基础设施,采用 Bricks → Kernel → Drivers 三层架构。内核(Kernel)提供 POSIX 风格虚拟文件系统、CAS 去重、三阶段写入等不变底座;上层 Bricks 模块按需加载,覆盖版本控制、快照、混合搜索(Zoekt + pgvector)、持久化记忆、基于 Zanzibar 的 ReBAC 权限委托、MCP 双向集成、工作流自动化、治理护栏与计量计费等 25+ 能力;底层 Drivers 可配置交换,支持 redb(嵌入式)、PostgreSQL、S3/GCS、Dragonfly 等存储后端。
支持三种部署模式:嵌入式(零基础设施,nexus.connect() 即用)、共享守护进程(团队多 Agent 协作)、联邦模式(跨数据中心 Raft 共识 + mTLS TOFU)。通过 MCP 暴露 30+ 工具,开箱集成 Claude Agent SDK、OpenAI Agents、LangGraph、CrewAI、Google ADK、E2B 等框架。内置冷存储分层可降低约 80% 冷数据成本。内核由 Python + Rust 混合实现(maturin 编译),跨平台支持 Linux/macOS/Windows,Docker 多架构(amd64 + arm64)。
四大存储支柱
| 支柱 | 接口 | 能力 | 是否必须 |
|---|---|---|---|
| Metastore | MetastoreABC | 有序 KV、CAS、前缀扫描、可选 Raft | ✅ 唯一内核初始化参数 |
| ObjectStore | ObjectStoreABC | 流式 Blob I/O、PB 级别 | 动态挂载 |
| RecordStore | RecordStoreABC | 关系型 ACID、JOIN、向量搜索 | 可选 |
| CacheStore | CacheStoreABC | 临时 KV、Pub/Sub、TTL | 可选 |
安装与快速开始
Docker 模式(推荐):
pip install nexus-ai-fs
nexus init --preset demo
nexus up
eval $(nexus env)
嵌入式模式:
import asyncio, nexus
async def main():
nx = await nexus.connect(config={"data_dir": "./my-data"})
await nx.write("/notes/meeting.md", b"# Q3 Planning\n- Ship Nexus 1.0")
print((await nx.read("/notes/meeting.md")).decode())
nx.close()
asyncio.run(main())
包分发
nexus-ai-fs(PyPI):完整包,含 CLI + SDKnexus-fs(PyPI):精简包@nexus-ai-fs/tui(npm):终端 UI
待确认:Nexi Labs 团队背景未公开;v1.0 时间线未明确;Zanzibar ReBAC 实现完整度与 Governance/Pay 模块成熟度(GA 或 preview)待验证;nexus-fuse 子项目功能未详述;Python 3.14+ 硬性要求可能对早期采用者构成门槛。