Об этом проекте

Kody — это платформа персонального ассистента, задуманная как дом для памяти, ключей, кода и автоматизаций AI-агента, с целью сохранения переносимости между совместимыми MCP-хостами. Она построена на Cloudflare Workers и Model Context Protocol и включает Remix UI, маршрутизацию запросов на базе Worker, инфраструктуру выполнения пакетов и MCP-эндпоинты, защищённые OAuth. Архитектура и охват Проект предпочитает компактную поверхность MCP с поиском и потоками выполнения в режиме Code Mode вместо большого статического каталога инструментов. Он описывается как многопользовательский персональный ассистент: каждый вошедший пользователь получает полностью изолированного ассистента, охватывающего пакеты, задачи, секреты, воспоминания и связанное состояние. Тесты и фикстуры могут создавать детерминированные локальные учётные записи, но ни одна учётная запись не имеет привилегий во время выполнения. В README указано, что проект является платформой персонального ассистента с лицензией Fair Source, а не универсальной обвязкой для агентов, и что ChatGPT — вероятный основной целевой хост, при этом сервер по возможности остаётся пригодным для использования из других MCP-хостов. Структура репозитория Репозиторий представляет собой монорепозиторий Nx. Общие модули находятся в packages/shared, воркер основного приложения — в packages/worker, соседние воркеры — в packages/platform-worker, packages/runtime-worker и packages/jobs-worker, а также mock Workers в packages/mock-servers. Производственная топология описана в docs/contributing/architecture. Описанный поток запросов таков: сначала обрабатываются запросы OAuth, затем запросы MCP, затем статические ресурсы; запросы, не относящиеся к ресурсам, передаются обработчику сервера и маршрутизатору, а клиентские ресурсы собираются в packages/worker/public и отдаются через привязку ASSETS. Технологический стек Среда выполнения: Cloudflare Workers. Фреймворк UI: Remix 3 (beta). Менеджер пакетов: npm. Рабочее пространство: Nx плюс npm workspaces. База данных: Cloudflare D1. Сессии/OAuth: Cloudflare KV. Состояние MCP: Durable Objects на kody-platform. E2E-тестирование: Playwright. Сборщик: Vite. Начало работы Установите зависимости командой npm install и запустите сервер разработки командой npm run dev. Сервер разработки по умолчанию работает на localhost:3742, при этом CLI выбирает следующий свободный порт и выводит итоговый URL; Wrangler автоматически управляет локальной средой выполнения Cloudflare Workers и базой данных D1. Чтобы вместо этого создать новый проект из шаблона epicflare, README указывает на npx create-epicflare. Дополнительные пути настройки и ожидания описаны в docs/contributing/getting-started.md, а контрибьюторы и агенты направляются к AGENTS.md за рекомендациями, специфичными для репозитория. Намерения проекта описаны в docs/contributing/project-intent.md. Документация и участие README ссылается на документацию, охватывающую настройку, переменные окружения, дополнительные интеграции Cloudflare, намерения проекта, разработку и расширение Kody, использование Kody через MCP, а также локальную разработку и проверку. Внешние pull request требуют подписанного входящего Contributor License Agreement; публичные пакеты, публикуемые через Kody, этот CLA не используют. Репозиторий лицензирован по Functional Source License 1.1 с будущей лицензией Apache 2.0, что разрешает использование, копирование, модификацию, производные работы, публичное исполнение, показ и распространение для любых целей, кроме Competing Use, при этом каждая версия становится доступной под Apache 2.0 во вторую годовщину её выпуска.