Assistant, connaissances et vidéos¶

Ces fonctions sont facultatives. L'IA utilise vos propres clés, et chaque utilisation est facturée sur votre compte par le fournisseur (sauf avec un modèle local, qui est gratuit). Les connaissances lues par l'assistant sont récupérées sans IA.

Onglet des paramètres	À quoi il sert	Utilise l'IA
Assistant	L'assistant de jeu, l'IA qui le fait fonctionner, et ce que cette IA peut aussi rédiger à la demande	Oui
Connaissances	Les pages Wikipédia et StrategyWiki de chaque jeu, lues par l'assistant	Non
Vidéos	Les bandes-annonces YouTube	Non

Assistant de jeu¶

La bulle Assistant, en bas à droite de chaque page, répond à vos questions :

Bibliothèque : trouver un jeu parmi les vôtres, en comparer deux, demander comment utiliser l'application (« Un jeu à deux dans ma bibliothèque ? », « Comment ajouter des jeux ? ») ;
Un jeu : quand la fiche d'un jeu est ouverte ou qu'un jeu tourne, il propose de parler de ce jeu (« Tu regardes … Discuter de ce jeu ? ») : commandes, objectifs, un passage difficile, un secret. Pour « Je suis bloqué, un indice ? », il donne d'abord un indice, puis Donne-moi la solution complète si vous le demandez.

Il répond avec l'IA réglée dans Paramètres → Assistant, la fiche du jeu et les connaissances récupérées pour ce jeu, et cite ses sources. Il ne parle que de vos jeux et de ROMKADE Manager, n'aide jamais à trouver des jeux, des ROM ou des BIOS à télécharger, et s'arrête après 20 questions par discussion (Effacer la discussion pour recommencer). Chaque réponse est signalée « IA, peut se tromper », avec le service utilisé (« modèle local : rien ne quitte cet ordinateur »).

IA de l'assistant¶

Paramètres → Assistant → IA de l'assistant définit l'IA. Un voyant indique l'état : Connectée (vert), pas encore connectée, ou connexion impossible, avec ce qu'il faut corriger. La connexion est vérifiée automatiquement ; Vérifier relance la vérification, Déconnecter retire l'IA.

La même IA rédige aussi, à la demande seulement :

les descriptions des jeux, plus bas dans le même onglet ;
les commandes des jeux, avec Demander à l'IA sur la fiche d'un jeu.

Service en ligne, avec une clé d'API¶

Pas encore de clé ? Créer une clé d'API explique, service par service, comment l'obtenir.

Service	Remarques
Claude (Anthropic)	Les descriptions partent en lot, à moitié prix, avec le coût estimé affiché avant de commencer
ChatGPT (OpenAI), Mistral AI, Gemini (Google)	Facturé à l'usage

Choisissez Service en ligne, avec une clé d'API, puis le service.
Collez votre clé d'API (Créer une clé … renvoie vers la page du fournisseur). Le modèle est proposé et la connexion vérifiée automatiquement ; Changer permet de choisir un autre modèle dans la liste renvoyée par le fournisseur.

Les clés sont rangées dans le trousseau du système (installation à partir du code source) ou dans le volume de données (Docker) : voir Données et confidentialité. À partir du code source, si aucune clé n'est enregistrée, ROMKADE Manager utilise la variable d'environnement du fournisseur si elle existe (ANTHROPIC_API_KEY, OPENAI_API_KEY, MISTRAL_API_KEY, GEMINI_API_KEY).

Modèle local ou service compatible OpenAI¶

Première fois ? Installer une IA locale explique tout, pas à pas, sur Mac, Windows et Linux.

Un modèle à poids ouverts sur votre ordinateur ou sur votre réseau, avec Ollama ou LM Studio : gratuit et privé, mais plus lent et un peu moins précis qu'un grand modèle en ligne.

Installez Ollama ou LM Studio et démarrez son serveur. Téléchargez un modèle qui gère bien le français et l'espagnol, par exemple :
```
ollama pull qwen2.5:7b
```

Dans Paramètres → Assistant, choisissez Modèle local ou service compatible OpenAI, puis l'adresse du service :

ROMKADE Manager tourne…	Ollama	LM Studio
avec Docker	`http://host.docker.internal:11434/v1`	`http://host.docker.internal:1234/v1`
à partir du code source	`http://localhost:11434/v1`	`http://localhost:1234/v1`

Choisissez le modèle dans la liste.

Docker sous Linux

Le fichier compose.yaml fourni déclare host.docker.internal, mais par défaut Ollama n'écoute que sur l'ordinateur lui-même. Faites-le aussi écouter pour les conteneurs, puis redémarrez-le :

sudo systemctl edit ollama      # add:  [Service]  Environment="OLLAMA_HOST=0.0.0.0:11434"
sudo systemctl restart ollama

Tout autre service qui parle le protocole d'OpenAI fonctionne aussi : saisissez son adresse (qui se termine généralement par /v1) et, s'il en demande une, sa clé d'API sous Le service demande une clé d'API ?. Si le modèle répond, mais pas au format attendu, essayez un modèle plus grand.

Descriptions des jeux, rédigées par l'IA¶

En bas de Paramètres → Assistant, l'IA rédige une description de chaque jeu dans les trois langues : elle traduit les résumés connus et rédige les autres. Pour un jeu qu'elle connaît mal, elle n'écrit que ce qui est certain. Les textes sont signalés « par IA » sur la fiche du jeu.

Avec Claude, les descriptions partent en lot (à moitié prix) ; le coût estimé est indiqué sur le bouton. Les résultats arrivent généralement en moins d'une heure.
Avec un autre fournisseur ou un modèle local, les jeux sont décrits un par un en arrière-plan. Le traitement s'arrête après 5 échecs consécutifs et peut être repris ; les jeux déjà décrits sont conservés.

Vous pouvez continuer à utiliser l'application pendant ce temps ; la page se met à jour toute seule.

Commandes des jeux¶

Sur la fiche d'un jeu, Commandes indique quel bouton de la console fait quoi. Demander à l'IA remplit la liste dans les trois langues, en s'appuyant sur la correspondance par défaut entre la manette d'origine et les boutons de la console. Corriger ou Saisir à la main la remplace par votre propre texte. Les réponses sont enregistrées et partagées entre les éditions d'un même jeu.

Connaissances¶

Paramètres → Connaissances récupère, pour chaque jeu, sa page Wikipédia (anglais, français, espagnol) et sa soluce StrategyWiki quand elles existent. Aucune IA n'intervient : le jeu est identifié par Wikidata (titre et console), les pages sont découpées en passages et indexées dans le moteur de recherche. L'assistant lit ces passages pour répondre, et les cite.

Récupérer pour les N jeux restants tourne en arrière-plan, une requête à la fois ; Arrêter le met en pause.
Récupérer automatiquement pour les nouveaux jeux, après chaque synchronisation tient les connaissances à jour.
Un seul jeu : choisissez un jeu, puis Récupérer. Cela enregistre vraiment ses pages, comme le lot complet : ce n'est pas un simple essai. Voir les passages trouvés ne fait que lire : ce que l'assistant recevrait pour une question de test.

Sources : Wikipédia et StrategyWiki (CC BY-SA 4.0), citées dans les réponses de l'assistant.

Bandes-annonces YouTube¶

Paramètres → Vidéos définit la clé d'API YouTube utilisée par ▶ sur les jaquettes.

Dans la console Google Cloud, créez un projet et activez YouTube Data API v3.
Créez une clé d'API dans Identifiants (elle commence généralement par AIza).
Collez-la dans Clé d'API YouTube et enregistrez.

Le quota gratuit permet environ 100 nouvelles recherches par jour. Une bande-annonce est recherchée au premier clic, puis mise en cache. Sans clé, ▶ ouvre la recherche sur youtube.com.