Zenii (zen-ee-eye)

Comienza en 60 segundos

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'

Ese es el contrato principal: escribe el estado una vez, léelo desde cualquier lugar que hable HTTP.

[!TIP] Documentación interactiva de la API — una vez que el demonio esté en ejecución, abre http://127.0.0.1:18981/api-docs en tu navegador. Obtendrás un explorador completo al estilo Swagger: cada endpoint documentado, pruebas de solicitudes en vivo y generación de fragmentos de código para curl, Python, Go, TypeScript, Rust y más. No se necesita configuración adicional: viene integrado.

Related MCP server: MCP Coding Agents

Por qué Zenii

La mayoría de las herramientas de IA son por sesión y por interfaz. Obtienes memoria en la interfaz de chat pero no en tu script de shell. Conectas una herramienta a un agente y tienes que volver a conectarla al siguiente.

Zenii resuelve esto con un backend local compartido:

Arquitectura

Un crate de biblioteca de Rust (zenii-core) contiene toda la lógica de negocio. Cinco crates binarios ligeros (demonio, CLI, TUI, escritorio, servidor MCP) son envoltorios de shell alrededor de la misma puerta de enlace axum, base de datos SQLite, bucle de agente y registro de herramientas.

Qué se incluye hoy

Interfaces

Capacidades

Karpathy LLM Wiki

Conocimiento compilado en el momento de la ingesta, no re-derivado en cada consulta. Suelta un documento; Zenii extrae, indexa y vincula el conocimiento para que tu agente pueda responder preguntas sobre él al instante.

# 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?"}'

• Soporta PDF, DOCX, PPTX, XLSX e imágenes a través de MarkItDown

• Grafo de conocimiento con visualización dirigida por fuerza en la interfaz web

• Consultable desde cualquier interfaz — CLI, escritorio o bucle de agente

• El auto-lint detecta inconsistencias y lagunas en todas las páginas

Guía completa: docs.zenii.sprklai.com/wiki

MCP: Servidor y Cliente

Como servidor MCP — expón las 19 herramientas de Zenii a cualquier agente:

// .mcp.json — works with Claude Code, Cursor, Gemini CLI, Windsurf, Codex
{
  "mcpServers": {
    "zenii": {
      "command": "zenii-mcp-server",
      "args": ["--transport", "stdio"]
    }
  }
}

Como cliente MCP — Zenii también puede consumir servidores MCP externos. Agrega GitHub, Postgres, Filesystem o cualquier servidor MCP personalizado y sus herramientas estarán disponibles en tu bucle de agente junto con las 19 propias de Zenii.

AGENT.md — una guía legible por máquina escrita para agentes de codificación de IA (Claude Code, Cursor, Gemini CLI, Windsurf, Codex). Suéltala en tu proyecto o apunta tu agente hacia ella para darle un mapa completo de la superficie de la API de Zenii.

Guía completa: docs.zenii.sprklai.com/mcp

Flujos de trabajo y Programador

Flujos de trabajo — encadena herramientas en DAGs con condicionales, bucles y pasos paralelos:

# ~/.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}}" }

Ejecuta manualmente: POST /workflows/daily-digest/run

Programador — activa cualquier prompt o flujo de trabajo en un horario cron, ejecutado como un turno completo de agente con acceso a todas las herramientas:

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"}'

Guía completa: docs.zenii.sprklai.com/workflows · docs.zenii.sprklai.com/scheduler

Instalación

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/sprklai/zenii/main/install.sh | sh

Instala zenii (CLI) y zenii-daemon en ~/.local/bin.

Windows

Descarga y ejecuta el instalador de escritorio (.msi o .exe) desde GitHub Releases.

Para headless / solo CLI, obtén zenii.exe y zenii-daemon.exe desde la misma página.

Cargo

cargo install --git https://github.com/sprklai/zenii zenii zenii-daemon

Notas completas de la plataforma: Instalación y uso

Construir desde el código fuente

Requisitos previos: Rust 1.85+, Bun, bibliotecas de desarrollo de 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

Guía de configuración completa: docs/development.md

Adecuado para

• Automatizaciones locales que necesitan memoria compartida entre scripts, bots y trabajos programados

• Herramientas de desarrollo que desean un único backend de IA accesible a través de HTTP o MCP

• Flujos de trabajo autohospedados donde la privacidad y el control local son importantes

• Proyectos que desean una interfaz de escritorio y un backend programable sin mantener dos pilas

• Autohospedado en un VPS, Raspberry Pi o Docker — se ejecuta como un servicio systemd o contenedor detrás de nginx/Caddy (Guía de despliegue)

Demostración de Zenii PiDog (Raspberry Pi)

Zenii se ejecuta en ARM — mismo binario, misma API. Despliégalo en una Raspberry Pi, conecta herramientas y tu hardware se convierte en un endpoint direccionable por IA a través de HTTP.

No adecuado para

• Despliegues multiusuario o SaaS (demonio de usuario único, sin autenticación multi-inquilino)

• Servidor compatible con OpenAI de reemplazo directo (Zenii tiene su propia superficie de API)

• Aplicaciones móviles (planificado, aún no lanzado)

Documentación

• Sitio web

• Documentación

• Instalación y uso

• Explorador de API interactivo — documentación en vivo al estilo Swagger en localhost:18981/api-docs (el demonio debe estar ejecutándose)

• Referencia de API

• Referencia de CLI

• Configuración

• LLM Wiki

• Arquitectura

• AGENT.md — guía para agentes de codificación de IA

• CHANGELOG.md

• ROADMAP.md

Contribuyendo

Las correcciones de errores tipográficos, pruebas y correcciones de errores enfocadas pueden ir directamente a un PR. El trabajo de funciones más grandes debe comenzar con CONTRIBUTING.md.

Si Zenii te resulta útil — dale una estrella al repositorio y cuéntaselo a un amigo desarrollador.

Licencia

MIT