Skip to content
goldensam777Public

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

11 Commits

Folders and files

Repository files navigation

Plenum — Salon Multi-IA

Un espace de délibération collective où 5 intelligences artificielles convergent autour d'une seule volonté architecturale.

Plenum est une application Python qui permet de communiquer simultanément avec Claude, Gemini, DeepSeek, ChatGPT et Kimi K2 dans une interface unique. Chaque IA reçoit le message de l'utilisateur, répond en parallèle, puis lit les réponses de ses pairs avant le tour suivant.


Architecture

plenum/
├── core/
│   ├── plenum.py       # Orchestrateur principal (asyncio)
│   ├── memory.py       # Historique cumulatif par session
│   └── display.py      # Affichage grille terminal
├── agents/
│   ├── base_agent.py   # Interface commune (ABC)
│   ├── claude.py       # API Anthropic
│   ├── gemini.py       # API Google (google-genai)
│   ├── deepseek.py     # API DeepSeek (compatible OpenAI)
│   ├── chatgpt.py      # API OpenAI
│   └── kimi.py         # API Moonshot AI (compatible OpenAI)
├── main.py             # Point d'entrée
├── .env                # Clés API (ne jamais commiter)
├── .env.example        # Template des variables d'environnement
└── requirements.txt    # Dépendances Python

Flux de fonctionnement

Tour N :

  User ──────────────────────────────────────────► message
                    │
          ┌─────────▼──────────┐
          │   plenum.broadcast()│  asyncio.gather()
          └─────────┬──────────┘
                    │
        ┌───────────┼───────────┐──────────┐──────────┐
        ▼           ▼           ▼          ▼          ▼
     Claude      Gemini     DeepSeek   ChatGPT      Kimi
        │           │           │          │          │
        └───────────┴───────────┴──────────┴──────────┘
                    │
              réponses collectées
                    │
Tour N+1 :          ▼
  Chaque IA reçoit : message User + réponses des 4 autres

Phase 1 — User envoie un message → les 5 IA répondent en parallèle.
Phase 2 — User répond → chaque IA reçoit sa réponse + les réponses des 4 autres.
Phase 3 — L'historique s'accumule et est injecté au tour suivant.


Installation

Prérequis

  • Python 3.11+
  • Un venv hors du disque si celui-ci est FAT32/exFAT
# Crée le venv dans le home (évite les erreurs de symlinks sur FAT32)
python3 -m venv .venv
source .venv/bin/activate

Dépendances

pip install anthropic google-genai openai python-dotenv

Variables d'environnement

Crée un fichier .env à la racine du projet :

ANTHROPIC_API_KEY=sk-ant-...
GEMINI_API_KEY=...
DEEPSEEK_API_KEY=...
OPENAI_API_KEY=sk-...
MOONSHOT_API_KEY=...
Variable Provider Lien Coût
ANTHROPIC_API_KEY Anthropic console.anthropic.com Pay-as-you-go
GEMINI_API_KEY Google aistudio.google.com/app/apikey Gratuit (quota)
DEEPSEEK_API_KEY DeepSeek platform.deepseek.com/api_keys ~0.01$/M tokens
OPENAI_API_KEY OpenAI platform.openai.com/api-keys ~5$ minimum
MOONSHOT_API_KEY Moonshot AI platform.moonshot.cn ~1$ minimum

Le Plenum fonctionne avec n'importe quel sous-ensemble de clés. Les agents sans clé sont automatiquement marqués indisponibles au démarrage.


Lancement

# Active le venv
source ~/envs/plenum/bin/activate

# Lance le Plenum
python main.py

Test d'un agent isolé

# Vérifie que Claude répond avant d'assembler tout le Plenum
python test_claude.py

Concepts techniques clés

BaseAgent — le contrat commun

Tous les agents héritent de BaseAgent et implémentent ask(). Le polymorphisme permet à plenum.py de parler à une seule interface sans connaître les détails de chaque API.

asyncio.gather() — la parallélisation

Sans async : 5 IA × 3s = 15s d'attente. Avec gather() : ~3s totales. Chaque appel API est une coroutine lancée simultanément.

run_in_executor() — le pont sync/async

Gemini utilise un SDK non-async. run_in_executor() pousse l'appel bloquant dans un thread séparé, libérant la boucle asyncio. Résultat : comportement identique aux autres agents pour gather().

API-compatible OpenAI

DeepSeek, ChatGPT et Kimi utilisent le même SDK openai. Seules base_url et model diffèrent. C'est devenu le standard de facto des LLMs.

Injection des pairs

À partir du tour 2, chaque IA reçoit les réponses des autres injectées dans son prompt via _inject_peers_context(). C'est ce qui transforme 5 monologues parallèles en une vraie délibération collective.


Roadmap

  • base_agent.py — interface commune
  • core/plenum.py — orchestrateur async
  • agents/claude.py — API Anthropic
  • agents/gemini.py — API Google
  • agents/deepseek.py — API DeepSeek
  • agents/chatgpt.py — API OpenAI
  • agents/kimi.py — API Moonshot
  • core/memory.py — historique persistant
  • core/display.py — grille terminal
  • main.py — assemblage final
  • Export session JSON
  • Interface TUI (rich/textual)

Auteur

YEVI Mawuli Peniel User — Licence Systèmes Embarqués & IoT, IFRI-UAC, Cotonou. Ego Sum Optimus Optimus

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages