Documentación de byox
Construye tu propio X, test por test
byox convierte proyectos como «un servidor Redis» o «un intérprete de Lisp» en repositorios de Forgejo. Cada etapa es un issue con un test; cada git push corre los tests, cierra lo que pasa y desbloquea lo que sigue.
Qué es byox
Un curso de byox es un proyecto real que se construye por etapas. El alumno recibe un repositorio con un esqueleto que compila y un conjunto de tests que fallan. Resolver una etapa es hacer que su test pase. Las etapas forman un grafo: algunas dependen de otras y quedan bloqueadas hasta que se cierran sus dependencias.
Todo corre en tu propia máquina o servidor: un Forgejo para los repositorios, un runner que ejecuta los tests en Docker y una aplicación web con una API y un servidor MCP. No hay servicios externos ni cuentas de terceros.
Hay tres papeles, y cada uno usa una parte distinta:
| Quién | Qué hace | Dónde |
|---|---|---|
| Alumno | Sigue un curso: lee la etapa, escribe código, hace push | App web, CLI, su editor |
| Asistente | Escribe, verifica y publica cursos; acompaña al alumno cuando se atasca | Servidor MCP |
| Administrador | Instala la instancia, crea cuentas, decide quién puede crear cursos | docker compose, esta documentación |
Por dónde empezar
Inicio rápidoDe cero a tu primera etapa resuelta, en unos diez minutos.
Self-hostingInstalación, configuración, cuentas, producción y seguridad.
Asistente (MCP)Conecta Claude Code u otro cliente y qué herramientas expone.
Crear cursosEl formato, la verificación y cómo compartirlos.
La documentación y la landing son sitios estáticos que se pueden publicar por separado, por ejemplo en Vercel. La aplicación de byox no vive ahí: cada instancia tiene la suya, con sus propias cuentas y sus propios datos.