README

L'intelligence artificielle, intégrée nativement dans Symfony.

Synapse est un écosystème de bundles Symfony pour déployer des agents IA autonomes, des chatbots et des outils de raisonnement dans vos applications. Le projet est organisé en monorepo avec trois packages : Core (orchestration headless), Admin (interface d'administration), Chat (UI et API chat).

Explorer la Documentation »

✨ Points Forts

• 🤖 Agnosticisme LLM : Standardisation sur le format OpenAI pour passer de Gemini à OVH ou OpenAI sans changer une ligne de code.
• 🔧 Agents : Créez des agents spécialisés avec leurs propres instructions, tons de réponse et outils via AgentInterface.
• 💰 Suivi des Coûts (Accounting) : Tracking précis des tokens (input/output/thinking), estimation avant requête et gestion multi-devises (EUR/USD).
• 📉 Quotas & Limites : Plafonds de dépense configurables par utilisateur, mission ou preset avec fenêtres glissantes et calendaires.
• 🩺 Synapse Doctor : Assistant de diagnostic intégré pour automatiser l'installation et la réparation (php bin/console synapse:doctor).
• 📡 Streaming & Auto-titling : UX fluide avec réponses en temps réel et génération automatique des titres de conversation.
• 🎨 Administration : Dashboard analytique moderne, gestion de la mémoire sémantique et monitoring temps réel.

🚀 Installation Rapide

Core (requis) :

composer require arnaudmoncondhuy/synapse-core

Admin et Chat (optionnels) :

composer require arnaudmoncondhuy/synapse-admin arnaudmoncondhuy/synapse-chat

2. Initialisation Automatique

Utilisez l'assistant de diagnostic pour configurer automatiquement votre projet (entités, security.yaml, routes, configurations) :

php bin/console synapse:doctor --init

Note

En mode --init, Synapse crée un utilisateur de développement par défaut : admin / admin.

3. Configuration minimale (Core)

# config/packages/synapse_core.yaml (ou synapse.yaml selon votre config)
synapse_core:
  persistence:
    enabled: true
    conversation_class: App\Entity\Conversation
    message_class: App\Entity\Message

📖 Utilisation

Composant Chat (avec synapse-chat)

{{ include('@Synapse/chat/component.html.twig') }}

Service Chat (usage programmatique, Core)

$result = $chatService->ask(
    message: "Analyse ce rapport trimestriel",
    options: ['tone' => 'expert_analyste']
);
echo $result['answer'];

📖 Documentation

La documentation est générée depuis ce dépôt et publiée sur GitHub Pages. Elle est organisée en trois sections :

• Synapse Core — Architecture headless, contrats, Accounting (coûts), Quotas, Agents, RAG, mémoire et CLI (Synapse Doctor).
• Synapse Admin — Interface d'administration V2, Dashboard Analytics et monitoring.
• Synapse Chat — Routes API, composants front, Auto-titling et sécurité CSRF.

🏗️ Architecture

• Synapse Core : Contrats (LLM, Vector Store, Formatters), orchestration, persistance Doctrine, événements.
• Synapse Admin : Contrôleurs et vues Twig pour la gestion des providers, presets et conversations.
• Synapse Chat : API HTTP (chat, reset, CSRF) et composant Stimulus/Twig pour l'UI de chat.

🧪 Tests et Fiabilité

Le bundle est testé pour garantir la stabilité des échanges :

vendor/bin/phpunit

📄 Licence

PolyForm Noncommercial 1.0.0 - Voir LICENSE pour plus de détails.

🙏 Crédits

• Design : Inspiré par l'écosystème Google Gemini.
• Framework : Propulsé par Symfony.
• Moteur : Compatible Vertex AI, OVHcloud AI Endpoints et OpenAI.

Développé avec ❤️ par MakerLab