# Millä Maguyva toimii

Canonical source: https://maguyva.ai/fi/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).

Rakennettu nopeutta, vianetsittävyyttä ja jatkuvaa parantamista silmällä pitäen: koeteltu infrastruktuuri ytimessä, tarkoitukseen räätälöidyt komponentit siellä missä koodiäly niitä vaatii.

- PostgreSQL + Lance
- Kvantisoitu vektorihaku
- Koodikielimoottori
- MCP kaikkialla
- 285+ kieltä

## Mikä pyörii tuotannossa

Nämä ovat ydinkerrokset, jotka jäivät jäljelle useiden iteraatioiden jälkeen. Jokainen niistä ansaitsi paikkansa tekemällä debuggauksesta helpompaa tai poistamalla kitkaa agenttien suorituksesta.

### PostgreSQL + Lance

*Tietokanta*

Vuokraajakohtaisesti osioitu tallennustila ja indeksit. Koodisi pysyy eristettynä, eikä indeksejä sekoiteta käyttäjien välillä.

### Voyage AI: voyage-4-large

*Upotukset*

Korkean kattavuuden koodiupotuksia agenttien hakuun, noutoon ja ankkurointiin.

### Binary Quantized HNSW

*Vektorihaku*

Upotukset pakataan 2048-bittisiksi allekirjoituksiksi ja indeksoidaan HNSW:llä. 32-kertainen tallennustilan säästö, pienen viiveen haku, ei yhtään ylimääräistä infrastruktuuria.

### Koodikielimoottori

*Kielimoottori*

Voimakkaasti muokattu Tree-sitter-pino mukautetuilla kieliopeilla, käsittelijäheuristiikoilla ja 285 kielen laajuisella poimintakattavuudella

### MCP-protokolla

*Protokolla*

MCP-etäpalvelin Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop ja muut MCP-yhteensopivat asiakasohjelmat:lle. 11 työkalua TypeScript Cloudflare Worker:ssä, jossa on natiivi suoratoistettava HTTP-siirto.

### Lance-sarakemuoto + R2

*Välimuisti*

Sarakemuotoisesti välimuistoidut, pilveen synkronoidut upotukset

## Pino umpikujien jälkeen

Maguyva ei saanut tätä muotoa kerralla. Jokainen kerros säilyi, koska se teki järjestelmästä nopeamman hahmottaa, halvemman ylläpitää tai helpomman debugata paineen alla.

Orkestrointikokeilut alkoivat aiemmin. Tämä aikajana alkaa syyskuussa 2025, jolloin itse Maguyva-tuote tarkentui fokukseen.

- **2025-Q3** (perusta): Kohdistettu Maguyva-rakennus alkaa → Voyage voyage-code-3. Tuotesuunta vakiintuu ja nopea iteraatiosilmukka alkaa
- **2025-Q3** (tallennus): Binäärinen vektorinoutokerros. Kvantisoitu haku kompakteilla indekseillä, ei erillistä vektoripinoa
- **2025-Q4** (ast-moottori): Koodikielimoottori käynnistyy. Mukautettuja kyselyitä, jäsentimen varajärjestelyjä ja käsittelijäpohjaisia heuristiikkoja 285 kielen kattavuudella
- **2025-Q4** (haku): Monimodaalinen fuusiohaku. Pisteytetty haku semanttisten, teksti-, AST- ja graafi-indeksien yli yhdellä kyselyllä
- **2026-Q1** (välimuisti): Lance-sarakemuoto + R2-synkronointi. Palvelinpuolen sarakemuotoinen välimuisti, nopeammat kylmäkäynnistykset
- **2026-Q1** (laatu): 285 kielen validointikehys. Automatisoitu poimintatestaus jokaisella tuetulla kielellä
- **2026-Q1** (julkaisu): Julkinen julkaisu osoitteessa maguyva.ai. 7 kuukautta kohdistetusta rakennuksesta julkiseen saatavuuteen
- **2026-Q2** (protokolla): TypeScript Cloudflare Worker MCP (protokollipalvelu). Natiivi suoratoistettavissa oleva HTTP-siirto, pienempi viive, vaihdettu ilman live-liikenteen keskeytystä
- **NOW** (upotukset): Tuotannon embeddingit → voyage-4-large. Paremman hakukattavuuden semanttinen haku voyage-code-3:sta siirtymisen jälkeen

## Käytämme itse sitä, mitä toimitamme

Maguyva-palvelun rakentavat agentit, jotka toimivat Maguyva-palvelun päällä.

