Moss
面向 AI 智能体的亚 10 毫秒语义检索运行时,无需向量数据库,可嵌入浏览器、边缘与云端。
- 源仓库
- usemoss/moss
- Star 数
- ★ 889
- 最近更新
- 2 天前
- License
- BSD-2-Clause
- 主语言
- Python
- FA 评分
- 53/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配
- 费用
- 有免费版,另有付费云服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 语音客服或实时对话智能体开发者:需要把检索延迟压到 10 毫秒以内,否则会打断对话节奏。
- 不适合
- 无法接受索引托管在 Moss Cloud 的团队
- 完全不联网或需在气隙环境运行的场景
- 官网
- moss.dev ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-19最新版本 c-sdk-v0.32.0(2026-11-17)近 7 天每天 +12.0 ★
- 源码审查
- 53/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
Moss 是一个把检索和嵌入直接跑在应用进程内的搜索运行时。它由三部分组成:Moss Cloud 负责文档摄取、嵌入、存储与分发;Index 是把文档与向量打包成的单一产物;Runtime 嵌入在你的 Python、TypeScript、Elixir 或 C 应用中,通过 HTTPS 拉取索引并在本地内存中应答查询。SDK 提供 create_index、load_index、query 等接口,支持语义加关键词的混合检索、内置嵌入模型、元数据过滤($eq、$and、$in、$near),另有 WebAssembly 版本 @moss-dev/moss-web 可完全在浏览器端运行。官方基准显示 10 万文档上端到端 P50 为 3.1 毫秒,明显快于远程向量库的数百毫秒往返。仓库同时提供 CLI、多种数据库连接器以及 LangChain、LlamaIndex、Pipecat、LiveKit、Vapi、ElevenLabs 等框架集成示例,采用 BSD-2-Clause 许可。
使用 Moss 的典型流程是:先在 moss.dev 注册获得 project_id 与 project_key,然后用 MossClient 的 create_index 方法写入带 id 与 text 的文档,Moss Cloud 负责生成嵌入并打包成可分发索引。客户端调用 load_index 通过 HTTPS 把索引拉到本地内存,随后 query 在本进程内完成嵌入与检索,返回 docs 列表以及 time_taken_ms,单次查询延迟在个位数毫秒。查询支持 QueryOptions(top_k=...) 或 { topK } 指定返回条数,并通过元数据操作符做条件过滤。浏览器场景改用 @moss-dev/moss-web 这个 WebAssembly 构建,索引下载后完全在客户端查询,无需服务端。仓库还包含 packages/moss-cli 的命令行工具、packages/moss-data-connector 的 SQLite/MongoDB/MySQL/Supabase 摄取连接器,以及 examples 与 apps 下可直接运行的语言、语音智能体和框架集成样例。
- 语音客服或实时对话智能体开发者:需要把检索延迟压到 10 毫秒以内,否则会打断对话节奏。
- 要构建 RAG 的后端团队:希望避免自建与管理向量数据库集群,直接用 SDK 在进程内查询索引。
- 做静态站点或浏览器扩展的前端团队:需要客户端语义搜索,使用 @moss-dev/moss-web 在浏览器内离线查询。
- 已在用 LangChain、LlamaIndex、DSPy 或 CrewAI 的团队:想给现有检索链换成低延迟运行时。
- 搭 Pipecat、LiveKit、Vapi、ElevenLabs 语音管线的团队:需要把低延迟检索接入实时音频流程。
- 从 SQLite、MongoDB、MySQL 或 Supabase 同步数据的团队:希望用现成连接器把业务数据摄入索引。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
pip install mossnpm install @moss-dev/mossnpm install @moss-dev/moss-webpip install -r requirements.txt
- 配置文件
.env../../.env.example
如何安装或部署这个 Agent?
服务端先安装对应语言的 SDK,并在 moss.dev 注册取得 project_id 与 project_key。Python 需要 3.10+:
pip install mossTypeScript / Node.js 需要 20+:
npm install @moss-dev/moss浏览器端使用独立的 WebAssembly 包:
npm install @moss-dev/moss-web运行仓库自带示例前,需要把凭证写进 .env(复制 .env.example 后填写):
cd examples/python
pip install -r requirements.txt
cp ../../.env.example .env
python load_and_query_sample.py如何使用这个 Agent?
Python 端到端示例:
from moss import MossClient, QueryOptions
client = MossClient("your_project_id", "your_project_key")
await client.create_index("support-docs", [
{"id": "1", "text": "Refunds are processed within 3-5 business days."},
{"id": "2", "text": "You can track your order on the dashboard."},
{"id": "3", "text": "We offer 24/7 live chat support."},
])
await client.load_index("support-docs")
results = await client.query("support-docs", "how long do refunds take?", QueryOptions(top_k=3))TypeScript 端到端示例:
import { MossClient } from "@moss-dev/moss";
const client = new MossClient("your_project_id", "your_project_key");
await client.createIndex("support-docs", [
{ id: "1", text: "Refunds are processed within 3-5 business days." },
{ id: "2", text: "You can track your order on the dashboard." },
{ id: "3", text: "We offer 24/7 live chat support." },
]);
await client.loadIndex("support-docs");
const results = await client.query("support-docs", "how long do refunds take?", { topK: 3 });这个 Agent 有哪些优点和局限?
- 查询在应用进程内完成,官方基准中 10 万文档端到端 P50 为 3.1 毫秒,比远程向量库快两个数量级
- 内置嵌入模型,无需 OpenAI 密钥即可生成向量,也支持自带嵌入
- 同时提供服务端 SDK 与 @moss-dev/moss-web 的 WebAssembly 构建,浏览器内即可离线检索
- Python、TypeScript、Elixir、C 多语言 SDK,配套 CLI、数据库连接器和大量框架/语音智能体集成样例
- BSD-2-Clause 许可,SDK、示例与集成代码完全开源
- 索引的摄取、嵌入、存储与分发依赖 Moss Cloud,使用 project_id 与 project_key,本地无法完全脱离该服务构建索引
- 基准是官方数字,且竞品在对比中使用外部嵌入服务,实际相对优势需自行复现验证
- 文档以英文为主,中文资料有限,团队需自行承担翻译成本
- Python SDK 需要 3.10+、Node.js 需要 20+,旧运行时无法直接使用
这个 Agent 与同类方案有什么区别?
README 在基准中直接对比了 Pinecone(端到端 P50 432.6 毫秒)、Qdrant(597.6 毫秒)与 ChromaDB(351.8 毫秒),指出这些系统需要远程向量数据库往返,而 Moss 把检索与嵌入放进进程内;README 也明确说明 Moss 不是数据库,不涉及集群管理、HNSW 参数调优或分片。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Moss 当前 | 53 · 缺口较多 | 代码库 / SDK免费版 + 付费版 | ★ 889 | 2 天前 | Python | — |
| MCP Memory Service | 68 · 存在缺口 | MCP 服务器免费 | ★ 2.1k | 1 天前 | Python | ChatGPT · Codex · Claude Code · Claude.ai |
| RAGLight | 66 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 672 | 1 个月前 | Python | OpenAI API |
| AgentOS | 64 · 存在缺口 | 代码库 / SDK免费 + 模型费 | ★ 691 | 1 天前 | TypeScript | Claude Code · OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
AGENTS.md 将本地查询与云端索引分发区分开,示例说明凭据通过环境变量提供,Agora 示例也限制可用 MCP 工具;这些内容支持数据流透明度与有限权限判断。扣分原因是检索、创建、添加和删除索引/文档等操作没有展示确认或恢复机制,示例涉及上传 PDF、外部云服务及凭据,但未充分说明敏感数据保护、依赖风险或组织责任;来源仅以 Moss 团队署名,发布者身份仍未知。
README、AGENTS.md 和样例对 SDK、云端索引与本地运行时的角色大体一致,CI 文件列出若干检查与测试;但仓库包含多语言 SDK、集成和应用,所给样本不足以支持整个产品的一致性或依赖可用性结论。Python Docker 样例缺少必要环境变量时会给出明确提示,PDF 应用对无文本和种子索引加载失败也有具体响应,因此失败信息得分较高,但证据范围有限。
README 和 AGENTS.md 展示 Python、TypeScript、浏览器、云端、边缘/本地运行、多个框架及语音代理等明确场景,适用对象和场景描述充分。文档也指出 Moss 是搜索运行时而非数据库,并区分服务端与浏览器 SDK;但提供的材料对规模、数据治理及各种部署限制说明有限。Zo 技能触发条件较宽,将一般建议也列为可能搜索时机,并要求新对话自动列出、加载和搜索索引,触发边界不够精确。
README 与 AGENTS.md 提供丰富的目录地图、集成表、快速开始和示例运行说明;Zo 技能也列出命令、参数及用户意图映射。限制说明包括实验区不稳定、Moss 不是数据库及各 SDK 的运行环境要求。扣分原因是 README 的许可证说明指出不同 SDK 适用不同许可,而给定元数据仅标 BSD-2-Clause;版本变更信息不在材料中,命名/发布范围有不一致迹象(README 与 AGENTS.md 对 JS 包名描述不同),维护责任仅有团队名称和安全报告邮箱,缺少更清楚的维护路径证据。
产品提供加载索引后本地检索、语义与关键词混合搜索、过滤和多种 SDK/集成;快速开始代码与示例可直接展示查询结果,具有实际整合价值。README 给出延迟基准及复现入口,但当前材料只包含声明和链接说明,无法从样本核实比较条件;成本收益也主要由性能和免管理集群的陈述支持,缺少资源、索引同步或运营成本细节,因此未给满分。
README、AGENTS.md、样例、CI 工作流和安全政策对部分能力与流程提供相互呼应的材料,README 也把基准标为可复现并列出测量参数。扣分原因是主要性能与产品能力仍以项目自己的陈述为主,样本没有包含基准实现、SDK 主源码或完整测试;README 的许可证徽章与详细许可说明、包名表述也存在表面不一致。对实证结果与推断的区分不够系统,因此该项较低。
- 性能基准来自 README 的自述;此静态评估未运行代码,也未核实基准方法或结果。
- 请按实际使用的 SDK、示例或组件核对许可证;README 描述不同组件可能适用 BSD-2-Clause 或 PolyForm Shield,不能仅凭给定许可证元数据判断。
- Zo 技能建议在新对话中自动列出和加载索引,且在较宽泛情形下搜索;部署前应审查其数据访问范围和触发条件。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
c-sdk-v0.32.0 libmoss v0.32.0
发布说明摘录
Precompiled C SDK binaries for the Moss SDK. Added - Each archive carries LICENSE.txt, the PolyForm Shield License 1.0.0 terms of the library. The release notes name them too. Changed - A new client loads an index from cache_path in about one round trip to the Moss cloud when another client or session in the same process has the index's model loaded. Clients in one process share the project's token and each loaded embedding model, and on macOS, Linux and Windows also their connections to the cloud; every load still checks the cloud version of the index. Freeing the last client …在 GitHub 查看 ↗ -
v0.16.0 Moss iOS SDK v0.16.0
发布说明摘录
Moss iOS SDK v0.16.0. SwiftPM consumption ```swift .package(url: "https://github.com/usemoss/moss", from: "0.16.0"), ``` Package.swift binary target ```swift .binaryTarget( name: "MossC", url: "https://github.com/usemoss/moss/releases/download/v0.16.0/Moss.xcframework.zip", checksum: "054bad915dea8f219bde016f36f69a9559277975e316da7b45403a780918c2ab" ) ``` SHA-256: 054bad915dea8f219bde016f36f69a9559277975e316da7b45403a780918c2ab What's in the zip - Moss.xcframework with the iOS device (arm64) and simulator (arm64) slices …在 GitHub 查看 ↗ -
android-sdk-v0.32.0 Moss Android SDK v0.32.0
发布说明摘录
Moss Android SDK v0.32.0. AAR: moss-android-0.32.0.aar (arm64-v8a, minSdk 24, namespace dev.usemoss.moss). SHA-256: d59042e00235e64ddb311f9afa93adbb9394709e91c215907e72b13965a06278 Added - License. The AAR carries LICENSE.txt, the PolyForm Shield License 1.0.0 terms of the SDK, at META-INF/LICENSE.txt and beside the notices at assets/moss/LICENSE.txt. The release attaches it and its notes name the terms. Changed - A client created after another one in the same app reuses the project's token …在 GitHub 查看 ↗
常见问题
使用 Moss 必须付费吗?
文档数据会离开我的机器吗?
可以在完全没有服务端的环境里使用吗?
它和向量数据库有什么区别?
Moss 官网是什么?
Moss 开源吗?
Moss 安全吗?
Moss 还在维护吗?
Moss 是谁开发的?
谢谢反馈,我们会据此改进页面。