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ではメモリが使えても、シェルスクリプトでは使えません。あるエージェントにツールを接続しても、次のエージェントには再接続する必要があります。

Zeniiは、共有ローカルバックエンドによってこれを解決します：

アーキテクチャ

一つのRustライブラリクレート（zenii-core）がすべてのビジネスロジックを保持します。5つの軽量なバイナリクレート（デーモン、CLI、TUI、デスクトップ、MCPサーバー）は、同じaxumゲートウェイ、SQLiteデータベース、エージェントループ、ツールレジストリをラップするシェルです。

現在提供されている機能

インターフェース

機能

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、Filesystem、または任意のカスタム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バックエンドを求める開発者ツール

• プライバシーとローカル制御が重要なセルフホストワークフロー

• 2つのスタックを維持せずにデスクトップUIとスクリプト可能なバックエンドを両立させたいプロジェクト

• VPS、Raspberry Pi、Dockerでのセルフホスト — systemdサービスとして、またはnginx/Caddyの背後でコンテナとして実行 (デプロイガイド)

Zenii PiDog (Raspberry Pi) デモ

ZeniiはARM上で動作します — 同じバイナリ、同じAPIです。Raspberry Piにデプロイしてツールを接続すれば、ハードウェアがHTTP経由でAIが操作可能なエンドポイントになります。

適さない用途

• マルチユーザーまたはSaaSデプロイメント（シングルユーザーデーモンであり、マルチテナント認証はありません）

• OpenAI互換サーバーのドロップイン置換（Zeniiは独自のAPIサーフェスを持っています）

• モバイルアプリ（計画中ですが、未リリースです）

ドキュメント

• Webサイト

• ドキュメント

• インストールと使用方法

• インタラクティブAPIエクスプローラー — localhost:18981/api-docs でSwaggerスタイルのライブドキュメント（デーモン実行中のみ）

• APIリファレンス

• CLIリファレンス

• 設定

• LLM Wiki

• アーキテクチャ

• AGENT.md — AIコーディングエージェント向けガイド

• CHANGELOG.md

• ROADMAP.md

貢献

誤字の修正、テスト、特定のバグ修正は直接PRを送ってください。 大規模な機能追加は CONTRIBUTING.md から始めてください。

Zeniiが役に立った場合は、リポジトリにスターを付け、開発者の友人に教えてあげてください。

ライセンス

MIT