Orkestrointijärjestelmämme koordinoi erikoistuneita tekoälyagentteja, jotka käyttävät samoja MCP-työkaluja, hakuindeksejä ja tuotantoinfrastruktuuria kuin sinäkin. Sisäistä versiota ei ole. Tiimisivulla lukee “1x Maguyva (149 $) — maksamme itsellemme.” Se ei ole vitsi. Se on lasku.

// asiakas nolla julkaisee tuotantoon päivittäin

## Säännöt, jotka selvisivät tuotannosta

Nämä ovat rajoitteet, jotka pysyivät hyödyllisinä tuotannossa. Kyse on vähemmän ideologiasta ja enemmän siitä, että järjestelmä pysyy ymmärrettävänä, kun agentit tekevät muutoksia täydellä vauhdilla.

### Ei piilotettuja varakeinoja

Epäonnistu nopeasti, korjaa nopeasti. Jokainen virhe tulee esiin heti. Ei hallittua palvelutason heikkenemistä, joka piilottaisi bugeja tuotannossa.

*// paniikki > hiljainen korruptio*

### RPC ensin

Tietokantapuolen logiikkaa suorituskyvyn vuoksi. PostgreSQL-funktiot suoritetaan lähellä dataa, mikä poistaa turhat edestakaiset kutsut.

*// PostgreSQL-funktioita, 0 ORM:ää*

### CQRS

Erilliset kirjoitus- ja lukupolut. Indeksointiputki kirjoittaa, MCP-työkalut lukevat. Eri optimointistrategiat.

*// kirjoitukset: eräajoina | luvut: välimuistissa*

### Deterministiset UUID:t

Välimuistin yhtenäisyys ilman tietokantahakuja. Sama syöte = sama tunniste. Idempotentit toiminnot suunnittelusta lähtien.

*// uuid5(namespace, content_hash)*

Paras arkkitehtuuri on sellainen, jota pystyt debuggaamaan kolmelta yöllä. (Olemme testanneet tämän.)

// viimeksi päivitetty: 2026-10

[Kokeile omassa repossasi](https://app.maguyva.ai/auth/sign-up?plan=free)

## Missä koodisi asuu

Ei mitään mystiikkaa. Tässä tarkalleen se, mitä koodillesi tapahtuu, kun yhdistät repon.

- **Metallipalvelimet, US East** (Laskenta): Paljaan raudan koneita Ashburnissa, viritetty indeksoinnin läpäisykykyyn sen sijaan että käytettäisiin meluisia yleiskäyttöisiä instansseja.
- **Cloudflare-verkoston globaali CDN** (Reuna): API- ja MCP-vastaukset tallennetaan välimuistiin reunalla. Staattiset resurssit tarjoillaan Cloudflare-verkoston maailmanlaajuisesta verkosta.
- **Vuokraajakohtaisesti osioitu työtilaa kohden** (Eristys): Jokainen työtila saa vuokraajakohtaiset repositorioindeksit koko putken ja tietokannan läpi. Käytämme asiakkaiden koodia tarjotaksemme koodiälyä, emme mallien kouluttamiseen tai datan myymiseen.
- **Rekisteröity Singaporeen** (Yhtiö): UT International PTE. LTD. Todellinen lainkäyttöalue, todellinen oikeushenkilö.
- **Poista repo, poista indeksi** (Poisto): Kun katkaiset repon yhteyden, Maguyva poistaa aktiivisen indeksoidun lähdekoodin, upotukset ja graafidatan palvelusta. Jäljelle jäävät varmuuskopiot vanhenevat säilytysaikataulun mukaisesti.
- **Tarvitsetko EU:ta tai AU:ta?** (Alueet): Palvelun käyttöönotosta muilla alueilla voidaan keskustella asiakkaiden kanssa, joilla on tietojen sijaintia koskevia vaatimuksia.

## Seuraavaksi

- [Aloita](https://maguyva.ai/fi/docs): Indeksoi ensimmäinen repo minuuteissa.
- [Katso hinnoittelu](https://maguyva.ai/fi/pricing): Työtilakohtainen, ei käyttäjäkohtainen. Aloita ilmaiseksi Free-tasolla.
- [Tutustu tiimiin](https://maguyva.ai/fi/team): 2 ihmistä ja tekoälyagenttiparvi.
- [Lue blogia](https://maguyva.ai/fi/blog): Teknisiä muistiinpanoja rakennusprosessista.