Hypenosys · Pipeline Dev

Onboarding para nuevos devs del pipeline Hypenosys

Guía rápida para conectar GitHub, Jules y el flujo interno de Hypenosys antes de empezar a trabajar en tareas reales.

Para nuevos desarrolladores y colaboradores técnicos

Antes de empezar

  • Cuenta de GitHub — necesaria para todo el flujo.
  • Debes aceptar la invitación a la organización hypenosys en GitHub.
  • Debes tener acceso al repositorio de prueba Minecraft-Server-Docker.
  • El repositorio puede estar vacío inicialmente — es normal.
  • La primera tarea sirve para comprobar que Jules puede generar cambios y abrir una PR correctamente.
  • No uses un repositorio crítico para esta primera prueba.
Flujo oficial · jules.google.com
01Org

Aceptar la invitación a la organización Hypenosys

GitHub

Revisa tu correo o tus notificaciones de GitHub y acepta la invitación para entrar en la organización hypenosys. Comprueba que puedes ver la organización desde tu cuenta.

  • He aceptado la invitación a hypenosys
  • Veo la organización en mi lista de GitHub
  • Veo el repositorio Minecraft-Server-Docker
  • Si no lo veo, aviso al administrador del proyecto
02Jules

Crear cuenta o entrar en Jules

JulesGitHub

Entra en Jules e inicia sesión con tu cuenta de Google, creando la cuenta si es necesario. Vincula GitHub cuando Jules lo solicite y autoriza el acceso a los repositorios necesarios.

jules.google.com ↗
  • Sesión iniciada con Google
  • GitHub vinculado a Jules
  • Acceso autorizado a los repos necesarios
  • Jules ve repositorios de la organización Hypenosys

Los permisos exactos dependen de la configuración de GitHub, OAuth y la autorización de la organización — no hay automatismos garantizados aquí.

03Repo

Seleccionar el repositorio de prueba

Minecraft-Server-Docker

Este repositorio es un entorno seguro de prueba y puede estar vacío al inicio. Su única finalidad es comprobar que el pipeline Jules → GitHub → Pull Request funciona. Selecciónalo dentro de Jules antes de escribir el prompt.

04Tarea

Lanzar la primera tarea en Jules

Jules

Puedes usar el modo Interactive Plan si quieres revisar el enfoque antes de que Jules modifique archivos, o Start si quieres que Jules genere la solución directamente.

Prompt sugerido
Quiero un Docker Compose para un servidor local de Minecraft para BoinaLand. El objetivo es tener una configuración inicial sencilla, reproducible y documentada. Incluye los archivos necesarios, una estructura clara del proyecto y un README con instrucciones para levantar el servidor en local.
Versión estricta
Crea una configuración Docker Compose para un servidor local de Minecraft llamado BoinaLand. El repositorio puede estar vacío, así que genera la estructura mínima necesaria. Incluye docker-compose.yml, .env.example, carpetas persistentes si son necesarias y un README.md con instrucciones claras para iniciar, parar, configurar y actualizar el servidor. No uses secretos reales. Prioriza simplicidad, persistencia de datos y facilidad de mantenimiento.
05PR

Revisar cambios y Pull Request

PRReview

Si todo va bien, Jules debería generar cambios en el repositorio y permitir crear una Pull Request. Revisa los archivos antes de aprobar — la PR debe ser revisada antes de mergear.

  • docker-compose.yml existe
  • Hay volúmenes persistentes
  • Hay README.md
  • No hay secretos ni tokens reales
  • El nombre BoinaLand aparece donde corresponde
  • La configuración puede arrancar en local
  • La PR tiene descripción clara
06Config

Configurar tu proveedor de IA y accesos internos

IAn8n

Antes de usar Claude Chat o generar contenido con IA (imagen, música), necesitas un proveedor de IA configurado (NVIDIA NIM u Ollama) y, para algunas funciones, las URLs internas de n8n o SVN. Estas direcciones no están publicadas en esta página por seguridad — pídeselas a Axel o consúltalas en el canal interno de Discord del equipo.

Ver configuración detallada ↓
Alternativa

Flujo interno desde Hypenosys

Además del flujo directo con jules.google.com, también puedes trabajar desde hypenosys.github.io, usando el Jules Panel y el Claude Chat del sistema.

  1. Entrar en hypenosys.github.io
  2. Abrir el Jules Panel
  3. Autenticarte con GitHub si el panel lo solicita
  4. Seleccionar la organización / repositorio correspondiente
  5. Usar el Chat Neural / Claude Chat para preparar o refinar el prompt
  6. Enviar la tarea a Jules desde el panel cuando el prompt esté validado
  7. Revisar el estado de la tarea, actividad, rama y Pull Request desde el panel

Claude Chat

Razona, prepara, refina y valida instrucciones antes de enviarlas.

Jules

