Pengou es de código abierto
El código de Pengou es público, con licencia Apache-2.0. Puedes leerlo, instalarlo en tu servidor con Docker, adaptarlo a tus necesidades y contribuir en GitHub.
Actualizado el .
Por qué el código es abierto
Primero, por la confianza. Todo el mundo puede leer lo que Pengou hace con los datos, en lugar de tener que creer lo que dice el sitio.
Después, por la continuidad. Si el servicio de app.pengou.fr se detuviera algún día, el código seguiría disponible y cualquiera podría volver a poner Pengou en marcha.
Por último, por la autonomía. Una escuela, una asociación o una empresa puede hacer funcionar su propia instancia, en sus propias máquinas, sin pedir permiso a nadie.
La licencia en lenguaje claro
Pengou se publica con la licencia Apache-2.0, una licencia libre aprobada por la Open Source Initiative. Puedes usar Pengou, instalarlo para ti, tu organización o tus clientes, modificarlo y redistribuirlo, incluso en un contexto comercial. Hasta puedes ofrecer tu propia versión como servicio alojado.
A cambio, debes incluir una copia de la licencia en toda redistribución, conservar los avisos de copyright y de atribución (entre ellos el archivo NOTICE) e indicar los archivos que hayas modificado.
El código es libre, la marca no. Los nombres «Pengou» y «Sploot Labs», el logotipo y la mascota no están cubiertos por la licencia: no puedes usarlos para presentar tu versión como la oficial.
El texto de la licencia es el que prevalece. El archivo LICENSING.md lo explica en lenguaje corriente.
Instalar Pengou por tu cuenta
Necesitas Docker y Docker Compose. Obtén el repositorio, genera un secreto de sesión y después lanza todo:
git clone https://github.com/Sploot-Labs/pengou.git
cd pengou
export BETTER_AUTH_SECRET=$(openssl rand -base64 32)
docker compose up
Abre a continuación http://localhost:3000 en tu navegador. Compose arranca PostgreSQL y la aplicación, y aplica las migraciones al arrancar. No pongas nunca este secreto en un repositorio git: guárdalo en tu gestor de secretos.
Para una instancia en producción, sirve Pengou detrás de HTTPS y configura BETTER_AUTH_URL con una dirección que empiece por https://. El modo single sirve para una sola organización, el modo multi para varios espacios de trabajo aislados. El despliegue actual funciona con una sola instancia: el paso a varias instancias está en curso. La sección Docker del README detalla la configuración, y el archivo .env.example documenta cada variable.
Contribuir
Las contribuciones son bienvenidas, sobre todo las primeras. Para empezar, elige una incidencia marcada con good first issue, comenta para reservarla y luego propón tu cambio. Si es tu primera contribución de código abierto, dilo en la descripción: te acompañamos.
¿Te atascas o tienes una idea? Abre una discusión. La guía de contribución explica cómo instalar el proyecto y pasar las pruebas, y el código de conducta fija las reglas del intercambio.
¿Has encontrado un fallo de seguridad? No abras una incidencia pública. Sigue en su lugar la política de seguridad, que pasa por un aviso privado.
Por dentro
Pengou es un monorepo TypeScript. El servidor se apoya en Fastify y Socket.IO, la interfaz en React y Vite, los datos en PostgreSQL con Drizzle y la autenticación en Better Auth. El motor de juego es puro y determinista: la puntuación se calcula en el servidor, lo que hace fiable la protección contra trampas y comprobable el cálculo de los puntos.
Probar Pengou
Crea una cuenta de anfitrión para preparar tu primer quiz, o únete a una partida con su código.