kody

Kody es una plataforma de asistente personal diseñada como hogar para la memoria, claves, código y automatizaciones de un agente de IA, con el objetivo de mantenerse portátil entre hosts MCP compatibles. Está construida sobre Cloudflare Workers y el Model Context Protocol, e incluye una interfaz Remix, enrutamiento de solicitudes basado en Workers, infraestructura de ejecución de paquetes y endpoints MCP protegidos con OAuth. Arquitectura y alcance El proyecto favorece una superficie MCP compacta con flujos de búsqueda y ejecución en Modo Código en lugar de un gran catálogo estático de herramientas. Se describe como un asistente personal multiusuario: cada usuario autenticado obtiene un asistente completamente aislado que abarca paquetes, trabajos, secretos, memorias y estado relacionado. Las pruebas y los fixtures pueden sembrar cuentas locales deterministas, pero ninguna cuenta tiene privilegios en tiempo de ejecución. El README indica que el proyecto es una plataforma de asistente personal Fair Source en lugar de un marco de agente de propósito general, y que ChatGPT es probablemente el host principal objetivo, manteniendo el servidor utilizable desde otros hosts MCP cuando sea práctico. Estructura del repositorio El repositorio es un monorepo Nx. Los módulos compartidos viven en packages/shared, el worker de la aplicación de origen en packages/worker, con workers hermanos en packages/platform-worker, packages/runtime-worker y packages/jobs-worker, además de Workers simulados en packages/mock-servers. La topología de producción está documentada en docs/contributing/architecture. El flujo de solicitudes descrito es: las solicitudes OAuth se manejan primero, luego las solicitudes MCP, luego los activos estáticos; las solicitudes que no son de activos pasan al manejador del servidor y al enrutador, y los activos del cliente se empaquetan en packages/worker/public y se sirven mediante el enlace ASSETS. Stack tecnológico Tiempo de ejecución: Cloudflare Workers. Framework de UI: Remix 3 (beta). Gestor de paquetes: npm. Workspace: Nx más npm workspaces. Base de datos: Cloudflare D1. Sesión/OAuth: Cloudflare KV. Estado MCP: Durable Objects en kody-platform. Pruebas E2E: Playwright. Empaquetador: Vite. Primeros pasos Instala las dependencias con npm install e inicia el servidor de desarrollo con npm run dev. El servidor de desarrollo se ejecuta en localhost:3742 de forma predeterminada, y la CLI elige el siguiente puerto libre e imprime la URL resuelta; Wrangler gestiona automáticamente el entorno local de Cloudflare Workers y la base de datos D1. Para crear un nuevo proyecto desde la plantilla epicflare, el README apunta a npx create-epicflare. Las rutas de configuración adicionales y las expectativas están en docs/contributing/getting-started.md, y se dirige a contribuyentes y agentes a AGENTS.md para obtener orientación específica del repositorio. La intención del proyecto está documentada en docs/contributing/project-intent.md. Documentación y contribución El README enlaza documentación que cubre la configuración, variables de entorno, integraciones opcionales de Cloudflare, intención del proyecto, desarrollo y extensión de Kody, uso de Kody a través de MCP, y desarrollo y verificación local. Las pull requests externas requieren un Acuerdo de Licencia de Contribuyente entrante firmado; los paquetes públicos publicados a través de Kody no utilizan ese CLA. El repositorio está licenciado bajo la Functional Source License 1.1 con una licencia futura Apache 2.0, permitiendo el uso, copia, modificación, obras derivadas, ejecución pública, exhibición y redistribución para cualquier propósito que no sea Uso Competitivo, y cada versión estará disponible bajo Apache 2.0 en el segundo aniversario de su lanzamiento.