Конвейер обработки данных на Python, который использует LLM для извлечения структурированных графов знаний из неструктурированного текста и ответов на вопросы с помощью RAG.
OSU-NLP-Group/HippoRAG
RAG-фреймворк для LLM: строит граф знаний по документам и использует Personalized PageRank для многошагового поиска и долговременной памяти.
- Звёзды
- 4,076
- Форки
- 440
- Открытые issues
- 8
- Последний коммит
- 16 дней назад
Что это?
HippoRAG — фреймворк памяти для LLM, вдохновлённый ассоциативной структурой долговременной памяти человека. Он извлекает из документов сущности и факты и формирует из них граф знаний, а затем использует Personalized PageRank по этому графу, чтобы находить фрагменты, связанные с запросом. Это помогает отвечать на вопросы, для которых нужно объединить информацию из нескольких документов.
В проект входит Python-пакет с процессом работы index, retrieve и rag_qa. Он поддерживает OpenAI, Azure OpenAI, совместимые с OpenAI конечные точки, например vLLM, Amazon Bedrock, а также локальные модели через Transformers или vLLM. Векторы можно хранить в локальных файлах Parquet или в Qdrant, ChromaDB и Milvus. Индексы привязаны к конфигурации модели, с помощью которой они были созданы, поэтому при смене модели индекс нужно построить заново.
В HippoRAG также входит MCP-сервер hipporag-mcp, который предоставляет агентам, например Claude Code и Cursor, инструменты retrieve, rag_qa, index и delete, а также плагин для Claude Code. В комплект включены скрипты для воспроизведения экспериментов и наборы данных из статей для NeurIPS 2024 и ICML 2025.
Ключевые возможности
- 01Строит граф знаний по документам и выполняет поиск с помощью Personalized PageRank.
- 02Поддерживает OpenAI, Azure OpenAI, Bedrock и совместимые с OpenAI конечные точки, например vLLM.
- 03Запускает локальные модели эмбеддингов и LLM через Transformers или vLLM.
- 04Хранит векторы в локальных файлах Parquet или в Qdrant, ChromaDB и Milvus.
- 05Предоставляет MCP-сервер с инструментами retrieve, rag_qa, index и delete.
- 06Включает плагин для Claude Code и скрипты для воспроизведения экспериментов из статей.
Сценарии использования
- Ответы на вопросы по коллекции документов, когда нужно связать факты из нескольких фрагментов.
- Предоставление AI-агенту для программирования или общения долговременной памяти о наборе документов с возможностью постепенно обновлять её через MCP.
- Запуск RAG-процесса на самостоятельно размещённых моделях с открытым исходным кодом через vLLM, сохраняя данные локально.
- Воспроизведение экспериментов по многошаговому поиску из статей о HippoRAG или развитие этих исследований.
Быстрый старт
- 1
Создайте окружение Python 3.10 с помощью Conda
conda create -n hipporag python=3.10 - 2
Активируйте окружение
conda activate hipporag - 3
Установите HippoRAG из PyPI
pip install hipporag - 4
Укажите ключ API OpenAI и запустите минимальный пример из README
export OPENAI_API_KEY=<your OpenAI API key>
Что важно знать
- Для использования локальных моделей требуются значительные ресурсы GPU, например обслуживание крупных моделей с помощью vLLM на нескольких GPU.
- Чтобы обновить до версии 2.0.0a5 индексы, созданные с прежними настройками разработки по умолчанию, их нужно перестроить.
Темы
Частые вопросы
- Что такое HippoRAG?
- RAG-фреймворк для LLM: строит граф знаний по документам и использует Personalized PageRank для многошагового поиска и долговременной памяти. HippoRAG — фреймворк памяти для LLM, вдохновлённый ассоциативной структурой долговременной памяти человека. Он извлекает из документов сущности и факты и формирует из них граф знаний, а затем использует Personalized PageRank по этому графу, чтобы находить фрагменты, связанные с запросом. Это помогает отвечать на вопросы, для которых нужно объединить информацию из нескольких документов.
- HippoRAG можно использовать бесплатно? Какая у него лицензия?
- HippoRAG распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
- HippoRAG всё ещё поддерживается?
- Активно поддерживается. Последний коммит в HippoRAG — 6 окт. 2026 г..
- Для чего можно использовать HippoRAG?
- Ответы на вопросы по коллекции документов, когда нужно связать факты из нескольких фрагментов. Предоставление AI-агенту для программирования или общения долговременной памяти о наборе документов с возможностью постепенно обновлять её через MCP. Запуск RAG-процесса на самостоятельно размещённых моделях с открытым исходным кодом через vLLM, сохраняя данные локально. Воспроизведение экспериментов по многошаговому поиску из статей о HippoRAG или развитие этих исследований.
- Как установить HippoRAG?
- Создайте окружение Python 3.10 с помощью Conda: conda create -n hipporag python=3.10 Активируйте окружение: conda activate hipporag Установите HippoRAG из PyPI: pip install hipporag Укажите ключ API OpenAI и запустите минимальный пример из README: export OPENAI_API_KEY=<your OpenAI API key>
- Где скачать HippoRAG?
- Исходный код и инструкции по установке — на GitHub: https://github.com/OSU-NLP-Group/HippoRAG
Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.
Похожие проекты
Локальная AI-система памяти: хранит историю диалогов без изменений и находит нужное с помощью семантического поиска; доступна как MCP-сервер и CLI.
Open-source платформа памяти для AI, которая превращает документы, код и диалоги в локально размещённый граф знаний для AI-агентов.
Плагин долгосрочной памяти для агентов OpenClaw: хранит предпочтения и решения в LanceDB и извлекает их в следующих сессиях.
Python-фреймворк для построения временных графов знаний, отслеживающих изменения фактов, — память и контекст для AI-агентов.
Лёгкий фреймворк и сервер для RAG на основе графа знаний: индексирует документы, выделяя сущности и связи, чтобы LLM могла формировать ответы с дополненной генерацией.