# Na čem Maguyva běží Canonical source: https://maguyva.ai/cs/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). Postavený pro rychlost, ladatelnost a průběžné vylepšování: ověřená infrastruktura v jádru, účelově navržené komponenty tam, kde to vyžaduje code intelligence. - PostgreSQL + Lance - Kvantizované vektorové vyhledávání - Jazykový motor kódu - MCP všude - 285+ jazyků ## Co běží v produkci Toto jsou klíčové vrstvy, které přežily po několika iteracích. Každá z nich si své místo vysloužila tím, že usnadnila ladění nebo odstranila tření z běhu agentů. ### PostgreSQL + Lance *Databáze* Úložiště a indexy rozdělené podle tenantů. Váš kód zůstává izolovaný, bez míchání indexů mezi uživateli. ### Voyage AI: voyage-4-large *Embeddings* Embeddingy kódu s vysokou úplností (recall) pro vyhledávání, získávání dat a podložení odpovědí agentů. ### Binary Quantized HNSW *Vektorové vyhledávání* Embeddingy komprimované na 2048bitové podpisy a indexované pomocí HNSW. 32× menší úložiště, vyhledávání s nízkou latencí, žádná další infrastruktura navíc. ### Jazykový motor kódu *Jazykový motor* Silně upravený stack Tree-sitter s vlastními gramatikami, heuristikami handlerů a pokrytím extrakce pro 285 jazyků ### Protokol MCP *Protokol* Vzdálený server MCP pro Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop a další klienti kompatibilní s MCP. 11 nástrojů na TypeScript Cloudflare Worker s nativním streamovatelným přenosem HTTP. ### Sloupcové úložiště Lance + R2 *Cache* Sloupcově cachované embeddingy synchronizované v cloudu ## Stack po slepých uličkách Maguyva nedostala tuto podobu naráz. Každá vrstva přežila proto, že usnadnila uvažování o systému, snížila provozní náklady nebo zjednodušila ladění pod tlakem. Experimenty s orchestrací začaly dřív. Tahle časová osa začíná v září 2025, kdy se produkt Maguyva sám dostal do ostrého fokusu. - **2025-Q3** (základ): Soustředěný vývoj Maguyva začíná → Voyage voyage-code-3. Směřování produktu se ustaluje a začíná rychlá iterační smyčka - **2025-Q3** (úložiště): Vrstva binárního vektorového vyhledávání. Kvantizované vyhledávání s kompaktními indexy, žádný samostatný vektorový stack - **2025-Q4** (motor-ast): Jazykový motor kódu jde do provozu. Vlastní dotazy, záložní parsery a heuristiky založené na handlerech napříč 285 jazyky - **2025-Q4** (vyhledávání): Multimodální fúzní vyhledávání. Řazené vyhledávání napříč sémantickými, textovými, AST a grafovými indexy v jediném dotazu - **2026-Q1** (cache): Sloupcové úložiště Lance + synchronizace R2. Sloupcová cache na straně serveru, rychlejší studené starty - **2026-Q1** (kvalita): Validační framework pro 285 jazyků. Automatizované testování extrakce napříč všemi podporovanými jazyky - **2026-Q1** (spuštění): Veřejné spuštění na maguyva.ai. 7 měsíců od soustředěného vývoje po veřejnou dostupnost - **2026-Q2** (protokol): TypeScript Cloudflare Worker MCP (protokolová služba). Nativní streamovatelný přenos HTTP, nižší latence, výměna bez přerušení živého provozu - **NOW** (embeddings): Produkční embeddingy → voyage-4-large. Sémantické vyhledávání s vyšší úplností po přechodu z voyage-code-3 ## Běžíme na tom, co dodáváme Maguyva vzniká díky agentům, kteří běží na platformě Maguyva. Náš orchestrační systém koordinuje specializované AI agenty, kteří používají stejné nástroje MCP, vyhledávací indexy a produkční infrastrukturu jako vy. Neexistuje žádná interní verze. Stránka týmu uvádí “1x Maguyva ($149) — platíme si sami.” To není vtip. To je faktura. // jsme svým prvním zákazníkem a nasazujeme do produkce každý den ## Pravidla, která přežila provoz Toto jsou omezení, která zůstala užitečná i v provozu. Nejde tolik o ideologii, jako spíš o to, aby systém zůstal srozumitelný, i když agenti dělají změny ve vysokém tempu. ### Žádné tiché fallbacky Selhat rychle, opravit rychle. Každá chyba se projeví okamžitě. Žádná elegantní degradace, která by v produkci skrývala chyby. *// panika > tiché poškození dat* ### RPC-First Logika na straně databáze kvůli výkonu. Funkce PostgreSQL běží blízko dat, což eliminuje zbytečné cesty tam a zpět. *// funkce PostgreSQL, 0 ORM* ### CQRS Oddělené cesty pro zápis a čtení. Indexovací pipeline zapisuje, nástroje MCP čtou. Odlišné strategie optimalizace. *// zápisy: dávkově | čtení: z cache* ### Deterministické UUID Koherence cache bez dotazů do databáze. Stejný vstup = stejné ID. Idempotentní operace už z návrhu. *// uuid5(namespace, content_hash)* Nejlepší architektura je ta, kterou dokážete ladit ve 3 ráno. (Otestovali jsme to.) // naposledy aktualizováno: 2026-10 [Vyzkoušejte to na svém repozitáři](https://app.maguyva.ai/auth/sign-up?plan=free) ## Kde žije váš kód Žádné záhady. Přesně tady je, co se stane s vaším kódem, když připojíte repozitář. - **Fyzické servery, US East** (Výpočet): Fyzické (bare-metal) stroje v Ashburnu, laděné na propustnost indexování místo hlučných univerzálních instancí. - **Globální CDN Cloudflare** (Edge): Odpovědi API a MCP se cachují na okraji sítě (edge). Statické soubory se servírují z globální sítě Cloudflare. - **Rozdělené podle tenantů, pro každý workspace zvlášť** (Izolace): Každý workspace má indexy repozitářů oddělené podle tenanta napříč pipeline i databází. Kód zákazníků používáme k poskytování code intelligence, ne k trénování modelů nebo prodeji dat. - **Založeno v Singapuru** (Entita): UT International PTE. LTD. Skutečná jurisdikce, skutečný právní subjekt. - **Odstraníte repozitář, zmizí i index** (Smazání): Odpojíte repozitář a Maguyva ze služby odstraní aktivně indexovaný zdrojový kód, embeddingy i data grafu. Zbytkové zálohy vyprší podle plánu uchovávání dat. - **Potřebujete EU nebo AU?** (Regiony): Další oblasti nasazení jsou téma k diskuzi pro zákazníky s požadavky na rezidenci dat. ## Další kroky - [Začněte](https://maguyva.ai/cs/docs): Zaindexujte své první repo za pár minut. - [Podívejte se na ceník](https://maguyva.ai/cs/pricing): Za pracovní prostor, ne za uživatele. Začít můžete zdarma. - [Poznejte tým](https://maguyva.ai/cs/team): 2 lidé a roj AI agentů. - [Přečtěte si blog](https://maguyva.ai/cs/blog): Technické poznámky z vývoje.