Ejecuta tareas técnicas sobre los repositorios.

GitHub

Es la fuente de verdad para ramas, commits y Pull Requests.

Vista completa

El pipeline, de punta a punta

Desplázate en horizontal en móvil. Cada nodo cambia de color según a quién le toca actuar.

Nuevo dev
Punto de partida
Org Hypenosys
GitHub
Jules conectado
OAuth GitHub
Repo de prueba
Minecraft-Server-Docker
Prompt técnico
Claude Chat (opcional)
Cambios generados
Jules
Pull Request
GitHub
Revisión
Humana
Merge
Si procede
Referencia técnica

Configuración de infraestructura y herramientas

Todo lo que puede hacer falta configurar más allá del flujo básico de Jules: proveedor de IA, automatizaciones de n8n, SVN y el resto de herramientas self-hosted del stack.

⚠️ Reglas de configuración

  • Las IPs y URLs internas (n8n, SVN, ComfyUI, CopyParty, gatekeeper) no se publican aquí — pídelas a Axel o consúltalas en el Discord interno del equipo.
  • Configura IPs de SVN solo con autorización del equipo.
  • No subas datos externos sin revisión técnica.
  • Builds y archivos temporales van a CopyParty, nunca al repositorio.
  • Nunca compartas API keys ni tokens en commits, issues o esta página.

IA Proveedor de IA (NVIDIA NIM / Ollama)

Se configura desde el Jules Panel → pestaña Config → Configuración API: ahí eliges el proveedor (Claude, Ollama o NVIDIA NIM), el modelo y, si aplica, la URL base.

🔒
IP del servidor Ollama
Pídesela a Axel o consúltala en el Discord del equipo.

Si Chrome bloquea la conexión por origen inseguro: chrome://flags/#unsafely-treat-insecure-origin-as-secure → pega ahí la IP del servidor Ollama.

🔒
Endpoint NVIDIA NIM
Pasa por el relay de Cloudflare (gatekeeper) para evitar problemas de CORS. URL exacta: pídesela a Axel o al Discord.

n8n Automatizaciones (repo-config)

La URL base de n8n se configura en repo-config. Desde ahí se disparan los webhooks que usan SVN y la generación de contenido con IA.

🔒
URL base de n8n
Pídesela a Axel o consúltala en el Discord del equipo.
Webhooks disponibles
git-log svn-diff svn-info svn-log svn-list music-gen flux-img flux-kontext

SVN Repositorio SVN

El panel de administración es público y accesible directamente:

Repo Admin ↗
🔒
IP del servidor SVN
Pídesela a Axel o consúltala en el Discord del equipo.

Media ComfyUI

Backend de generación de imagen, audio y animación con IA del stack self-hosted.

🔒
URL de ComfyUI
Pídesela a Axel o consúltala en el Discord del equipo.

Files CopyParty

Almacén de builds y archivos temporales. Nunca subas este contenido al repositorio.

🔒
URL de CopyParty
Pídesela a Axel o consúltala en el Discord del equipo.

Stack Stack IA completo (cognito-stack)

n8n + Ollama + ComfyUI + Matrix + Qdrant + GPU, documentado en el repositorio público.

connect-core ↗ DeepWiki ↗
tc ↗
Recomendaciones

Buenas prácticas

  • Empieza siempre en repositorios de prueba
  • No uses secretos reales
  • Pide README y documentación desde el primer prompt
  • Usa ramas separadas para cada tarea
  • Revisa la PR antes de mergear
  • Prefiere prompts concretos, con estructura esperada de archivos
  • Si Jules propone un plan, revísalo antes de aceptarlo
  • Si algo falla, copia el error exacto y documéntalo en el panel o en una issue
  • Pide las URLs de configuración (n8n, SVN, IA) a Axel o al Discord del equipo — nunca están en el código público
  • Guarda tokens y API keys solo en tu configuración local, nunca los subas a un commit
Troubleshooting

Errores comunes

Posibles causas:

  • No has aceptado la invitación a la organización
  • GitHub no ha autorizado a Jules para esa organización
  • Jules no tiene permisos sobre ese repo
  • El repositorio es privado y falta autorización

Posibles causas:

  • Falta permiso de escritura
  • La rama no se ha creado correctamente
  • Jules no tiene autorización suficiente
  • El repo está vacío y Jules necesita generar la estructura inicial

Posibles causas:

  • Falta autenticación con GitHub
  • Token caducado
  • No se ha refrescado la lista de repositorios
  • Todavía no perteneces a la organización correcta

Por seguridad no están publicadas en esta página ni en el repositorio. Pídeselas directamente a Axel o consúltalas en el canal interno de Discord del equipo.

Posibles causas:

  • No estás en la pestaña Config → Configuración API del Jules Panel
  • Tu build no está actualizado
  • Aún no tienes credenciales asignadas — pídeselas a Axel