https://github.com/kevinggraphiste-hub/gungnir
L'intelligence artificielle qui s'éveille à votre métier. Plateforme IA souveraine, hébergée en Europe, auditable. Conscience v4 per-user, 11 plugins, 8 providers LLM, BSL.
https://github.com/kevinggraphiste-hub/gungnir
ai-agent bsl-license fastapi mcp oauth python react self-hosted souverainete typescript
Last synced: 16 days ago
JSON representation
L'intelligence artificielle qui s'éveille à votre métier. Plateforme IA souveraine, hébergée en Europe, auditable. Conscience v4 per-user, 11 plugins, 8 providers LLM, BSL.
- Host: GitHub
- URL: https://github.com/kevinggraphiste-hub/gungnir
- Owner: kevinggraphiste-hub
- License: other
- Created: 2026-04-07T22:53:12.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-05-27T12:22:59.000Z (26 days ago)
- Last Synced: 2026-05-27T13:26:31.831Z (26 days ago)
- Topics: ai-agent, bsl-license, fastapi, mcp, oauth, python, react, self-hosted, souverainete, typescript
- Language: Python
- Homepage: https://site.scarletwolf.cloud
- Size: 7.29 MB
- Stars: 6
- Watchers: 0
- Forks: 1
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# 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://scarletwolf.cloud)
---
## 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, 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), 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), 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)
- 🌐 **[scarletwolf.cloud](https://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 — _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](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://scarletwolf.cloud
- 🏢 **Éditeur** : https://scarletwolf.fr
- ✉️ **Contact** : contact@scarletwolf.cloud
---
**Scarlet Wolf © 2026** — *La lance qui ne manque jamais sa cible.*