Gungnir

<div align="center"> # Gungnir **L'intelligence artificielle qui s'éveille à votre métier.** Hébergée en Europe. Auditable. Vôtre. [](backend/core/__version__.py) [](LICENSE) [](#stack-technique) [](https://site.scarletwolf.cloud) </div> --- ## 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 :** ```bash 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) :** ```bash 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`](INSTALL.md) — méthodes A/B, OAuth, plugins tiers (customisation par l'agent), MAJ, troubleshooting. ### Dev local (hot-reload) ```bash 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 | 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](ABOUT.md)** — fiche d'identité complète (features, plugins, écosystème, chiffres) - 🌐 **[site.scarletwolf.cloud](https://site.scarletwolf.cloud)** — site marketing (triptyque, plans, démo 30 min) - 🛠️ **[skills/](skills/)** — skills réutilisables (format Anthropic Claude Skills) - 🤝 **[CONTRIBUTING.md](CONTRIBUTING.md)** — setup dev, conventions, PR flow, **publier un plugin/workflow community** - 🛡️ **[SECURITY.md](SECURITY.md)** — politique disclosure responsable - 📋 **[CHANGELOG.md](CHANGELOG.md)** — historique versions détaillé ## Écosystème | Projet | Licence | Rôle | |---|---|---| | **Gungnir** (ce repo) | [BSL 1.1](LICENSE) → 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 | | **Munnin** | MIT | Couche d'agrégation LLM, vraiment libre | > « 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](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](SECURITY.md)**. ## Liens - 🚀 **App** : https://gungnir.scarletwolf.cloud - 🌐 **Site** : https://site.scarletwolf.cloud - 🏢 **Éditeur** : https://scarletwolf.fr - ✉️ **Contact** : contact@scarletwolf.cloud --- <div align="center"> **Scarlet Wolf © 2026** — *La lance qui ne manque jamais sa cible.* </div>