Tutorial y proyecto modular de Agentic RAG con LangGraph, con indexación jerárquica, memoria conversacional y aclaración de consultas.
langchain-ai/local-deep-researcher
Asistente de investigación web completamente local que ejecuta ciclos iterativos de búsqueda, resumen y reflexión sobre lagunas de conocimiento con LLM servidos por Ollama o LM Studio.
- Estrellas
- 9,378
- Forks
- 981
- Issues abiertos
- 47
- Último commit
- hace 5 días
¿Qué es?
Local Deep Researcher recibe un tema de investigación, usa un LLM local para generar una consulta de búsqueda web, recopila resultados y los resume. Después, analiza el resumen para identificar lagunas de conocimiento, genera una consulta de seguimiento para cubrirlas y repite el proceso durante un número configurable de ciclos. El resultado final es un informe en markdown con las fuentes utilizadas, que se conservan en el estado de LangGraph.
El asistente ejecuta LLM a través de Ollama o del servidor compatible con OpenAI de LM Studio, de modo que los modelos permanecen en tu equipo. La búsqueda usa DuckDuckGo de forma predeterminada, sin necesidad de una API key, y se puede cambiar a SearXNG, Tavily o Perplexity mediante variables de entorno. Para los modelos que tienen dificultades con la salida JSON estructurada, hay un mecanismo alternativo.
El proyecto está basado en LangGraph y puedes ejecutarlo localmente con LangGraph Studio, que muestra cada paso del proceso de investigación. Incluye un Dockerfile, aunque Ollama debe ejecutarse por separado.
Funciones clave
- 01Ejecuta LLM localmente a través de Ollama o LM Studio.
- 02Busca, resume y reflexiona de forma iterativa para cubrir lagunas de conocimiento.
- 03Usa DuckDuckGo de forma predeterminada, con búsqueda opcional mediante SearXNG, Tavily o Perplexity.
- 04Genera un resumen en markdown con citas de todas las fuentes utilizadas.
- 05Permite configurar el número de ciclos de investigación y la obtención del contenido completo de las páginas.
Casos de uso
- Investigar un tema y mantener los prompts y los datos en tu propio equipo.
- Crear prototipos de un agente de búsqueda y resumen de varios pasos con LangGraph.
- Generar informes de contexto con citas sin necesitar una API key de búsqueda de pago.
Inicio rápido
- 1
Clona el repositorio
git clone https://github.com/langchain-ai/local-deep-researcher.git - 2
Entra en el directorio del proyecto y copia el archivo de entorno de ejemplo
cd local-deep-researcher && cp .env.example .env - 3
Descarga un modelo local con Ollama (instala primero la aplicación de Ollama)
ollama pull deepseek-r1:8b - 4
Inicia el servidor de LangGraph con uv
uvx --refresh --from "langgraph-cli[inmem]" --with-editable . --python 3.11 langgraph dev
Antes de usarlo
- Las instrucciones de configuración del README están dirigidas principalmente a Mac y Windows; la guía de Ollama se centra específicamente en Mac.
- La calidad de los resultados depende del modelo local; algunos modelos tienen dificultades para generar la salida JSON estructurada requerida.
- Para ejecutarlo, se necesita un servidor LLM local (Ollama o LM Studio) y hardware suficiente para ejecutar el modelo elegido.
Temas
Preguntas frecuentes
- ¿Qué es local-deep-researcher?
- Asistente de investigación web completamente local que ejecuta ciclos iterativos de búsqueda, resumen y reflexión sobre lagunas de conocimiento con LLM servidos por Ollama o LM Studio. Local Deep Researcher recibe un tema de investigación, usa un LLM local para generar una consulta de búsqueda web, recopila resultados y los resume. Después, analiza el resumen para identificar lagunas de conocimiento, genera una consulta de seguimiento para cubrirlas y repite el proceso durante un número configurable de ciclos. El resultado final es un informe en markdown con las fuentes utilizadas, que se conservan en el estado de LangGraph.
- ¿local-deep-researcher es gratuito? ¿Qué licencia tiene?
- local-deep-researcher es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿local-deep-researcher sigue mantenido?
- Mantenimiento activo. El último commit de local-deep-researcher fue el 15 oct 2026.
- ¿Para qué puedo usar local-deep-researcher?
- Investigar un tema y mantener los prompts y los datos en tu propio equipo. Crear prototipos de un agente de búsqueda y resumen de varios pasos con LangGraph. Generar informes de contexto con citas sin necesitar una API key de búsqueda de pago.
- ¿Cómo se instala local-deep-researcher?
- Clona el repositorio: git clone https://github.com/langchain-ai/local-deep-researcher.git Entra en el directorio del proyecto y copia el archivo de entorno de ejemplo: cd local-deep-researcher && cp .env.example .env Descarga un modelo local con Ollama (instala primero la aplicación de Ollama): ollama pull deepseek-r1:8b Inicia el servidor de LangGraph con uv: uvx --refresh --from "langgraph-cli[inmem]" --with-editable . --python 3.11 langgraph dev
- ¿Dónde consigo local-deep-researcher?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/langchain-ai/local-deep-researcher
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Colección de 28 tutoriales basados en código para llevar agentes de GenAI del prototipo a producción, con temas como memoria, RAG, despliegue, seguridad y observabilidad.
Segundo cerebro con IA autoalojable que responde preguntas sobre la web y tus propios documentos, con agentes personalizados y automatizaciones programadas.
FastGPT es una plataforma de código abierto para crear agentes de IA, con procesamiento de datos, bases de conocimiento RAG y orquestación visual de flujos de trabajo para aplicaciones con LLM.
Plataforma de código abierto para crear bots de chat con IA que conectan LLM con Slack, Discord, Telegram, WeChat, Lark, DingTalk y más.
Infraestructura de memoria nativa para agentes que convierte las conversaciones y ejecuciones de agentes LLM en memoria persistente y estructurada para aplicaciones Python y TypeScript.