Pengou est open source

Le code de Pengou est public, sous licence Apache-2.0. Vous pouvez le lire, l'installer sur votre serveur avec Docker, l'adapter à vos besoins et contribuer sur GitHub.

Mis à jour le .

Voir le code sur GitHub

Pourquoi le code est ouvert

D'abord pour la confiance. Tout le monde peut lire ce que fait Pengou des données, au lieu de devoir croire ce qu'en dit le site.

Ensuite pour la durée. Si le service d'app.pengou.fr s'arrêtait un jour, le code resterait disponible et n'importe qui pourrait relancer Pengou.

Enfin pour l'autonomie. Une école, une association ou une entreprise peut faire tourner sa propre instance, sur ses machines, sans rien demander à personne.

La licence en clair

Pengou est publié sous licence Apache-2.0, une licence libre approuvée par l'Open Source Initiative. Vous pouvez utiliser Pengou, l'installer pour vous, votre organisation ou vos clients, le modifier et le redistribuer, y compris dans un cadre commercial. Vous pouvez même proposer votre propre version en service hébergé.

En échange, vous devez joindre une copie de la licence à toute redistribution, garder les mentions de copyright et d'attribution (dont le fichier NOTICE) et signaler les fichiers que vous avez modifiés.

Le code est libre, la marque ne l'est pas. Les noms « Pengou » et « Sploot Labs », le logo et la mascotte ne sont pas couverts par la licence : vous ne pouvez pas vous en servir pour présenter votre version comme la version officielle.

Le texte de la licence fait foi. Le fichier LICENSING.md l'explique en langage courant.

Installer Pengou chez vous

Il vous faut Docker et Docker Compose. Récupérez le dépôt, générez un secret de session, puis lancez l'ensemble :

git clone https://github.com/Sploot-Labs/pengou.git
cd pengou
export BETTER_AUTH_SECRET=$(openssl rand -base64 32)
docker compose up

Ouvrez ensuite http://localhost:3000 dans votre navigateur. Compose démarre PostgreSQL et l'application, et applique les migrations au démarrage. Ne mettez jamais ce secret dans un dépôt git : gardez-le dans votre gestionnaire de secrets.

Pour une instance en production, servez Pengou derrière HTTPS et réglez BETTER_AUTH_URL sur une adresse en https://. Le mode single convient à une seule organisation, le mode multi à plusieurs espaces de travail cloisonnés. Le déploiement actuel tourne sur une seule instance : le passage à plusieurs instances est en cours. La section Docker du README détaille la configuration, et le fichier .env.example documente chaque variable.

Contribuer

Les contributions sont bienvenues, surtout les premières. Pour commencer, choisissez un ticket marqué good first issue, commentez pour le réserver, puis proposez votre modification. Si c'est votre première contribution open source, dites-le dans la description : on vous accompagne.

Vous bloquez ou vous avez une idée ? Ouvrez une discussion. Le guide de contribution explique comment installer le projet et faire passer les tests, et le code de conduite fixe les règles de l'échange.

Vous avez trouvé une faille de sécurité ? N'ouvrez pas de ticket public. Suivez plutôt la politique de sécurité, qui passe par un signalement privé.

Sous le capot

Pengou est un monorepo TypeScript. Le serveur repose sur Fastify et Socket.IO, l'interface sur React et Vite, les données sur PostgreSQL avec Drizzle, et l'authentification sur Better Auth. Le moteur de jeu est pur et déterministe : le score est calculé côté serveur, ce qui rend l'anti-triche fiable et le calcul des points testable.

Essayer Pengou

Créez un compte d'hôte pour préparer votre premier quiz, ou rejoignez une partie avec son code.