Zikra — Memoria de equipo para agentes de IA

No es solo memoria de sesión. Es una capa de memoria compartida y gobernada para cada agente, cada persona y cada proyecto que ejecute tu equipo.

License: MIT MCP

Sitio web: zikra.dev · Autohospedado · MIT · Escala a millones de recuerdos

zikra 17 runs · 847 memories │ you@team-server │ Sonnet 4.6 │ ~/project (main) │ 387K/200K ████░░░░░░ 45%

Instalar en una línea

claude mcp add zikra http://localhost:8000/mcp --header "Authorization: Bearer YOUR_TOKEN"

O añádelo a ~/.claude/settings.json:

{ "mcpServers": { "zikra": { "url": "http://localhost:8000/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } }

¿Aún no tienes un servidor? → El paso 1 a continuación toma unos 2 minutos.

La mayoría de las herramientas de memoria para IA resuelven un problema: que un agente recuerde mejor una sesión.

Zikra resuelve un problema más difícil: varias personas ejecutando varios agentes de IA en varios proyectos, todos compartiendo el mismo grupo de memoria, con la persona adecuada asignada al proyecto adecuado, el agente adecuado extrayendo el contexto adecuado y millones de recuerdos manteniéndose frescos mediante una puntuación de higiene integrada.

No es memoria de sesión. Es el cerebro compartido para un equipo nativo de IA.

Qué obtienes	Qué significa
Multiagente	Claude Code, Gemini CLI, Codex: un grupo, un token
Multipersona	Roles de propietario / administrador / desarrollador / visor por proyecto
Multiproyecto	Espacios de nombres aislados; un equipo ejecuta `veltisai`, `design`, `global`
Escala	Backend de PostgreSQL: maneja millones de recuerdos sin reconstruir índices
Higiene de memoria	Prompt de higiene integrado: decaimiento de confianza, detección de huérfanos, limpieza de obsoletos
Estructura	No solo "guardar texto": decisiones, requisitos, prompts, errores, diarios de sesión
Guardado automático	Los ganchos (hooks) de Stop + PreCompact escriben cada sesión automáticamente

— Mukarram

Cómo se compara Zikra

	Zikra	Memoria MCP¹	mem0	basic-memory	MemoryMesh
Funciona en varias herramientas de IA	✅	❌	✅ pago	❌	❌
Compartición en equipo con roles por usuario	✅ RBAC	❌	✅ pago	❌	❌
Espacios de nombres multiproyecto	✅	❌	✅ pago	❌	❌
Autohospedado, sin dependencia de la nube	✅	✅	❌	✅	✅
Guardado automático mediante ganchos de sesión	✅	❌	❌	❌	❌
Búsqueda híbrida de vectores + palabras clave	✅	❌ solo grafo	✅	❌	❌
Decaimiento de confianza / higiene de memoria	✅ prompt integrado	❌	❌	❌	❌
Prompts con nombre + requisitos	✅	❌	❌	❌	❌
Escala a millones de recuerdos	✅ Postgres	❌ en memoria	✅ nube	❌	❌
Licencia	MIT	MIT	Propietaria	MIT	MIT

¹ @modelcontextprotocol/server-memory: el servidor de referencia oficial de Anthropic.

Primeros pasos

Paso 1 — Instalar el servidor

git clone https://github.com/getzikra/zikra
cd zikra
python3 -m venv .venv
source .venv/bin/activate    # Windows: .venv\Scripts\activate
pip install -e .
python3 installer.py         # interactive setup, ~2 minutes
python3 -m zikra

El instalador crea un archivo .env y genera tu token de administrador. El servidor se vincula a http://localhost:8000 por defecto.

Para acceder desde otras máquinas, ejecuta cloudflared tunnel --url http://localhost:8000 (gratuito, te da una URL pública permanente como https://zikra.yourteam.com).

Paso 2 — Habilitar MCP en Claude Code

Abre Claude Code → Settings → MCP → Add Server y pega:

{
  "mcpServers": {
    "zikra": {
      "url": "http://your-server:8000/mcp",
      "headers": { "Authorization": "Bearer YOUR_ZIKRA_TOKEN" }
    }
  }
}

El instalador hace esto automáticamente cuando se ejecuta localmente.

Paso 3 — Conectar tu agente de codificación de IA

Pega el prompt para tu agente en una sesión. Maneja tanto la primera instalación como las actualizaciones.

Claude Code:

Fetch https://raw.githubusercontent.com/GetZikra/zikra/main/prompts/zikra-claude-code-setup.md
and follow every instruction in it.

Esto instala el gancho de parada (Stop hook) (guarda automáticamente cada sesión), el gancho PreCompact y la barra de estado en vivo que muestra los recuentos de ejecución y las estadísticas de memoria.

Actualizar Zikra

Servidor:

cd ~/zikra && ./update.sh

Ganchos de Claude Code: vuelve a ejecutar el prompt de incorporación. Detecta tu instalación existente y solo actualiza lo que ha cambiado.

Perfiles

Perfil	Almacenamiento	Ganchos	Dependencias extra
Webhook (predeterminado)	SQLite ¹	ninguno	ninguno
Auto-log	SQLite ¹	ganchos de sesión	ninguno
Full	SQLite ¹ o Postgres	ganchos + demonio	asyncpg (solo Postgres)

¹ SQLite es solo para uso local / monousuario. Para implementaciones en equipo, establece DB_BACKEND=postgres.

Variables de entorno

Variable	Requerido	Predeterminado	Descripción
`ZIKRA_TOKEN`	Sí	generado	Token de portador (Bearer) para la API
`OPENAI_API_KEY`	No	—	Habilita la búsqueda semántica. Solo palabras clave si está ausente.
`DB_BACKEND`	No	`sqlite`	`sqlite` o `postgres`
`DB_HOST`	Solo Postgres	`localhost`
`DB_PORT`	Solo Postgres	`5432`
`DB_NAME`	Solo Postgres	—
`DB_USER`	Solo Postgres	—
`DB_PASSWORD`	Solo Postgres	—
`ZIKRA_HOST`	No	`0.0.0.0`	Dirección de enlace
`ZIKRA_PORT`	No	`8000`	Puerto HTTP
`ZIKRA_DB_PATH`	No	`./zikra.db`	Ruta de la base de datos SQLite
`ZIKRA_PROJECT`	No	`main`	Proyecto predeterminado
`OPENAI_API_BASE`	No	`https://api.openai.com/v1`	Cambiar por un endpoint de incrustación local o compatible
`ZIKRA_EMBEDDING_MODEL`	No	`text-embedding-3-small`	Nombre del modelo de incrustación
`ZIKRA_DECAY_DAYS`	No	`30`	Vida media de la memoria en días
`ZIKRA_FREQUENCY_WEIGHT`	No	`0.1`	Peso de impulso de frecuencia de acceso

Cómo se clasifican los resultados

Cada resultado de búsqueda pasa por una puntuación:

Antigüedad: los recuerdos recientes tienen una clasificación más alta. Vida media: 30 días. Mínimo: 0.05.
Frecuencia de acceso: los prompts utilizados con frecuencia aparecen más arriba (escala logarítmica).
Confianza: los recuerdos guardados con una confidence_score más baja tienen una clasificación más baja.

Referencia de comandos

Todos los comandos son POST /webhook/zikra con Authorization: Bearer <token>.

Comando	Alias	Descripción
`search`	`find`, `query`, `recall`	Búsqueda híbrida semántica + palabras clave
`save_memory`	`save`, `store`	Guardar un recuerdo con incrustación
`get_memory`	`fetch_memory`	Recuperar por título o `id`
`get_prompt`	`fetch_prompt`	Recuperar un prompt con nombre
`log_run`	`log_session`	Registrar una ejecución de agente completada
`log_error`	`log_bug`	Registrar un error
`save_requirement`	—	Guardar un requisito del proyecto
`save_prompt`	`write_prompt`	Guardar un prompt con incrustación
`list_prompts`	`get_prompts`	Listar prompts para un proyecto
`list_requirements`	`list_reqs`	Listar requisitos
`promote_requirement`	`promote`	Cambiar el tipo de un requisito
`create_token`	`new_token`	Generar un token de portador (rol de propietario)
`get_schema`	`schema`	Introspección DDL de BD
`zikra_help`	`help`	Referencia completa de comandos
`debug_protocol`	—	Diagnóstico del backend

Roles: owner · admin · developer · viewer

Backend de PostgreSQL

DB_BACKEND=postgres
DB_HOST=localhost
DB_PORT=5432
DB_NAME=ai_zikra
DB_USER=postgres
DB_PASSWORD=yourpassword

pip install -e ".[postgres]"

Licencia

MIT: ver LICENSE

Diseña en Claude Web. Ejecuta en Claude Code. Comparte con todo tu equipo. Claude Web · Claude Code · Gemini CLI · Codex · cualquier agente que pueda hacer POST.

zikra