# На чому працює Maguyva

Canonical source: https://maguyva.ai/uk/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 columnar + 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** (Периферія): Відповіді API та MCP кешуються на периферії (edge). Статичні ресурси віддаються з глобальної мережі Cloudflare.
- **Розділення за орендарями для кожного робочого простору** (Ізоляція): Кожен робочий простір отримує індекси репозиторіїв, ізольовані на рівні орендаря, у пайплайні та базі даних. Ми використовуємо код клієнтів, щоб надавати інтелект коду, а не тренувати моделі чи продавати дані.
- **Зареєстровано в Сінгапурі** (Юрособа): UT International PTE. LTD. Реальна юрисдикція, реальна юридична особа.
- **Видаліть репозиторій — видаліть індекс** (Видалення): Відключіть репозиторій, і Maguyva видалить активний проіндексований вихідний код, ембединги та графові дані із сервісу. Залишкові резервні копії видаляються за графіком зберігання.
- **Потрібен регіон EU чи AU?** (Регіони): Додаткові регіони розгортання обговорюються з клієнтами, які мають вимоги щодо резидентності даних.

## Наступні кроки

- [Розпочати](https://maguyva.ai/uk/docs): Проіндексуйте перший репозиторій за лічені хвилини.
- [Переглянути ціни](https://maguyva.ai/uk/pricing): Оплата за робочий простір, а не за користувача. Почніть безкоштовно.
- [Познайомтеся з командою](https://maguyva.ai/uk/team): 2 людини та рій ШІ-агентів.
- [Читати блог](https://maguyva.ai/uk/blog): Технічні нотатки з розробки.