Zikra — командная память для ИИ-агентов

Это не просто память сессии. Это общий, управляемый уровень памяти для каждого агента, каждого человека и каждого проекта, над которым работает ваша команда.

License: MIT MCP

Веб-сайт: zikra.dev · Self-hosted · MIT · Масштабируется до миллионов записей

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

Установка одной командой

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

Или добавьте в ~/.claude/settings.json:

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

У вас еще нет сервера? → Шаг 1 ниже займет около 2 минут.

Большинство инструментов для ИИ-памяти решают одну задачу: один агент лучше запоминает одну сессию.

Zikra решает более сложную задачу: несколько человек, запускающих несколько ИИ-агентов в рамках нескольких проектов — все они используют общий пул памяти, где нужный человек привязан к нужному проекту, нужный агент извлекает нужный контекст, а миллионы воспоминаний остаются актуальными благодаря встроенной системе оценки гигиены данных.

Это не память сессии. Это общий мозг для команды, работающей с ИИ.

Что вы получаете	Что это значит
Мультиагентность	Claude Code, Gemini CLI, Codex — один пул, один токен
Многопользовательский режим	Роли владельца / администратора / разработчика / наблюдателя для каждого проекта
Мультипроектность	Изолированные пространства имен; одна команда ведет `veltisai`, `design`, `global`
Масштабируемость	Бэкенд на PostgreSQL — обрабатывает миллионы записей без перестроения индексов
Гигиена памяти	Встроенный промпт гигиены: затухание уверенности, обнаружение сирот, очистка устаревших данных
Структура	Не просто «сохранить текст» — решения, требования, промпты, ошибки, дневники сессий
Автосохранение	Хуки Stop + PreCompact автоматически записывают каждую сессию

— Mukarram

Сравнение Zikra

	Zikra	MCP Memory¹	mem0	basic-memory	MemoryMesh
Работает с несколькими ИИ-инструментами	✅	❌	✅ платно	❌	❌
Командный доступ с ролями пользователей	✅ RBAC	❌	✅ платно	❌	❌
Пространства имен для нескольких проектов	✅	❌	✅ платно	❌	❌
Self-hosted, без зависимости от облака	✅	✅	❌	✅	✅
Автосохранение через хуки сессий	✅	❌	❌	❌	❌
Гибридный векторный + поиск по словам	✅	❌ только граф	✅	❌	❌
Затухание уверенности / гигиена памяти	✅ встроенный промпт	❌	❌	❌	❌
Именованные промпты + требования	✅	❌	❌	❌	❌
Масштабируется до миллионов записей	✅ Postgres	❌ in-memory	✅ облако	❌	❌
Лицензия	MIT	MIT	Проприетарная	MIT	MIT

¹ @modelcontextprotocol/server-memory — официальный эталонный сервер от Anthropic.

Начало работы

Шаг 1 — Установка сервера

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

Установщик создает файл .env и генерирует ваш токен администратора. По умолчанию сервер привязывается к http://localhost:8000.

Чтобы получить доступ с других машин, запустите cloudflared tunnel --url http://localhost:8000 (бесплатно, дает постоянный публичный URL, например https://zikra.yourteam.com).

Шаг 2 — Включение MCP в Claude Code

Откройте Claude Code → Settings → MCP → Add Server и вставьте:

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

Установщик делает это автоматически при локальном запуске.

Шаг 3 — Подключение вашего ИИ-агента для кодинга

Вставьте промпт для вашего агента в сессию. Он обрабатывает как первую установку, так и обновления.

Claude Code:

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

Это устанавливает хук Stop (автосохранение каждой сессии), хук PreCompact и живую строку состояния, отображающую количество запусков и статистику памяти.

Обновление Zikra

Сервер:

cd ~/zikra && ./update.sh

Хуки Claude Code — перезапустите промпт онбординга. Он обнаружит существующую установку и обновит только то, что изменилось.

Профили

Профиль	Хранилище	Хуки	Доп. зависимости
Webhook (по умолчанию)	SQLite ¹	нет	нет
Auto-log	SQLite ¹	хуки сессий	нет
Full	SQLite ¹ или Postgres	хуки + демон	asyncpg (только Postgres)

¹ SQLite предназначен только для локального использования / одного пользователя. Для развертывания в команде установите DB_BACKEND=postgres.

Переменные окружения

Переменная	Обязательно	По умолчанию	Описание
`ZIKRA_TOKEN`	Да	сгенерировано	Bearer-токен для API
`OPENAI_API_KEY`	Нет	—	Включает семантический поиск. Если отсутствует — только поиск по словам.
`DB_BACKEND`	Нет	`sqlite`	`sqlite` или `postgres`
`DB_HOST`	Только Postgres	`localhost`
`DB_PORT`	Только Postgres	`5432`
`DB_NAME`	Только Postgres	—
`DB_USER`	Только Postgres	—
`DB_PASSWORD`	Только Postgres	—
`ZIKRA_HOST`	Нет	`0.0.0.0`	Адрес привязки
`ZIKRA_PORT`	Нет	`8000`	HTTP-порт
`ZIKRA_DB_PATH`	Нет	`./zikra.db`	Путь к базе данных SQLite
`ZIKRA_PROJECT`	Нет	`main`	Проект по умолчанию
`OPENAI_API_BASE`	Нет	`https://api.openai.com/v1`	Замените на локальный или совместимый эндпоинт эмбеддингов
`ZIKRA_EMBEDDING_MODEL`	Нет	`text-embedding-3-small`	Имя модели эмбеддингов
`ZIKRA_DECAY_DAYS`	Нет	`30`	Период полураспада памяти в днях
`ZIKRA_FREQUENCY_WEIGHT`	Нет	`0.1`	Вес коэффициента частоты доступа

Как ранжируются результаты

Каждый результат поиска проходит через систему оценки:

Возраст — недавние воспоминания имеют более высокий приоритет. Период полураспада: 30 дней. Минимум: 0.05.
Частота доступа — часто используемые промпты поднимаются выше (логарифмическая шкала).
Уверенность — воспоминания, сохраненные с низким confidence_score, ранжируются ниже.

Справочник команд

Все команды выполняются через POST /webhook/zikra с заголовком Authorization: Bearer <token>.

Команда	Алиасы	Описание
`search`	`find`, `query`, `recall`	Гибридный семантический поиск + поиск по словам
`save_memory`	`save`, `store`	Сохранить воспоминание с эмбеддингом
`get_memory`	`fetch_memory`	Получить по заголовку или `id`
`get_prompt`	`fetch_prompt`	Получить именованный промпт
`log_run`	`log_session`	Залогировать завершенный запуск агента
`log_error`	`log_bug`	Залогировать ошибку
`save_requirement`	—	Сохранить требование проекта
`save_prompt`	`write_prompt`	Сохранить промпт с эмбеддингом
`list_prompts`	`get_prompts`	Список промптов для проекта
`list_requirements`	`list_reqs`	Список требований
`promote_requirement`	`promote`	Изменить тип требования
`create_token`	`new_token`	Сгенерировать bearer-токен (роль владельца)
`get_schema`	`schema`	Интроспекция DDL базы данных
`zikra_help`	`help`	Полный справочник команд
`debug_protocol`	—	Диагностика бэкенда

Роли: owner · admin · developer · viewer

Бэкенд PostgreSQL

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

pip install -e ".[postgres]"

Лицензия

MIT — см. LICENSE

Проектируйте в Claude Web. Выполняйте в Claude Code. Делитесь со всей командой. Claude Web · Claude Code · Gemini CLI · Codex · любой агент, поддерживающий POST.

zikra