# Su cosa gira Maguyva Canonical source: https://maguyva.ai/it/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). Costruito per velocità, debuggabilità e miglioramento continuo: infrastruttura collaudata al centro, componenti su misura dove l'intelligenza del codice lo richiede. - PostgreSQL + Lance - Ricerca vettoriale quantizzata - Motore linguistico del codice - MCP ovunque - Oltre 285 linguaggi ## Cosa gira in produzione Questi sono i livelli fondamentali rimasti dopo molte iterazioni. Ognuno si è guadagnato il suo posto rendendo il debug più semplice o riducendo l'attrito nell'esecuzione degli agenti. ### PostgreSQL + Lance *Banca dati* Storage e indici partizionati per tenant. Il tuo codice resta isolato, senza mescolanza di indici tra utenti. ### Voyage AI: voyage-4-large *Embeddings* Embedding del codice ad alto recall per ricerca, recupero e fondatezza delle risposte degli agenti. ### Binary Quantized HNSW *Ricerca vettoriale* Embedding compressi in firme a 2048 bit e indicizzati con HNSW. Riduzione dello storage di 32x, ricerca a bassa latenza, zero infrastruttura aggiuntiva. ### Motore linguistico del codice *Motore linguistico* Uno stack Tree-sitter pesantemente modificato, con grammatiche personalizzate, euristiche degli handler e copertura di estrazione per 285 linguaggi ### Protocollo MCP *Protocollo* Server MCP remoto per Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop e altri client compatibili con MCP. 11 strumenti su un Cloudflare Worker in TypeScript con trasporto nativo streamable HTTP. ### Lance columnar + R2 *Cache* Embedding in cache colonnare, sincronizzati con il cloud ## Lo stack dopo i vicoli ciechi Maguyva non è arrivato a questa forma tutto in una volta. Ogni livello è sopravvissuto perché ha reso il sistema più facile da comprendere, più economico da gestire o più facile da debuggare sotto pressione. Gli esperimenti di orchestrazione sono iniziati prima. Questa cronologia inizia a settembre 2025, quando il prodotto Maguyva vero e proprio ha preso forma. - **2025-Q3** (fondamenta): Inizia lo sviluppo mirato di Maguyva → Voyage voyage-code-3. La direzione del prodotto si consolida e inizia il ciclo di iterazione rapida - **2025-Q3** (archiviazione): Livello di recupero vettoriale binario. Ricerca quantizzata con indici compatti, senza uno stack vettoriale separato - **2025-Q4** (motore-ast): Il motore linguistico del codice va online. Query personalizzate, fallback del parser ed euristiche basate su handler per 285 linguaggi - **2025-Q4** (ricerca): Ricerca a fusione multimodale. Recupero di risultati ordinati per pertinenza dagli indici semantici, testuali, AST e a grafo in un'unica query - **2026-Q1** (cache): Sincronizzazione Lance columnar + R2. Cache colonnare lato server, avvii a freddo più rapidi - **2026-Q1** (qualità): Framework di validazione per 285 linguaggi. Test di estrazione automatizzati su ogni linguaggio supportato - **2026-Q1** (lancio): Lancio pubblico su maguyva.ai. 7 mesi dallo sviluppo mirato alla disponibilità pubblica - **2026-Q2** (protocollo): Servizio MCP su Cloudflare Worker con TypeScript. Trasporto nativo streamable HTTP, latenza inferiore, sostituito mentre il traffico in produzione era attivo - **NOW** (embeddings): Embedding di produzione → voyage-4-large. Ricerca semantica con recall più elevato dopo la migrazione da voyage-code-3 ## Usiamo quello che rilasciamo Maguyva è costruito da agenti che girano su Maguyva. Il nostro sistema di orchestrazione coordina agenti IA specializzati che usano gli stessi strumenti MCP, gli stessi indici di ricerca e la stessa infrastruttura di produzione che ottieni tu. Non esiste una versione interna. La pagina del team elenca “1x Maguyva ($149) — paghiamo noi stessi.” Non è una battuta. È la fattura. // il cliente zero rilascia in produzione ogni giorno ## Le regole sopravvissute alla produzione Questi sono i vincoli rimasti utili in produzione. Riguardano meno l'ideologia e più il mantenere il sistema comprensibile mentre gli agenti apportano modifiche a grande velocità. ### Niente fallback silenziosi Fallisci in fretta, correggi in fretta. Ogni errore emerge immediatamente. Nessun degrado controllato che nasconde bug in produzione. *// panico > corruzione silenziosa* ### RPC innanzitutto Logica lato database per le prestazioni. Le funzioni PostgreSQL vengono eseguite vicino ai dati, eliminando i round trip. *// funzioni PostgreSQL, 0 ORM* ### CQRS Percorsi separati per scrittura e lettura. La pipeline di indicizzazione scrive, gli strumenti MCP leggono. Strategie di ottimizzazione diverse. *// scritture: in batch | letture: in cache* ### UUID deterministici Coerenza della cache senza interrogazioni al database. Stesso input = stesso ID. Operazioni idempotenti per progettazione. *// uuid5(namespace, content_hash)* La migliore architettura è quella che puoi debuggare alle 3 del mattino. (L'abbiamo testato.) // ultimo aggiornamento: 2026-10 [Provalo sul tuo repository](https://app.maguyva.ai/auth/sign-up?plan=free) ## Dove vive il tuo codice Nessun mistero. Ecco esattamente cosa succede al tuo codice quando colleghi un repository. - **Server bare-metal, US East** (Calcolo): Macchine bare-metal ad Ashburn, ottimizzate per il throughput di indicizzazione anziché istanze generiche soggette a interferenze da altri carichi. - **CDN globale Cloudflare** (Edge): Risposte API e MCP messe in cache all'edge. Asset statici serviti dalla rete globale di Cloudflare. - **Partizionato per tenant, per workspace** (Isolamento): Ogni workspace ottiene indici di repository con ambito per tenant, lungo tutta la pipeline e il database. Usiamo il codice dei clienti per fornire intelligenza del codice, non per addestrare modelli o vendere dati. - **Costituita a Singapore** (Entità): UT International PTE. LTD. Giurisdizione reale, entità reale. - **Rimuovi un repository, rimuovi l'indice** (Eliminazione): Scollega un repository e Maguyva rimuove dal servizio il codice sorgente indicizzato attivo, gli embedding e i dati del grafo. I backup residui scadono secondo il piano di conservazione. - **Ti serve UE o AU?** (Regioni): Possiamo valutare regioni di deployment aggiuntive con i clienti che hanno requisiti di residenza dei dati. ## Prossimi passi - [Inizia](https://maguyva.ai/it/docs): Indicizza il tuo primo repo in pochi minuti. - [Vedi i prezzi](https://maguyva.ai/it/pricing): Per workspace, non per utente. Inizia gratis. - [Conosci il team](https://maguyva.ai/it/team): 2 umani e uno sciame di agenti IA. - [Leggi il blog](https://maguyva.ai/it/blog): Note tecniche dallo sviluppo.