sprklai/zenii
Zenii (zen-ee-eye)
60 秒快速上手
curl -fsSL https://raw.githubusercontent.com/sprklai/zenii/main/install.sh | bash
zenii-daemon &
# Store a fact once
curl -s -X POST http://localhost:18981/memory \
-H "Content-Type: application/json" \
-d '{"key":"deploy","content":"Production database is on port 5434"}' >/dev/null
# Ask about it later — from a script, cron job, or another machine
curl -s -X POST http://localhost:18981/chat \
-H "Content-Type: application/json" \
-d '{"session_id":"ops","prompt":"What port is the production database on?"}' | jq -r '.response'这是核心契约:编写一次状态,从任何支持 HTTP 的地方读取它。
[!TIP] 交互式 API 文档 — 守护进程运行后,在浏览器中打开 http://127.0.0.1:18981/api-docs 。你将获得一个完整的 Swagger 风格浏览器:每个端点都有文档记录、实时请求测试,并可为 curl、Python、Go、TypeScript、Rust 等生成代码片段。 无需单独设置 — 它已内置。
Related MCP server: MCP Coding Agents
为什么选择 Zenii
大多数 AI 工具是按会话和按接口划分的。你在聊天 UI 中拥有内存,但在 shell 脚本中却没有。你为一个代理连接了一个工具,却必须为下一个代理重新连接它。
Zenii 通过共享本地后端解决了这个问题:
没有 Zenii | 使用 Zenii |
每个脚本管理自己的 AI 上下文 | 一个守护进程为所有脚本保存内存 |
每个项目重复实现工具 | 19 个工具注册一次,随处可用 |
提供商 API 密钥分散在各处配置中 | 一个凭据存储,一处即可轮换 |
桌面 UI 和脚本逐渐脱节 | 两者调用同一个网关 |
MCP 工具仅在 IDE 内可用 | 将相同的工具暴露给任何 MCP 客户端 |
架构
一个 Rust 库 crate (zenii-core) 包含所有业务逻辑。五个轻量级二进制 crate(守护进程、CLI、TUI、桌面端、MCP 服务器)是围绕同一个 axum 网关、SQLite 数据库、代理循环和工具注册表的 shell 包装器。
当前功能
接口
二进制文件 | 用途 |
| 本地 HTTP + WebSocket API 服务器 — 一切的核心 |
| 快速提示、shell 管道、终端工作流 |
| 交互式终端 UI |
| 原生 Tauri 桌面应用 |
| 将所有 19 个 Zenii 工具暴露给 Claude Code、Cursor、VS Code |
能力
领域 | 功能 |
内存 | 持久化语义回溯 — BM25 字段加权、时间衰减、向量去重 |
Karpathy LLM Wiki | 摄取 PDF、DOCX、PPTX、XLSX、图像 — 知识图谱、AI 查询、自动检查 |
AI 代理 | 多步推理、工具使用、流式传输、带人工审批的委派 |
工具 (19) | Shell、文件操作、网络搜索、进程控制、补丁、内存、Wiki — 一个注册表,适配所有接口 |
提供商 (6+) | OpenAI · Anthropic · Gemini · OpenRouter · Vercel AI Gateway · Ollama · 任何兼容 OpenAI 的端点 |
工作流 | TOML/YAML DAG 链 — 工具、条件判断、循环、并行步骤、运行历史、取消 |
调度器 | Cron + 间隔任务,每次运行作为一个完整的代理轮次,可访问所有工具 |
频道 | Telegram · Discord · Slack — 入站路由、统一收件箱、线程化对话(功能受限) |
MCP | 服务器:向 Claude Code、Cursor、Gemini CLI、Windsurf 暴露所有工具 · 客户端:消费外部 MCP 服务器 |
安全 | 操作系统密钥环 · AES-256-GCM 加密 · 基于表面的权限模型 (CLI/桌面/TUI/MCP/API) |
Karpathy LLM Wiki
知识在摄取时编译,而不是在每次查询时重新推导。放入文档;Zenii 会提取、索引并链接知识,以便你的代理可以立即针对它回答问题。
# Ingest a runbook, spec, or doc
curl -s -X POST http://localhost:18981/wiki/ingest \
-H "Authorization: Bearer $ZENII_TOKEN" \
-d '{"url": "https://example.com/runbook.pdf"}'
# Query it — answers come from the compiled knowledge base
curl -s -X POST http://localhost:18981/wiki/query \
-H "Authorization: Bearer $ZENII_TOKEN" \
-d '{"query": "What does section 3 say about rollback?"}'通过 MarkItDown 支持 PDF、DOCX、PPTX、XLSX 和图像
在 Web UI 中具有力导向可视化的知识图谱
可从任何接口查询 — CLI、桌面或代理循环
自动检查可检测页面间的不一致和缺失
完整指南:docs.zenii.sprklai.com/wiki
MCP:服务器和客户端
作为 MCP 服务器 — 向任何代理暴露所有 19 个 Zenii 工具:
// .mcp.json — works with Claude Code, Cursor, Gemini CLI, Windsurf, Codex
{
"mcpServers": {
"zenii": {
"command": "zenii-mcp-server",
"args": ["--transport", "stdio"]
}
}
}作为 MCP 客户端 — Zenii 也可以消费外部 MCP 服务器。添加 GitHub、Postgres、文件系统或任何自定义 MCP 服务器,其工具将与 Zenii 自己的 19 个工具一起在你的代理循环中可用。
AGENT.md — 一份为 AI 编码代理(Claude Code、Cursor、Gemini CLI、Windsurf、Codex)编写的机器可读指南。将其放入你的项目或将你的代理指向它,即可为其提供 Zenii API 表面的完整地图。
完整指南:docs.zenii.sprklai.com/mcp
工作流和调度器
工作流 — 将工具链接成带有条件、循环和并行步骤的 DAG:
# ~/.config/zenii/workflows/daily-digest.yml
name: daily-digest
steps:
- id: search
tool: web_search
args: { query: "Rust ecosystem news today" }
- id: store
tool: memory_store
args: { key: "digest/{{date}}", content: "{{steps.search.result}}" }手动运行:POST /workflows/daily-digest/run
调度器 — 按 cron 计划触发任何提示或工作流,作为具有所有工具访问权限的完整代理轮次执行:
curl -s -X POST http://localhost:18981/scheduler/jobs \
-H "Authorization: Bearer $ZENII_TOKEN" \
-d '{"name":"daily-digest","cron":"0 8 * * *","prompt":"Run the daily-digest workflow"}'完整指南:docs.zenii.sprklai.com/workflows · docs.zenii.sprklai.com/scheduler
安装
macOS / Linux
curl -fsSL https://raw.githubusercontent.com/sprklai/zenii/main/install.sh | sh将 zenii (CLI) 和 zenii-daemon 安装到 ~/.local/bin。
Windows
从 GitHub Releases 下载并运行桌面安装程序 (.msi 或 .exe)。
对于无头/仅 CLI 环境,从同一页面获取 zenii.exe 和 zenii-daemon.exe。
Cargo
cargo install --git https://github.com/sprklai/zenii zenii zenii-daemon完整平台说明:安装与使用
从源码构建
先决条件:Rust 1.85+、Bun、SQLite 开发库。
git clone https://github.com/sprklai/zenii.git
cd zenii
cargo build --release -p zenii-daemon # headless server
cargo build --release -p zenii-cli # CLI client
cd crates/zenii-desktop && cargo tauri build # desktop app完整设置指南:docs/development.md
适用场景
需要在脚本、机器人和定时任务之间共享内存的本地自动化
希望通过 HTTP 或 MCP 访问单个 AI 后端的开发者工具
注重隐私和本地控制的自托管工作流
希望拥有桌面 UI 和可脚本化后端而无需维护两套技术栈的项目
自托管在 VPS、树莓派或 Docker 上 — 作为 systemd 服务或 nginx/Caddy 后面的容器运行 (部署指南)
Zenii PiDog (树莓派) 演示
Zenii 在 ARM 上运行 — 相同的二进制文件,相同的 API。将其部署在树莓派上,连接工具,你的硬件就成为了一个可以通过 HTTP 进行 AI 寻址的端点。
不适用场景
多用户或 SaaS 部署(单用户守护进程,无多租户身份验证)
直接替换 OpenAI 兼容服务器(Zenii 有自己的 API 表面)
移动应用(计划中,尚未发布)
文档
交互式 API 浏览器 — 位于
localhost:18981/api-docs的实时 Swagger 风格文档(守护进程必须正在运行)AGENT.md — AI 编码代理指南
贡献
错别字修复、测试和针对性的错误修复可以直接提交 PR。 较大的功能开发应从 CONTRIBUTING.md 开始。
如果 Zenii 对你有帮助 — 给仓库加星 并告诉你的开发者朋友。
许可证
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Open-source Zapier/n8n alternative as an MCP server: agents build, run and debug your workflows.
- ZapierOAuthcom.zapier
Hosted MCP server connecting AI assistants to 9,000+ apps and 40,000+ actions via Zapier.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA dual-transport MCP server that exposes your API as tools to LLM clients, supporting both stdio transport for local clients like Claude Desktop and HTTP/SSE transport for remote clients like OpenAI's Responses API.-
- AlicenseNot gradedqualityDmaintenanceA transport-agnostic MCP server that integrates multiple AI coding agents (Claude Code, Gemini, and Codex) with built-in tools for command execution, calculations, and streaming capabilities. Supports both STDIO and HTTP transports for flexible deployment.2 npm1MIT
- FlicenseNot gradedqualityCmaintenanceA model-agnostic MCP server exposing example tools (add1, multiply2, greet) for learning purposes, working with any LLM through stdio transport.-
- AlicenseNot gradedqualityBmaintenanceA local MCP server that gives AI agents access to developer tooling — GitHub (read-only), documentation search, and web research — via stdio transport.MIT