# Sur quoi tourne Maguyva

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

Conçue pour la vitesse, la facilité de débogage et l'amélioration continue : une infrastructure éprouvée au cœur du système, des composants sur mesure là où l'intelligence du code l'exige.

- PostgreSQL + Lance
- Recherche vectorielle quantifiée
- Moteur de langages de code
- MCP partout
- 285+ langages

## Ce qui tourne en production

Voici les couches essentielles qui ont survécu à de multiples itérations. Chacune a mérité sa place en facilitant le débogage ou en réduisant la friction dans l'exécution des agents.

### PostgreSQL + Lance

*Base de données*

Stockage et index partitionnés par tenant. Votre code reste isolé, sans mélange d'index entre utilisateurs.

### Voyage AI: voyage-4-large

*Embeddings*

Embeddings de code à haut rappel pour la recherche, la récupération, et l'ancrage des agents.

### Binary Quantized HNSW

*Recherche vectorielle*

Embeddings compressés en signatures de 2048 bits et indexés avec HNSW. Réduction de stockage par 32, recherche à faible latence, zéro infrastructure supplémentaire.

### Moteur de langages de code

*Moteur de langages*

Une stack Tree-sitter fortement modifiée, avec grammaires personnalisées, heuristiques de handlers, et une couverture d'extraction sur 285 langages

### Protocole MCP

*Protocole*

Serveur MCP distant pour Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop et autres clients compatibles MCP. 11 outils exécutés dans un Cloudflare Worker TypeScript avec transport streamable HTTP natif.

### Lance colonnaire + R2

*Cache*

Embeddings en cache colonnaire, synchronisés dans le cloud

## La stack après les impasses

Maguyva n'a pas pris cette forme d'un seul coup. Chaque couche a survécu parce qu'elle rendait le fonctionnement du système plus facile à comprendre, son exploitation moins coûteuse ou son débogage plus simple sous pression.

Les expérimentations d'orchestration ont commencé plus tôt. Cette chronologie démarre en septembre 2025, quand le produit Maguyva lui-même a pris forme.

- **2025-Q3** (fondation): Début du développement ciblé de Maguyva → Voyage voyage-code-3. La direction produit se précise et la boucle d'itération rapide démarre
- **2025-Q3** (stockage): Couche de récupération vectorielle binaire. Recherche quantifiée avec index compacts, pas de stack vectorielle séparée
- **2025-Q4** (moteur-ast): Le moteur de langages de code entre en service. Requêtes personnalisées, replis de parseur, et heuristiques à base de handlers sur 285 langages
- **2025-Q4** (recherche): Recherche par fusion multimodale. Récupération classée sur les index sémantique, texte, AST, et graphe en une seule requête
- **2026-Q1** (cache): Synchro Lance colonnaire + R2. Cache colonnaire côté serveur, démarrages à froid plus rapides
- **2026-Q1** (qualité): Framework de validation sur 285 langages. Tests d'extraction automatisés sur chaque langage pris en charge
- **2026-Q1** (lancement): Lancement public sur maguyva.ai. 7 mois entre le début du développement ciblé et la disponibilité publique
- **2026-Q2** (protocol): Service MCP sur Cloudflare Worker en TypeScript. Transport streamable HTTP natif, latence réduite, remplacé sans interrompre le trafic en production
- **NOW** (embeddings): Embeddings de production → voyage-4-large. recherche sémantique à rappel plus élevé après le basculement de voyage-code-3

## On tourne sur ce qu'on livre

Maguyva est construit par des agents qui tournent sur Maguyva.

Notre système d'orchestration coordonne des agents IA spécialisés qui utilisent les mêmes outils MCP, les mêmes index de recherche, et la même infrastructure de production que vous. Il n'existe pas de version interne. La page équipe indique « 1x Maguyva (149 $) — on se paie nous-mêmes. » Ce n'est pas une blague. C'est la facture.

// le client zéro livre en production tous les jours

## Les règles qui ont survécu à la production

Voici les contraintes qui sont restées utiles en production. Il s'agit moins d'idéologie que de garder le système compréhensible pendant que les agents y apportent des changements à grande vitesse.

### Pas de repli silencieux

Échouer vite, corriger vite. Chaque erreur remonte immédiatement. Pas de fonctionnement dégradé masquant les erreurs en production.

*// panique > corruption silencieuse*

### RPC d'abord

Logique côté base de données pour la performance. Les fonctions PostgreSQL s'exécutent au plus près des données, ce qui élimine les allers-retours.

*// fonctions PostgreSQL, 0 ORM*

### CQRS

Chemins d'écriture et de lecture séparés. Le pipeline d'indexation écrit, les outils MCP lisent. Des stratégies d'optimisation différentes.

*// écritures : par lots | lectures : en cache*

### UUID déterministes

Cohérence de cache sans requêtes en base. Même entrée = même ID. Opérations idempotentes par conception.

*// uuid5(namespace, content_hash)*

La meilleure architecture, c'est celle qu'on peut déboguer à 3h du matin. (On l'a testé.)

// dernière mise à jour : 2026-10

[Essayez-le sur votre dépôt](https://app.maguyva.ai/auth/sign-up?plan=free)

## Où vit votre code

Aucun mystère. Voici exactement ce qui arrive à votre code quand vous connectez un dépôt.

- **Serveurs bare-metal, US East** (Calcul): Machines bare-metal à Ashburn, optimisées pour le débit d'indexation plutôt que des instances génériques bruyantes.
- **CDN mondial Cloudflare** (Périphérie): Réponses API et MCP mises en cache en périphérie. Les assets statiques sont servis depuis le réseau mondial de Cloudflare.
- **Partitionnement par tenant, par espace de travail** (Isolation): Chaque espace de travail dispose d'index de dépôts scopés par tenant, sur tout le pipeline et la base de données. Nous utilisons le code des clients pour fournir de l'intelligence de code, pas pour entraîner des modèles ou revendre des données.
- **Immatriculée à Singapour** (Entité): UT International PTE. LTD. Juridiction réelle, entité réelle.
- **Retirez un dépôt, retirez l'index** (Suppression): Déconnectez un dépôt et Maguyva retire le code source indexé actif, les embeddings, et les données de graphe du service. Les sauvegardes résiduelles expirent selon le calendrier de rétention.
- **Besoin d'UE ou d'AU ?** (Régions): Des régions de déploiement supplémentaires, ça se discute avec les clients ayant des exigences de résidence des données.

## Prochaines étapes

- [Démarrer](https://maguyva.ai/fr/docs): Indexez votre premier dépôt en quelques minutes.
- [Voir les tarifs](https://maguyva.ai/fr/pricing): Par espace de travail, pas par utilisateur. Démarrez gratuitement.
- [Rencontrer l'équipe](https://maguyva.ai/fr/team): 2 humains et un essaim d'agents IA.
- [Lire le blog](https://maguyva.ai/fr/blog): Notes techniques depuis les coulisses.
