# На чём работает Maguyva Canonical source: https://maguyva.ai/ru/stack License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license). Создан ради скорости, отлаживаемости и непрерывного улучшения: проверенная инфраструктура в основе и специализированные компоненты там, где этого требует интеллектуальный анализ кода. - PostgreSQL + Lance - Квантованный векторный поиск - Языковой движок для кода - MCP везде - 285+ языков ## Что работает в продакшне Это ключевые слои, которые остались после множества итераций. Каждый из них заслужил своё место, упрощая отладку или снижая трение в работе агентов. ### PostgreSQL + Lance *База данных* Хранилище и индексы с разделением по тенантам. Ваш код остаётся изолированным, без смешивания индексов между пользователями. ### Voyage AI: voyage-4-large *Эмбеддинги* Эмбеддинги кода с высокой полнотой для поиска, извлечения и обоснования ответов агента. ### Binary Quantized HNSW *Векторный поиск* Эмбеддинги сжимаются до 2048-битных сигнатур и индексируются с помощью HNSW. Сокращение объёма хранения в 32 раза, поиск с низкой задержкой, никакой дополнительной инфраструктуры. ### Языковой движок для кода *Языковой движок* Сильно доработанный стек на базе Tree-sitter с собственными грамматиками, эвристиками обработчиков и покрытием извлечения для 285 языков ### Протокол MCP *Протокол* Удалённый MCP-сервер. Поддерживаемые клиенты: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop и другие клиенты с поддержкой MCP. Количество инструментов: 11. Сервер работает на Cloudflare Worker с TypeScript и встроенной поддержкой транспорта streamable HTTP. ### Колоночный Lance + R2 *Кэш* Эмбеддинги с колоночным кэшированием и облачной синхронизацией ## Стек после тупиков Нынешняя архитектура Maguyva сложилась не сразу. Каждый слой сохранился, потому что упрощал понимание системы, удешевлял её эксплуатацию или облегчал отладку в сложных условиях. Эксперименты с оркестрацией начались раньше. Эта хронология начинается в сентябре 2025 года, когда сам продукт Maguyva обрёл чёткие очертания. - **2025-Q3** (фундамент): Начало сфокусированной разработки Maguyva → Voyage voyage-code-3. Направление продукта закрепляется, начинается цикл быстрых итераций - **2025-Q3** (хранилище): Слой бинарного векторного поиска. Квантованный поиск с компактными индексами, без отдельного векторного стека - **2025-Q4** (ast-движок): Языковой движок для кода выходит в строй. Собственные запросы, резервные парсеры и эвристики на основе обработчиков для 285 языков - **2025-Q4** (поиск): Мультимодальный поиск с объединением результатов. Ранжированный поиск по семантическим, текстовым, AST- и графовым индексам в одном запросе - **2026-Q1** (кэширование): Синхронизация Lance columnar + R2. Колоночный кэш на стороне сервера, более быстрый холодный старт - **2026-Q1** (качество): Фреймворк валидации для 285 языков. Автоматизированное тестирование извлечения для каждого поддерживаемого языка - **2026-Q1** (запуск): Публичный запуск на maguyva.ai. 7 месяцев от начала сфокусированной разработки до публичной доступности - **2026-Q2** (протокол): MCP-сервис на Cloudflare Worker с TypeScript. Встроенная поддержка транспорта streamable HTTP, меньшая задержка, переключение при работающем сервисе - **NOW** (эмбеддинги): Эмбеддинги в продакшне → voyage-4-large. Семантический поиск с более высокой полнотой после перехода с voyage-code-3 ## Мы работаем на том, что выпускаем Maguyva создаётся агентами, которые работают на Maguyva. Наша система оркестрации координирует специализированных ИИ-агентов, которые используют те же MCP-инструменты, поисковые индексы и продакшн-инфраструктуру, что и вы. Никакой внутренней версии не существует. На странице команды указано: “1x Maguyva ($149) — платим сами себе.” Это не шутка. Это счёт. // клиент номер ноль отправляет код в продакшн ежедневно ## Правила, которые выжили в продакшне Это ограничения, которые остались полезными в продакшне. Дело тут не в идеологии, а в том, чтобы система оставалась понятной, пока агенты вносят изменения на скорости. ### Никаких тихих фолбэков Быстро падаем, быстро чиним. Каждая ошибка всплывает немедленно. Никакой плавной деградации, скрывающей баги в продакшне. *// паника > тихая порча данных* ### RPC-First Логика на стороне базы данных ради производительности. Функции PostgreSQL выполняются рядом с данными, устраняя лишние сетевые обращения. *// функции PostgreSQL, 0 ORM* ### CQRS Раздельные пути записи и чтения. Пайплайн индексации пишет, MCP-инструменты читают. Разные стратегии оптимизации. *// записи: пакетно | чтения: кэшируются* ### Детерминированные UUID Согласованность кэша без обращений к базе данных. Одинаковый вход = одинаковый ID. Идемпотентные операции по замыслу. *// uuid5(namespace, content_hash)* Лучшая архитектура — та, которую можно отладить в 3 часа ночи. (Мы это проверяли.) // обновлено: 2026-10 [Попробуйте на своём репозитории](https://app.maguyva.ai/auth/sign-up?plan=free) ## Где живёт ваш код Никакой загадки. Вот что именно происходит с вашим кодом, когда вы подключаете репозиторий. - **Физические серверы, US East** (Вычисления): Физические серверы в Ашберне, настроенные под пропускную способность индексации, а не шумные инстансы общего назначения. - **Глобальный CDN Cloudflare** (Edge): Ответы API и MCP кэшируются на edge-серверах. Статические ресурсы отдаются из глобальной сети Cloudflare. - **Разделение по тенантам на уровне рабочего пространства** (Изоляция): Каждое рабочее пространство получает индексы репозиториев, изолированные по тенанту, — в пайплайне и в базе данных. Мы используем код клиентов, чтобы предоставлять интеллектуальный анализ кода, а не для обучения моделей или продажи данных. - **Зарегистрировано в Сингапуре** (Юрлицо): UT International PTE. LTD. Реальная юрисдикция, реальное юридическое лицо. - **Удалите репозиторий — удалится и индекс** (Удаление): Отключите репозиторий, и Maguyva удалит активный проиндексированный исходный код, эмбеддинги и данные графа из сервиса. Оставшиеся резервные копии удаляются по истечении срока хранения. - **Нужен регион в ЕС или Австралии?** (Регионы): Дополнительные регионы развёртывания обсуждаются с клиентами, для которых важны требования к резидентности данных. ## Следующие шаги - [Начать](https://maguyva.ai/ru/docs): Проиндексируйте первый репозиторий за несколько минут. - [Смотреть тарифы](https://maguyva.ai/ru/pricing): Плата за рабочее пространство, а не за пользователя. Начните бесплатно. - [Познакомьтесь с командой](https://maguyva.ai/ru/team): 2 человека и рой ИИ-агентов. - [Читать блог](https://maguyva.ai/ru/blog): Технические заметки о разработке.