kody

Kody est une plateforme d'assistant personnel conçue comme un foyer pour la mémoire, les clés, le code et les automatisations d'un agent IA, avec pour objectif de rester portable entre les hôtes MCP compatibles. Elle est construite sur Cloudflare Workers et le Model Context Protocol, et fournit une interface Remix, un routage des requêtes basé sur Workers, une infrastructure d'exécution de paquets et des points de terminaison MCP protégés par OAuth. Architecture et portée Le projet privilégie une surface MCP compacte avec des flux de recherche et d'exécution en mode Code plutôt qu'un grand catalogue d'outils statiques. Il est décrit comme un assistant personnel multi-utilisateurs : chaque utilisateur connecté dispose d'un assistant entièrement isolé couvrant les paquets, les tâches, les secrets, les mémoires et les états associés. Les tests et fixtures peuvent générer des comptes locaux déterministes, mais aucun compte n'est privilégié à l'exécution. Le README indique que le projet est une plateforme d'assistant personnel Fair Source plutôt qu'un harnais d'agent généraliste, et que ChatGPT est probablement une cible hôte principale tout en gardant le serveur utilisable depuis d'autres hôtes MCP lorsque c'est pratique. Structure du dépôt Le dépôt est un monorepo Nx. Les modules partagés se trouvent dans packages/shared, le worker d'application d'origine dans packages/worker, avec des workers frères dans packages/platform-worker, packages/runtime-worker et packages/jobs-worker, plus des Workers simulés sous packages/mock-servers. La topologie de production est documentée dans docs/contributing/architecture. Le flux de requêtes décrit est : les requêtes OAuth sont traitées en premier, puis les requêtes MCP, puis les actifs statiques ; les requêtes non liées aux actifs passent au gestionnaire de serveur et au routeur, et les actifs clients sont regroupés dans packages/worker/public et servis via la liaison ASSETS. Pile technique Runtime : Cloudflare Workers. Framework UI : Remix 3 (bêta). Gestionnaire de paquets : npm. Espace de travail : Nx plus espaces de travail npm. Base de données : Cloudflare D1. Session/OAuth : Cloudflare KV. État MCP : Durable Objects sur kody-platform. Tests E2E : Playwright. Bundler : Vite. Pour commencer Installez les dépendances avec npm install et démarrez le serveur de développement avec npm run dev. Le serveur de développement tourne par défaut sur localhost:3742, avec la CLI choisissant le prochain port libre et affichant l'URL résolue ; Wrangler gère automatiquement le runtime Cloudflare Workers local et la base de données D1. Pour créer un nouveau projet à partir du modèle epicflare à la place, le README indique npx create-epicflare. D'autres chemins de configuration et attentes sont dans docs/contributing/getting-started.md, et les contributeurs et agents sont dirigés vers AGENTS.md pour des conseils spécifiques au dépôt. L'intention du projet est documentée dans docs/contributing/project-intent.md. Documentation et contribution Le README lie la documentation couvrant la configuration, les variables d'environnement, les intégrations Cloudflare optionnelles, l'intention du projet, le développement et l'extension de Kody, l'utilisation de Kody via MCP, et le développement local et la vérification. Les demandes de tirage externes nécessitent un accord de licence de contributeur signé ; les paquets publics publiés via Kody n'utilisent pas cet accord. Le dépôt est sous licence Functional Source License 1.1 avec une future licence Apache 2.0, permettant l'utilisation, la copie, la modification, les œuvres dérivées, la performance publique, l'affichage et la redistribution à toute fin autre que l'utilisation concurrente, chaque version devenant disponible sous Apache 2.0 au deuxième anniversaire de sa sortie.