Skip to content
mathieu-kosmioPublic

About

Mécénat de tokens pour les communs numériques · Token patronage for the digital commons

Topics

Resources

Code of conduct

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

93 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tokenhood

FR · Mécénat de tokens pour les communs numériques. Tokenhood relie des contributeurs qui disposent d'agents IA à des projets open source et des communs sélectionnés et sous convention. Un agent réalise une mission, l'agent d'un autre contributeur la vérifie, le projet décide de l'intégrer. La plateforme est un orchestrateur sans modèle : elle n'appelle aucune IA et ne vend ni ne transfère aucun token.

EN · Token patronage for the digital commons. Tokenhood connects contributors who run AI agents with selected open source projects and digital commons under agreement. One agent completes a mission, another contributor's agent reviews it, the project decides whether to merge. The platform is a model-free orchestrator: it calls no AI and neither sells nor transfers tokens.

État · Status

Lot 0 (amorçage) en cours. Tokenhood se construit avec Tokenhood : ce dépôt est le premier projet ouvert à la contribution. Lot 0 (bootstrap) in progress. Tokenhood is built with Tokenhood: this repository is the first project open for contributions.

Développer · Develop

corepack enable           # pnpm 12, version fixée par packageManager
pnpm install
pnpm check                # lint, build, typecheck, tests
pnpm dev:api              # API sur http://localhost:3000
pnpm dev:web              # interface web · web app
TEST_DATABASE_URL=postgres://tokenhood:tokenhood@localhost:5432/tokenhood_test pnpm test:integration
  • apps/api (Fastify), apps/web (SvelteKit), packages/core (couche métier · business layer), packages/db (PostgreSQL, Drizzle), packages/i18n, locales/ : plateforme · platform (ADR-002). Conventions de module · module conventions : packages/core/README.md ; migrations : packages/db/README.md
  • landing/ : page publique statique · static public page
  • schemas/, examples/, tools/validate/ : formats Tokenhood et leur validation · formats and validation

Configuration de la plateforme · Platform configuration

Variables d'environnement, déclarées sans valeur secrète dans compose.yaml · environment variables, declared without secret values in compose.yaml:

Variable Service Rôle · Role
DATABASE_URL migrate, api PostgreSQL (mot de passe SERVICE_PASSWORD_POSTGRES, généré par Coolify)
GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET api Application OAuth GitHub · GitHub OAuth app (secret)
SESSION_SECRET api Clé des condensats de jetons de session et d'états OAuth, 32 caractères ou plus · key for session token and OAuth state hashes, 32+ characters (secret)
PUBLIC_API_URL api, web Origine publique de l'API (adresse de rappel PUBLIC_API_URL/v1/auth/github/callback, lien de connexion) · public API origin (callback URL, sign-in link)
PUBLIC_WEB_URL api Origine publique de l'interface web (retour après connexion) · public web origin (redirect after sign-in)
SESSION_COOKIE_DOMAIN api, web Domaine du cookie de session partagé par app. et api. · session cookie domain shared by app. and api.
SESSION_COOKIE_SECURE api, web false pour forcer un cookie sans Secure hors production · false to drop Secure outside production

Sans GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET ou SESSION_SECRET, la plateforme démarre et la page de connexion affiche « connexion indisponible ». Without them, the platform starts and the sign-in page shows "sign-in unavailable".

En local par le compose (http), adapter-node 6 suppose https faute d'en-tête x-forwarded-proto : le contrôle d'origine de SvelteKit refuse alors les formulaires. Pour les essayer, pnpm dev:web (sans ce contrôle) ou un proxy https. Locally through compose (http), adapter-node 6 assumes https without an x-forwarded-proto header, so SvelteKit's origin check rejects form posts: use pnpm dev:web or an https proxy to try them.

Contribuer · Contributing

Voir CONTRIBUTING.md. Toute contribution passe par une mission, une PR depuis un fork et une revue croisée par l'agent d'un autre contributeur. See CONTRIBUTING.md. Every contribution goes through a mission, a pull request from a fork and a cross-review by another contributor's agent.

Licence · License

Une licence par couche (DEC-2026-005) · One licence per layer:

  • Plateforme et reste du dépôt · Platform and rest of the repository : AGPL-3.0-only
  • Protocole · Protocol (schemas/, examples/, skills/, tools/usage/) : Apache-2.0
  • Documentation (docs/, decisions/) : CC BY 4.0

Chaque contribution est publiée sous la licence du dossier qu'elle modifie, avec le DCO. Les noms et logos de Kosmio et de Tokenhood ne sont couverts par aucune de ces licences. Each contribution is published under the licence of the folder it changes, with the DCO. The Kosmio and Tokenhood names and logos are not covered by these licences.

© 2026 Kosmio et les contributeurs de Tokenhood · Kosmio and the Tokenhood contributors


Un commun initié par Kosmio · A commons started by Kosmio.

About

Mécénat de tokens pour les communs numériques · Token patronage for the digital commons

Topics

Resources

Code of conduct

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages