Questions fréquentes
Des réponses courtes, vérifiées contre le code publié. Les pages détaillées sont indiquées quand elles existent.
Comprendre
Que signifie « RAG against the machine » ?
RAG désigne la génération augmentée par récupération (Retrieval-Augmented Generation) : le modèle répond à partir de passages retrouvés dans vos documents, pas de sa seule mémoire. « Against the machine » rappelle le parti pris du projet : garder vos documents et vos modèles sur votre propre infrastructure. Le nom n’a aucun lien avec le groupe musical.
Qu’est-ce que RAGatm Open fait concrètement ?
Vous importez des documents dans un espace cloisonné, l’application les découpe et les indexe, puis vous posez des questions en langage naturel. La réponse est générée par un modèle local et cite les passages utilisés (document, page ou diapositive, extrait).
Les réponses sont-elles fiables ?
Elles sont sourcées : chaque réponse renvoie aux passages retrouvés, que vous pouvez ouvrir. Mais un modèle de langage peut se tromper ou résumer de travers ; vérifiez la source citée avant toute décision. Le modèle du profil Compact (1,5 milliard de paramètres) démontre le fonctionnement ; sa qualité documentaire n’est pas revendiquée.
RAGatm Open donne-t-il des conseils juridiques ?
Non. Il retrouve et résume des passages de vos documents. Il ne fournit ni conseil juridique, ni analyse réglementaire, ni garantie de conformité.
Données et souveraineté
Mes documents sont-ils envoyés à un service d’IA externe ?
Non dans la configuration qualifiée : tous les modèles s’exécutent localement derrière AI Gateway Open, la seule valeur admise pour le repli vers un fournisseur externe est none et des vérifications au démarrage refusent toute autre valeur. Les réseaux internes de la pile Compact n’ont pas de sortie Internet en fonctionnement nominal.
Est-ce conforme au RGPD ?
Le logiciel facilite la maîtrise des données (hébergement local, modèles locaux, sauvegardes contrôlées), mais la conformité d’un traitement dépend de l’exploitant : finalités, durées de conservation, droits d’accès, sécurité de l’hôte. Aucun logiciel n’est « conforme par défaut ».
Qui peut accéder à quoi ?
Les utilisateurs appartiennent à des workspaces avec des rôles (owner, admin, member, viewer) ; les documents vivent dans des espaces documentaires isolés les uns des autres. Chaque compte doit enrôler un second facteur TOTP ; il n’y a pas d’inscription publique.
Installer et faire tourner
Quel matériel faut-il ?
Le profil Compact est qualifié sur une machine x86_64 à 8 threads et 14 Go de RAM, sans GPU. Comptez environ 3 Go d’images applicatives et 4 Go de modèles, plus vos données. Un GPU n’est pas nécessaire ; les profils GPU ne sont pas qualifiés. Voir la page Installation.
Existe-t-il une image Docker prête à l’emploi ?
Non. Aucune image officielle n’est publiée : les images se construisent localement depuis les sources, avec des images de base épinglées par digest. Il n’y a pas d’installation en une commande.
Faut-il une connexion Internet ?
Uniquement pendant la construction des images et l’approvisionnement des modèles. Ensuite, la pile fonctionne hors ligne ; un script vérifie l’absence de sortie réseau.
Quels modèles sont utilisés ?
Dans le profil Compact : granite-embedding:278m (embeddings), qwen2.5:1.5b-instruct (génération) et BAAI/bge-reranker-v2-m3 (reranking), tous sous licence Apache-2.0, téléchargés par l’exploitant. Changer de modèle d’embeddings impose une réindexation ; aucun réindexage implicite n’a lieu.
À quelle vitesse répond-il ?
Sur le poste CPU de qualification, une réponse complète prend entre 28 et 71 s (médiane ≈ 51 s), dont environ 10 s de reranking. Les profils GPU ne sont pas qualifiés, et le reranking s’exécute sur CPU dans tous les profils actuels. Détails et réserves sur la page Performances.
Combien d’utilisateurs simultanés ?
La passerelle accepte deux générations concurrentes, puis répond 503 avec un délai de réessai. La charge au-delà d’une génération concurrente n’est pas qualifiée : le profil Compact vise un poste ou une petite équipe.
Formats et capacités
Quels formats sont pris en charge ?
Par défaut dans Compact : texte, Markdown, PDF avec couche texte, DOCX, CSV, HTML, XLSX et PPTX. XML, DXF et EML sont livrés mais fermés par un drapeau. Les images, PDF numérisés (OCR), IFC, DWG et l’audio nécessitent une reconstruction d’image ou un composant absent. Le catalogue complet détaille 44 formats.
Lit-il les documents scannés ?
Pas dans les images publiées : l’OCR (Tesseract, local) est une option de construction désactivée dans Compact. Un PDF scanné est accepté à l’import mais son ingestion échoue avec un code explicite.
Comprend-il les plans et les schémas ?
Non. L’extracteur DXF (et DWG via conversion) indexe les annotations textuelles, les attributs et les calques ; il ne reconstruit ni la géométrie ni le sens d’un dessin. Aucun modèle de vision n’est activé dans l’édition Open.
Peut-il transcrire des enregistrements audio ?
Le parcours audio existe dans le code de l’application, mais AI Gateway Open ne contient aucun moteur de transcription. Sans service ASR fourni par l’exploitant, l’audio reste indisponible.
Projet
Sous quelle licence ?
Apache License 2.0 pour les trois dépôts ; les composants tiers gardent leurs licences (listées dans chaque dépôt). Voir Open source.
Qu’est-ce que le Pool ?
AI Gateway Pool Open est un routeur HTTP facultatif placé devant une ou plusieurs passerelles. Il relaie le même contrat d’API, gère la capacité par nœud et les pannes de transport, et ne fait aucune inférence. Il est absent du profil Compact.
Comment signaler une vulnérabilité ?
En privé, selon SECURITY.md (contact@ragatm.com) ou via le signalement privé GitHub.