# OMEGA

**Постоянная память для ИИ-агентов программирования.** Ваш агент запоминает решения, учится на ошибках и продолжает с того места, где остановился.

[![PyPI version](https://img.shields.io/pypi/v/omega-memory.svg)](https://pypi.org/project/omega-memory/)
[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
[![#1 on LongMemEval](https://img.shields.io/badge/LongMemEval-95.4%25_%231_Overall-gold.svg)](https://omegamax.co/benchmarks)

[🇺🇸 English](../README.md) | [🇨🇳 中文](README_zh-CN.md) | [🇯🇵 日本語](README_ja.md) | [🇰🇷 한국어](README_ko.md) | [🇧🇷 Português](README_pt-BR.md) | [🇪🇸 Español](README_es.md) | [🇫🇷 Français](README_fr.md) | [🇩🇪 Deutsch](README_de.md) | [🇷🇺 Русский](README_ru.md)

## Быстрый старт

```bash
pip3 install omega-memory[server]
omega setup
```

Работает с **Claude Code** | **Cursor** | **Windsurf** | **Zed** | любым MCP-клиентом

---

## Почему CLAUDE.md недостаточно?

Встроенный `CLAUDE.md` в Claude Code — обычный текстовый файл. Для пары заметок сойдёт, но он ломается, когда:

- **Нельзя искать.** После 200 строк приходится надеяться на grep. OMEGA использует семантический поиск (эмбеддинги bge-small-en-v1.5 + sqlite-vec), чтобы находить релевантные воспоминания, даже если формулировка отличается.
- **Нет автозахвата.** Каждый урок нужно записывать вручную. OMEGA автоматически распознаёт решения и результаты отладки.
- **Растёт бесконечно.** Нет дедупликации, нет затухания, нет обнаружения противоречий. OMEGA автоматически разрешает конфликты, объединяет семантически похожие записи и снижает значимость устаревших воспоминаний.
- **Один файл на проект.** Нет межпроектного обучения. Граф памяти OMEGA охватывает всю вашу историю разработки.
- **Нет чекпоинтов.** Остановились посреди рефакторинга — нет способа продолжить. OMEGA сохраняет состояние задачи и возобновляет работу точно с места остановки.

CLAUDE.md подходит для записи «всегда используй табы». OMEGA — для случаев, когда вашему агенту нужно по-настоящему учиться.

## Бенчмарк

**1-е место на [LongMemEval](https://github.com/xiaowu0162/LongMemEval)** (ICLR 2025) — академический бенчмарк для систем долговременной памяти. 500 вопросов по извлечению, рассуждению, временному пониманию и отслеживанию предпочтений.

| Система | Результат | Примечание |
|---------|----------:|------------|
| **OMEGA** | **95.4%** | **1-е место** |
| Mastra | 94.87% | 2-е место |
| Zep/Graphiti | 71.2% | -- |

## Основные возможности

- **12 MCP-инструментов** — Сохранение, поиск, запросы, чекпоинт, возобновление и другое.
- **Семантический поиск** — bge-small-en-v1.5 + sqlite-vec для быстрого и точного извлечения.
- **Автозахват и всплытие** — Хуки автоматически распознают решения и показывают релевантные воспоминания во время работы.
- **Чекпоинт и возобновление** — Остановите задачу на полпути, продолжите в следующей сессии.
- **Интеллектуальное забывание** — Временное затухание, разрешение конфликтов, дедупликация.
- **Полностью локально, без API-ключей** — Все данные и обработка остаются на вашей машине.

## Установка

```bash
pip3 install omega-memory[server]   # установить из PyPI (включает MCP-сервер)
omega setup                         # автоматическая настройка редактора
omega doctor                        # проверка работоспособности
```

Используете Cursor, Windsurf или Zed?

```bash
omega setup --client cursor
omega setup --client windsurf
omega setup --client zed
```

## Сравнение

| Возможность | OMEGA | CLAUDE.md | Mem0 |
|-------------|:-----:|:---------:|:----:|
| Сохранение между сессиями | ✅ | ✅ | ✅ |
| Семантический поиск | ✅ | ❌ | ✅ |
| Автозахват | ✅ | ❌ | ✅ |
| Обнаружение противоречий | ✅ | ❌ | ❌ |
| Полностью локально (без API-ключей) | ✅ | ✅ | ❌ |

---

Полная документация — в [README на английском](../README.md).

Сайт: [omegamax.co](https://omegamax.co) | Документация: [omegamax.co/docs](https://omegamax.co/docs) | Бенчмарки: [omegamax.co/benchmarks](https://omegamax.co/benchmarks)

## Лицензия

Apache-2.0
