relay
Relay es una interfaz web minimalista para chat con LLMs que ejecuta directamente en el navegador, utilizando Node.js y React. Persiste datos en un único archivo JSON local y soporta APIs compatibles con OpenAI o Google Vertex AI sin necesidad de backend complejo.
Ficha actualizada 26 sept 2026, 14:53 · upstream 26 sept 2026, 14:26 · release v1.4.1
Qué es relay
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Relay es una aplicación web diseñada para funcionar como un chatbox personal para LLMs que se ejecuta directamente en el navegador del cliente, eliminando la necesidad de instalar software adicional. La arquitectura se basa en Node.js y React, con una implementación extremadamente ligera que utiliza un único archivo JSON local para persistir las conversaciones y configuraciones.
El sistema soporta múltiples proveedores de modelos a través de APIs compatibles con OpenAI o integraciones nativas con Google Vertex AI. Los datos se almacenan en un volumen persistente (`relay-data`) que puede montarse desde el host, permitiendo copias portables del archivo JSON sin credenciales, ya que las claves API y secretos se guardan en archivos separados para mayor seguridad.
La aplicación ofrece dos modos de ejecución: una imagen Docker oficial disponible en ghcr.io para despliegues rápidos, o una implementación nativa con Node.js 20+ para desarrollo local. Incluye soporte para copias de seguridad mediante WebDAV y gestión de entornos a través de variables de entorno opcionales.
- Crear una interfaz de chat personal con LLMs sin instalar software adicional en el cliente
- Usar como proxy seguro para APIs externas como OpenAI o Google Vertex AI en entornos autoalojados
- Gestionar datos de conversación mediante archivos JSON portables que pueden copiarse fácilmente entre máquinas
- Ejecutar una instancia ligera de chat con IA en hardware limitado (1GB RAM, 1 núcleo CPU)
- Arquitectura minimalista sin backend complejo ni bases de datos tradicionales
- Soporte nativo para Docker con imagen oficial en ghcr.io/qingpy/relay:latest
- Gestión segura de credenciales mediante archivos separados (secrets.json) del archivo de datos principal
- Capacidad de copias de seguridad automáticas vía WebDAV sin interrumpir la sesión activa
- Bajo consumo de recursos: 1GB RAM y 10GB disco mínimo recomendados
- No incluye autenticación HTTP nativa; debe vincularse a redes de confianza o implementar proxy con auth externo
- Dependencia de claves API externas almacenadas en archivos locales, lo que requiere gestión manual de rotación
- No soporta composición (compose) para orquestación compleja de múltiples servicios
- La persistencia de datos depende exclusivamente del volumen montado; sin él, los datos se pierden al reiniciar
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Para despliegue en producción, use el comando Docker proporcionado con el volumen `-v relay-data:/data` montado en un directorio seguro. Asegúrese de configurar las variables de entorno `RELAY_DATA_FILE`, `RELAY_SECRETS_FILE` y las credenciales de API (`OPENAI_KEY`, `GOOGLE_VERTEX_CREDENTIALS`) antes de iniciar el contenedor. Evite exponer el puerto 8787 a redes públicas sin autenticación adicional. Para copias de seguridad, configure WebDAV en la configuración de conexiones o use el directorio `./backups` para respaldos manuales del archivo JSON.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.