Sistema de memoria de IA local-first que almacena el historial de conversaciones íntegro y lo recupera mediante búsqueda semántica, disponible como servidor MCP y CLI.
OSU-NLP-Group/HippoRAG
Un framework RAG para LLMs que crea un grafo de conocimiento a partir de documentos y usa Personalized PageRank para la recuperación multi-hop y la memoria a largo plazo.
- Estrellas
- 4,076
- Forks
- 440
- Issues abiertos
- 8
- Último commit
- hace 16 días
¿Qué es?
HippoRAG es un framework de memoria para LLMs inspirado en la estructura asociativa de la memoria humana a largo plazo. Extrae entidades y hechos de los documentos y los incorpora a un grafo de conocimiento; luego usa Personalized PageRank sobre ese grafo para recuperar pasajes relacionados con una consulta, lo que ayuda a responder preguntas que requieren combinar información de varios documentos.
El proyecto ofrece un paquete de Python con flujos de trabajo de indexación, recuperación y rag_qa. Funciona con OpenAI, Azure OpenAI, endpoints compatibles con OpenAI como vLLM, Amazon Bedrock y modelos locales a través de Transformers o vLLM. El almacenamiento vectorial puede hacerse en archivos Parquet locales o con Qdrant, ChromaDB o Milvus. Los índices están vinculados a la configuración del modelo con la que se crearon, por lo que cambiar de modelo requiere volver a indexar.
HippoRAG también incluye un servidor MCP (hipporag-mcp) que proporciona las herramientas retrieve, rag_qa, index y delete a agentes como Claude Code y Cursor, además de un plugin para Claude Code. Incluye scripts de reproducción y conjuntos de datos para los artículos de NeurIPS 2024 e ICML 2025.
Funciones clave
- 01Crea un grafo de conocimiento a partir de documentos y recupera información con Personalized PageRank.
- 02Es compatible con OpenAI, Azure OpenAI, Bedrock y endpoints compatibles con OpenAI, como vLLM.
- 03Ejecuta modelos locales de embeddings y LLM a través de Transformers o vLLM.
- 04Almacena vectores en archivos Parquet locales o en Qdrant, ChromaDB o Milvus.
- 05Ofrece un servidor MCP con las herramientas retrieve, rag_qa, index y delete.
- 06Incluye un plugin para Claude Code y scripts para reproducir los experimentos de los artículos.
Casos de uso
- Responder preguntas sobre una colección de documentos cuando es necesario relacionar hechos de varios pasajes.
- Proporcionar a un agente de programación o chat con IA una memoria persistente y actualizada progresivamente sobre un conjunto de documentos a través de MCP.
- Ejecutar un pipeline RAG con modelos abiertos autoalojados mediante vLLM y mantener los datos en local.
- Reproducir o ampliar experimentos de recuperación multi-hop de los artículos sobre HippoRAG.
Inicio rápido
- 1
Crea un entorno Python 3.10 con Conda
conda create -n hipporag python=3.10 - 2
Activa el entorno
conda activate hipporag - 3
Instala HippoRAG desde PyPI
pip install hipporag - 4
Configura tu clave de API de OpenAI y ejecuta el ejemplo mínimo del README
export OPENAI_API_KEY=<your OpenAI API key>
Antes de usarlo
- El uso de modelos locales requiere recursos de GPU considerables, como un servicio vLLM con varias GPU para modelos grandes.
- Para actualizar a la versión 2.0.0a5 los índices creados con los valores predeterminados de desarrollo anteriores, es necesario volver a indexarlos.
Temas
Preguntas frecuentes
- ¿Qué es HippoRAG?
- Un framework RAG para LLMs que crea un grafo de conocimiento a partir de documentos y usa Personalized PageRank para la recuperación multi-hop y la memoria a largo plazo. HippoRAG es un framework de memoria para LLMs inspirado en la estructura asociativa de la memoria humana a largo plazo. Extrae entidades y hechos de los documentos y los incorpora a un grafo de conocimiento; luego usa Personalized PageRank sobre ese grafo para recuperar pasajes relacionados con una consulta, lo que ayuda a responder preguntas que requieren combinar información de varios documentos.
- ¿HippoRAG es gratuito? ¿Qué licencia tiene?
- HippoRAG es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿HippoRAG sigue mantenido?
- Mantenimiento activo. El último commit de HippoRAG fue el 6 oct 2026.
- ¿Para qué puedo usar HippoRAG?
- Responder preguntas sobre una colección de documentos cuando es necesario relacionar hechos de varios pasajes. Proporcionar a un agente de programación o chat con IA una memoria persistente y actualizada progresivamente sobre un conjunto de documentos a través de MCP. Ejecutar un pipeline RAG con modelos abiertos autoalojados mediante vLLM y mantener los datos en local. Reproducir o ampliar experimentos de recuperación multi-hop de los artículos sobre HippoRAG.
- ¿Cómo se instala HippoRAG?
- Crea un entorno Python 3.10 con Conda: conda create -n hipporag python=3.10 Activa el entorno: conda activate hipporag Instala HippoRAG desde PyPI: pip install hipporag Configura tu clave de API de OpenAI y ejecuta el ejemplo mínimo del README: export OPENAI_API_KEY=<your OpenAI API key>
- ¿Dónde consigo HippoRAG?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/OSU-NLP-Group/HippoRAG
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Pipeline de datos en Python que usa LLMs para extraer grafos de conocimiento estructurados de texto no estructurado y responder preguntas con generación aumentada por recuperación.
Plataforma de memoria de IA de código abierto que convierte documentos, código y conversaciones en un grafo de conocimiento autohospedado para agentes de IA.
Framework de Python para crear grafos de conocimiento temporal que registran cómo cambian los hechos y sirven de memoria y contexto para agentes de IA.
Framework y servidor ligero de RAG con grafos de conocimiento que indexa documentos como entidades y relaciones para generar respuestas de LLM con recuperación aumentada.
Una capa de memoria a largo plazo de código abierto para agentes de IA que almacena y recupera información entre sesiones mediante un SDK de Python, una API REST y un servidor MCP.