forkoff-backend
Backend NestJS auto-hospedable para ForkOff. Gestiona autenticación Supabase, sesiones Claude Code, dispositivos móviles y analítica en tiempo real vía WebSocket. Requiere Node.js 18+ y configuración manual de entorno.
Ficha actualizada 27 sept 2026, 19:10 · upstream 27 sept 2026, 18:58 · release v1.1.0
Qué es forkoff-backend
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
ForkOff Backend es el servidor API central que impulsa el ecosistema ForkOff, permitiendo la auto-hospedación del backend para enrutar Claude Code a través de tu propio servidor con una puerta de entrada LLM integrada. Utiliza NestJS como framework principal y PostgreSQL alojado en Supabase para la persistencia de datos y autenticación segura mediante JWT.
El sistema facilita la comunicación en tiempo real a través de Socket.io, permitiendo actualizaciones instantáneas entre el móvil y el servidor. Incluye gestión avanzada de dispositivos para emparejar múltiples máquinas de desarrollo, manejo de sesiones de IA, notificaciones push vía Expo y una cola de prompts para gestionar límites de tasa. Además, ofrece documentación Swagger para la API y soporte para analíticas de uso y logros del usuario.
Requisitos incluyen Node.js 18 o superior y una cuenta de Supabase activa. La instalación requiere clonar el repositorio, instalar dependencias con npm y configurar las variables de entorno en un archivo .env antes de ejecutar las migraciones de la base de datos.
- Enrutamiento de sesiones Claude Code a través del propio servidor
- Gestión y emparejamiento de dispositivos móviles con el CLI
- Seguimiento de analíticas de uso y token consumption
- Notificaciones push para alertas en la aplicación móvil
- Cola de prompts para gestionar solicitudes durante límites de tasa
- Autenticación robusta basada en JWT a través de Supabase
- Comunicación WebSocket real-time para actualizaciones instantáneas
- Gateway auto-hospedado para Claude Code con inyección de credenciales
- ORM Prisma integrado para gestión eficiente de la base de datos
- Documentación API completa mediante Swagger UI
- Dependencia externa obligatoria de Supabase para Auth y DB
- Configuración manual de variables de entorno sin Docker Compose por defecto
- Requiere Node.js 18+ instalado previamente en el servidor
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.
Instalar Node.js 18+. Clonar repositorio y ejecutar npm install. Copiar .env.example a .env y rellenar credenciales Supabase (DATABASE_URL, SUPABASE_*, JWT_SECRET). Ejecutar npm run db:push para aplicar esquema. Iniciar con npm run start:prod en puerto 3000. Acceder a docs en /docs. Asegurar acceso WebSocket en IP local o dominio.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
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.