Skip to main content
Glama

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 包装器。


当前功能

接口

二进制文件

用途

zenii-daemon

本地 HTTP + WebSocket API 服务器 — 一切的核心

zenii

快速提示、shell 管道、终端工作流

zenii-tui

交互式终端 UI

zenii-desktop

原生 Tauri 桌面应用

zenii-mcp-server

将所有 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.exezenii-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 表面)

  • 移动应用(计划中,尚未发布)


文档


贡献

错别字修复、测试和针对性的错误修复可以直接提交 PR。 较大的功能开发应从 CONTRIBUTING.md 开始。

如果 Zenii 对你有帮助 — 给仓库加星 并告诉你的开发者朋友。

许可证

MIT

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    A 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.
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    A 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 npm
    1
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    A model-agnostic MCP server exposing example tools (add1, multiply2, greet) for learning purposes, working with any LLM through stdio transport.
    -
  • A
    license
    Not graded
    quality
    B
    maintenance
    A local MCP server that gives AI agents access to developer tooling — GitHub (read-only), documentation search, and web research — via stdio transport.
    MIT