🤖 LightRAG para Easypanel

Sistema de Retrieval-Augmented Generation (RAG) basado en grafos, optimizado para despliegue en Easypanel.

📋 Índice

• Características
• Requisitos
• Instalación en Easypanel
• Configuración
• Integración con n8n
• Uso
• Troubleshooting
• Contribuir

✨ Características

• 🚀 RAG basado en grafos: Sistema de recuperación inteligente usando grafos de conocimiento
• 💾 Sin dependencias externas: No requiere bases de datos adicionales (PostgreSQL, Redis, etc.)
• 🔌 API REST completa: Endpoints para insertar, consultar y gestionar documentos
• 🎨 WebUI incluida: Interfaz web para visualización de grafos y consultas
• 🤝 Compatible con múltiples LLMs: OpenAI, Ollama, Anthropic, Google Gemini y más
• 📊 Base de datos vectorial integrada: Sistema propio de almacenamiento vectorial
• 🔄 Cache inteligente: Optimización de consultas LLM con sistema de cache
• 🌐 Multilenguaje: Soporte para múltiples idiomas

📦 Requisitos

En tu servidor:

• Docker instalado
• Easypanel configurado
• Mínimo 2GB de RAM
• 5GB de espacio en disco

APIs externas:

• API Key de OpenAI (o cualquier proveedor LLM compatible)
• API Key de embeddings (puede ser la misma de OpenAI)

Nota: También puedes usar Ollama localmente sin necesidad de APIs externas

🚀 Instalación en Easypanel

Método 1: Desde la interfaz de Easypanel

1. Accede a tu panel de Easypanel
2. Crea un nuevo servicio → App
3. Configura según la guía: Ver guía detallada

Método 2: Docker Compose manual

# Clonar el repositorio
git clone https://github.com/webhook-ja/lightrag-easypanel.git
cd lightrag-easypanel

# Copiar y configurar variables de entorno
cp .env.example .env
nano .env  # Edita con tus API keys

# Levantar el servicio
docker-compose up -d

⚙️ Configuración

Variables de Entorno Principales

# Configuración del servidor
HOST=0.0.0.0
PORT=9621

# LLM (OpenAI)
LLM_BINDING=openai
LLM_MODEL=gpt-4o-mini
LLM_BINDING_API_KEY=tu-api-key-aqui

# Embeddings (OpenAI)
EMBEDDING_BINDING=openai
EMBEDDING_MODEL=text-embedding-3-large
EMBEDDING_DIM=3072
EMBEDDING_BINDING_API_KEY=tu-api-key-aqui

# Performance
ENABLE_LLM_CACHE=true
MAX_ASYNC=4
MAX_PARALLEL_INSERT=2

Ver todas las opciones en: Configuración completa

Volúmenes de Storage en Easypanel

Configura estos 3 volúmenes en Easypanel:

Mount Path	Descripción	Tamaño recomendado
/app/data/rag_storage	Base de datos vectorial y grafos	5GB - 20GB
/app/data/inputs	Documentos a procesar	1GB - 5GB
/app/data/tiktoken	Cache de tokens	100MB

🔗 Integración con n8n

Conexión desde n8n a LightRAG

En tus nodos HTTP Request de n8n, usa:

http://TU_IP_SERVIDOR:9621

O si están en la misma red de Easypanel:

http://nombre-del-servicio:9621

Workflows incluidos

• Chatbot con memoria
• Procesamiento de documentos

Ver guía completa: Integración n8n

📖 Uso

API Endpoints principales

# Insertar documento
POST /insert
{
  "text": "Tu contenido aquí..."
}

# Consultar (streaming)
POST /query/stream
{
  "query": "Tu pregunta",
  "mode": "hybrid"
}

# Subir archivo
POST /upload
Content-Type: multipart/form-data

WebUI

Accede a la interfaz web en:

http://TU_IP_SERVIDOR:9621/webui

Documentación de API completa: API Reference

🔧 Troubleshooting

Error: "Connection refused"

• Verifica que el contenedor esté corriendo: docker ps
• Revisa los logs: docker logs nombre-contenedor
• Asegúrate que el puerto 9621 esté expuesto

Error de API Key

• Verifica que las variables de entorno estén configuradas
• Comprueba que la API key sea válida
• Revisa los límites de tu cuenta OpenAI

Ver más soluciones: Troubleshooting completo

📚 Documentación adicional

• Instalación detallada
• Configuración avanzada
• Integración con n8n
• API Reference

🤝 Contribuir

Las contribuciones son bienvenidas! Por favor:

1. Fork el proyecto
2. Crea tu rama de feature (git checkout -b feature/AmazingFeature)
3. Commit tus cambios (git commit -m 'Add: nueva característica')
4. Push a la rama (git push origin feature/AmazingFeature)
5. Abre un Pull Request

📄 Licencia

Este proyecto está bajo la Licencia MIT. Ver LICENSE para más detalles.

🙏 Créditos

• LightRAG Original: HKUDS/LightRAG
• Creador y Mantenedor: webhook-ja - adbductiondesarrolloweb@gmail.com
• Adaptación para Easypanel: Creado por webhook-ja
• Asistencia en Desarrollo: Claude Code de Anthropic
• Interfaz de Chatbot: Diseñada por webhook-ja con Claude Code
• Documentación: Escrita en colaboración entre webhook-ja y Claude Code

📞 Soporte

¿Tienes preguntas? Abre un Issue

---

Hecho con ❤️ por webhook-ja para la comunidad de Easypanel

Desarrollado con la asistencia de Claude Code