Qu'est-ce que c'est ?

Gungnir est une plateforme super-assistant IA full-stack — agent autonome per-user, conscience vectorielle persistante, 11 plugins modulaires, 14 providers LLM (8 natifs + 6 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 v4 per-user — 7 boucles automatiques (think, challenger, simulation, impulse, consolidation, goals, system_pulse), 5 besoins fondamentaux, mémoire vectorielle sur Qdrant / Pinecone / ChromaDB / Supabase pgvector
• 🤖 Agent autonome configurable — chaque user choisit nom, formality, soul, mode d'autonomie via onboarding conversationnel
• 🔌 11 plugins activables/désactivables — Conscience, Valkyrie (project mgmt), Forge (workflows n8n-natifs), SpearCode (IDE intégré), Webhooks (OAuth + MCP), Channels, HuntR (9 providers recherche), 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
• 🎁 Essai 14 jours sans carte bancaire — 4 modèles :free OpenRouter whitelistés, master key serveur
• 🛒 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é
• 🔐 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

Documentation

• 📖 ABOUT.md — fiche d'identité complète (features, plugins, écosystème, chiffres)
• 🌐 site.scarletwolf.cloud — 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

« 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://site.scarletwolf.cloud
• 🏢 Éditeur : https://scarletwolf.fr
• ✉️ Contact : [email protected]