Gungnir

L'intelligence artificielle qui s'éveille à votre métier. Hébergée en Europe. Auditable. Vôtre.

---

Qu'est-ce que c'est ?

Gungnir est une plateforme super-assistant IA full-stack — agent autonome per-user, conscience vectorielle persistante, 12 plugins modulaires, 15 providers LLM (8 natifs + 7 OpenAI-compat), 11 connecteurs OAuth. Conçue pour les TPE/PME francophones qui veulent une IA souveraine qu'elles peuvent auditer.

« L'apprentissage continu existe partout. Le pilotage humain de cet apprentissage, non. C'est la signature Scarlet Wolf. »

Installation rapide (self-host)

Le plus simple — clé en main avec image Docker pré-buildée :

curl -fsSL https://raw.githubusercontent.com/kevinggraphiste-hub/Gungnir/main/install.sh | bash

Ça crée un dossier gungnir/, génère les secrets, pull les images, démarre les services. Va sur http://localhost:8000, crée ton compte admin, c'est prêt.

Alternative — mode développeur (build local) :

git clone https://github.com/kevinggraphiste-hub/Gungnir.git
cd Gungnir
# Génère .env avec 3 secrets puis :
docker compose up -d --build

📖 Doc complète : INSTALL.md — méthodes A/B, OAuth, plugins tiers (customisation par l'agent), MAJ, troubleshooting.

Dev local (hot-reload)

docker compose -f compose.dev.yml up -d   # juste Postgres
export DATABASE_URL=postgresql+asyncpg://gungnir:gungnir@localhost:5432/gungnir
python -m uvicorn backend.core.main:app --host 127.0.0.1 --port 8000 --reload
cd frontend && npm install && npm run dev   # autre terminal

Fonctionnalités clés

• 🧠 Conscience v5 per-user — 7 boucles automatiques (think, challenger, simulation, impulse, consolidation, goals, system_pulse), 6 besoins fondamentaux (dont un relationnel), espace de travail unifié, récit de soi évolutif, mémoire à saillance émotionnelle, sur Qdrant / Pinecone / ChromaDB / Supabase
• 🤖 Agent autonome configurable — chaque user choisit nom, formality, soul, mode d'autonomie via onboarding conversationnel
• 🔌 12 plugins activables/désactivables — Conscience, Valkyrie (project mgmt), Forge (workflows n8n-natifs), SpearCode (IDE intégré), Knowledge Base (RAG sémantique multi-format), Webhooks (OAuth + MCP), Channels, HuntR (9 providers recherche + reformulation de requête sourcée), Voice (4 providers vocal), Scheduler, Analytics, Model Guide
• 🛡️ Souveraineté contractuelle — VPS dédié européen, BSL source-available, zéro entraînement croisé, effacement certifié 24h
• 🌍 Interface multilingue — UI entièrement traduite (libellés et textes d'aide) en 24 langues — les 24 langues officielles de l'UE
• 🔑 Inscription publique = compte complet non-admin — l'utilisateur fournit sa propre clé LLM (BYO-key), aucune clé serveur partagée ; frontière de sécurité unique = is_admin
• 🛒 Marketplace publique (v4.3+) — plugins code + workflows Forge installables en 1 clic, signature Ed25519 vérifiée, 3 voies de contribution (Forge → Publier, UI → Soumettre, fork+PR)
• 🛟 Fallback LLM résilient (v4.5+) — chaîne configurable de modèles de secours, bascule auto sur 429/5xx/timeout/401/403/404 silencieusement, badge ⓘ discret sur les bulles ayant basculé
• 💸 Modèle de fond (v5.58+) — modèle léger optionnel pour les process internes (reformulation HuntR, etc.), réduction des coûts avec repli auto sur le modèle de chat + escalade qualité ; défaut OFF (0 régression)
• 🔐 Keypair Ed25519 par user — auto-générée à l'inscription, identifie l'auteur d'un plugin community publié + permet la révocation ciblée en cas de trojan

Stack technique

Couche	Tech
Backend	Python 3.12, FastAPI, asyncio, asyncpg
Database	PostgreSQL 16 (uniquement)
Frontend	React 18, TypeScript, Vite, Tailwind
Vector	Qdrant / Pinecone / ChromaDB / Supabase pgvector
Crypto	Fernet (tokens OAuth, clés API per-user)

Documentation

• 📖 ABOUT.md — fiche d'identité complète (features, plugins, écosystème, chiffres)
• 🌐 scarletwolf.ai — site marketing (triptyque, plans, démo 30 min)
• 🛠️ skills/ — skills réutilisables (format Anthropic Claude Skills)
• 🤝 CONTRIBUTING.md — setup dev, conventions, PR flow, publier un plugin/workflow community
• 🛡️ SECURITY.md — politique disclosure responsable
• 📋 CHANGELOG.md — historique versions détaillé

Écosystème

Projet	Licence	Rôle
Gungnir (ce repo)	BSL 1.1 → Apache 2.0 dans 4 ans	Plateforme complète, l'expérience tout-en-un
SpearCode	Apache 2.0	IDE générateur de code, réutilisable seul — en cours, extraction repo dédié
Morrigan	Propriétaire (R&D)	Moteur d'IA modulaire post-LLM — architecture cognitive expérimentale, alternative aux LLM monolithiques
Vor	Propriétaire (R&D)	OS de conscience — substrat cognitif persistant (teaser — annonce à venir)

« Un écosystème ouvert vaut mieux qu'un produit fermé. Ce qui nous distingue, ce n'est pas la fermeture — c'est l'orchestration. »

Contribuer

PR bienvenues, voir CONTRIBUTING.md pour le setup dev, les conventions de commits (Conventional Commits) et la procédure de signature CLA.

Pour signaler une vulnérabilité : voir SECURITY.md.

Liens

• 🚀 App : https://gungnir.scarletwolf.cloud
• 🌐 Site : https://scarletwolf.ai
• 🏢 Éditeur : https://scarletwolf.fr
• ✉️ Contact : contact@scarletwolf.ai

---

Scarlet Wolf © 2026 — La lance qui ne manque jamais sa cible.