uberwald/arioch-assistant
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

AJout disclaimer

Browse Source
This commit is contained in:
LeRatierBretonnier
2026-04-07 23:18:57 +02:00
parent d100469a0c
commit 0372489f79
1 changed files with 45 additions and 44 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
README.md
View File

@@ -2,6 +2,8 @@
Assistant vocal CLI personnalisé utilisant **Mistral Large** pour les réponses, **Voxtral TTS** pour la synthèse vocale, et **Voxtral Realtime** pour la transcription micro. Supporte le **Model Context Protocol (MCP)** pour appeler des outils externes depuis le LLM. Assistant vocal CLI personnalisé utilisant **Mistral Large** pour les réponses, **Voxtral TTS** pour la synthèse vocale, et **Voxtral Realtime** pour la transcription micro. Supporte le **Model Context Protocol (MCP)** pour appeler des outils externes depuis le LLM.
Disclaimer : Cet outil est un "proof-of-concept" expérimental pour investiguer les possibilités offertes par des agents vocaux personnalisés.
--- ---
## Table des matières ## Table des matières
@@ -91,7 +93,7 @@ python main.py
### Commandes disponibles dans le REPL ### Commandes disponibles dans le REPL
| Commande | Description | | Commande | Description |
|----------|-------------| | ---------------- | -------------------------------------------------- |
| `help` | Afficher l'aide | | `help` | Afficher l'aide |
| `exit` / `quit` | Quitter l'assistant | | `exit` / `quit` | Quitter l'assistant |
| `reset` | Effacer l'historique de conversation | | `reset` | Effacer l'historique de conversation |
@@ -155,7 +157,7 @@ mcp_servers:
### Profils inclus ### Profils inclus
| Slug | Nom | Description | | Slug | Nom | Description |
|------|-----|-------------| | ----------------- | ----------------------------- | -------------------------------------------------------------------------------------------------- |
| `default` | Arioch — Assistant général | Assistant généraliste en français | | `default` | Arioch — Assistant général | Assistant généraliste en français |
| `traveller_scout` | Scout Ship AI — Traveller RPG | IA de bord d'un vaisseau Scout/Courier (Traveller RPG), avec accès à la carte de l'univers via MCP | | `traveller_scout` | Scout Ship AI — Traveller RPG | IA de bord d'un vaisseau Scout/Courier (Traveller RPG), avec accès à la carte de l'univers via MCP |
@@ -267,7 +269,7 @@ Serveur MCP pour l'API [travellermap.com](https://travellermap.com). Écrit en T
#### Outils disponibles #### Outils disponibles
| Outil | Description | | Outil | Description |
|-------|-------------| | -------------------------- | ------------------------------------------------------------------- |
| `search_worlds` | Recherche un monde par nom dans l'univers Traveller | | `search_worlds` | Recherche un monde par nom dans l'univers Traveller |
| `find_route` | Calcule une route de saut entre deux mondes | | `find_route` | Calcule une route de saut entre deux mondes |
| `get_world_info` | Informations détaillées sur un monde (UWP décodé, atmosphère, etc.) | | `get_world_info` | Informations détaillées sur un monde (UWP décodé, atmosphère, etc.) |
@@ -327,7 +329,7 @@ python scripts/list_voices.py
## Variables d'environnement ## Variables d'environnement
| Variable | Obligatoire | Défaut | Description | | Variable | Obligatoire | Défaut | Description |
|----------|-------------|--------|-------------| | --------------------- | ----------- | ------------- | ----------------------------------------- |
| `MISTRAL_API_KEY` | ✅ | — | Clé API Mistral AI | | `MISTRAL_API_KEY` | ✅ | — | Clé API Mistral AI |
| `VOICE_ID` | ❌ | auto | ID voix Voxtral (sélection auto si vide) | | `VOICE_ID` | ❌ | auto | ID voix Voxtral (sélection auto si vide) |
| `VOICE_LANGUAGE` | ❌ | `fr` | Langue préférée pour la sélection de voix | | `VOICE_LANGUAGE` | ❌ | `fr` | Langue préférée pour la sélection de voix |
@@ -339,11 +341,10 @@ python scripts/list_voices.py
## Dépendances Python ## Dépendances Python
| Package | Rôle | | Package | Rôle |
|---------|------| | --------------- | -------------------------------------------- |
| `mistralai` | SDK Mistral (LLM, TTS, STT Realtime) | | `mistralai` | SDK Mistral (LLM, TTS, STT Realtime) |
| `python-dotenv` | Chargement des variables `.env` | | `python-dotenv` | Chargement des variables `.env` |
| `sounddevice` | Capture microphone (mode vocal) | | `sounddevice` | Capture microphone (mode vocal) |
| `numpy` | Traitement PCM audio | | `numpy` | Traitement PCM audio |
| `pyyaml` | Lecture des fichiers de profil | | `pyyaml` | Lecture des fichiers de profil |
| `mcp` | Client MCP (connexion aux serveurs d'outils) | | `mcp` | Client MCP (connexion aux serveurs d'outils) |