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.
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.
- Page publique · Public page : https://tokenhood.kosm.io (à venir · coming)
- Spécifications · Specs :
docs/specs/ - Missions :
.tokenhood/missions/ - Décisions · Decisions :
decisions/ - Design system :
design/(satellite du design system Kosmio v2 « Horizon ») - Landing · Landing page :
landing/(site statique FR/EN · static FR/EN site)
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:integrationapps/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.mdlanding/: page publique statique · static public pageschemas/,examples/,tools/validate/: formats Tokenhood et leur validation · formats and validation
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.
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.
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.