feat: added French support
This commit is contained in:
@@ -0,0 +1,107 @@
|
||||
## Aide
|
||||
|
||||
Bienvenue dans **l’assistant musical K.G.Studio**, votre agent IA dédié à la composition, à l’arrangement et au travail de production directement dans le navigateur.
|
||||
|
||||
Pour commencer, vous pouvez soit utiliser le **LLM local intégré au navigateur** sans clé API, soit configurer un fournisseur LLM externe.
|
||||
|
||||
---
|
||||
|
||||
### Utiliser le LLM local (navigateur) sans clé API
|
||||
|
||||
K.G.Studio peut exécuter **Gemma 4 E4B** entièrement dans votre navigateur avec accélération WebGPU. Aucune requête API externe n’est envoyée, aucun coût supplémentaire n’est engagé, et vos données restent sur votre machine.
|
||||
|
||||
1. Dans **Réglages ⚙️ → Général → Fournisseur LLM**, sélectionnez **LLM local (navigateur)**.
|
||||
2. Le modèle (~2,8 Go) se télécharge automatiquement lors de la première ouverture du chat, puis reste en cache local pour les lancements suivants.
|
||||
3. Vous pouvez régler la **Longueur de contexte** (32k / 64k / 128k tokens) selon votre matériel.
|
||||
4. Commencez à dialoguer.
|
||||
|
||||
**Configuration recommandée :** Chrome 113+ ou Edge 113+, contexte sécurisé (HTTPS ou localhost), et GPU avec au moins 8 Go de VRAM ou machine avec au moins 16 Go de mémoire unifiée.
|
||||
|
||||
> Remarque : la qualité du modèle local reste inférieure à celle des grands modèles commerciaux. Pour les tâches complexes, un fournisseur externe donnera généralement de meilleurs résultats.
|
||||
|
||||
---
|
||||
|
||||
### Configurer un fournisseur LLM externe
|
||||
|
||||
Allez dans **Réglages ⚙️ → Général → Fournisseur LLM**. Selon le fournisseur choisi, vous devrez renseigner la clé API appropriée et, si besoin, une URL de base personnalisée.
|
||||
|
||||
---
|
||||
|
||||
### Utiliser OpenAI
|
||||
|
||||
1. Récupérez une clé API OpenAI depuis [**OpenAI**](https://platform.openai.com/account/api-keys).
|
||||
2. Dans **Réglages ⚙️ → Général → Fournisseur LLM**, choisissez **OpenAI**.
|
||||
3. Saisissez votre clé dans **OpenAI → Clé**.
|
||||
4. Sélectionnez le modèle voulu dans **OpenAI → Modèle**. Pour un bon compromis coût / performances, `gpt-5.4-mini` est recommandé.
|
||||
5. Vous pouvez activer **Mode Flex** si vous acceptez une latence plus variable en échange d’un coût potentiellement réduit.
|
||||
|
||||
---
|
||||
|
||||
### Utiliser OpenRouter
|
||||
|
||||
OpenRouter donne accès à de nombreux modèles via une API unique, y compris certaines options gratuites.
|
||||
|
||||
1. Créez une clé API sur [**OpenRouter**](https://openrouter.ai/keys).
|
||||
2. Dans **Réglages ⚙️ → Général → Fournisseur LLM**, choisissez **Serveur compatible OpenAI**.
|
||||
3. Saisissez votre clé dans **Serveur compatible OpenAI → Clé**.
|
||||
4. Consultez les modèles disponibles sur la [**page des modèles OpenRouter**](https://openrouter.ai/models).
|
||||
5. Saisissez le nom du modèle dans **Serveur compatible OpenAI → Modèle**.
|
||||
6. Saisissez `https://openrouter.ai/api/v1` dans **Serveur compatible OpenAI → URL de base**.
|
||||
|
||||
### Opérations DAW de base
|
||||
|
||||
Commandes du chat : `/clear`, `/welcome`, `/help`, `/hotkeys`
|
||||
|
||||
- Pistes
|
||||
- Ajouter, renommer et réordonner les pistes depuis le panneau d’infos de piste.
|
||||
- Changer d’instrument via le bouton instrument ; régler Solo, Mute et Volume.
|
||||
- Supprimer une piste depuis son menu de réglages.
|
||||
- **Enregistrement audio** : cliquez sur `Rec` dans la barre d’outils pour enregistrer directement dans une piste audio.
|
||||
|
||||
- Régions
|
||||
- Créer une région : avec l’outil pointeur, double-cliquez ; ou maintenez `Ctrl/Cmd` et cliquez. Avec l’outil crayon, un simple clic suffit.
|
||||
- Déplacer / redimensionner : faites glisser le corps de région pour déplacer, ou les bords pour redimensionner.
|
||||
- Ouvrir le Piano Roll via le petit crayon en haut à gauche de la région.
|
||||
|
||||
- Piano Roll
|
||||
- Outils : Sélection ou Crayon.
|
||||
- Créer des notes : double-clic ou `Ctrl/Cmd+clic` en mode sélection ; clic simple en mode crayon.
|
||||
- Sélectionner : clic, `Maj+clic` pour la multisélection, ou glisser pour un lasso.
|
||||
- Déplacer / redimensionner : faites glisser le corps ou les bords des notes.
|
||||
- **Vue partition** : bascule entre Piano Roll et notation sur portée depuis la barre d’outils.
|
||||
- **Voies d’automation** : éditez le pitch bend et les courbes MIDI CC sous la grille piano.
|
||||
- **Mode spectrogramme** : affichez le spectrogramme d’une région audio comme référence d’édition.
|
||||
- **Liste des événements** : inspectez et modifiez les notes, pitch bends et contrôleurs de la région MIDI active.
|
||||
|
||||
- Système de pistes globales
|
||||
- Quatre pistes permanentes en haut de la timeline : **Repère**, **Tempo**, **Armure** et **Accord**.
|
||||
- Elles pilotent le timing, les suggestions d’accords, l’affichage de la partition et certains résultats d’analyse.
|
||||
|
||||
- Analyse audio
|
||||
- **Détecter les accords** : ouvre l’analyse harmonique d’une région audio et alimente la piste globale des accords.
|
||||
- **Détecter le tempo** : analyse une région audio pour en extraire le BPM et peut réaligner le tempo du projet.
|
||||
|
||||
- Générateur musical K.G.One
|
||||
- Cliquez sur le bouton **✦** dans la barre d’outils.
|
||||
- **Morceau complet** : génération d’un titre complet à partir d’une description et, si besoin, de paroles.
|
||||
- **Clip** : génération de clips instrumentaux courts et de boucles MIDI.
|
||||
- **Séparation de stems (navigateur)** : séparation locale d’une région audio en stems, sans serveur.
|
||||
|
||||
- Snap et quantification
|
||||
- Réglez le snap depuis le menu `NO SNAP`.
|
||||
- Quantifiez avec `Qua. Pos.` et `Qua. Len.`.
|
||||
|
||||
- Lecture
|
||||
- Retour au début ; Lecture / Pause depuis la barre d’outils.
|
||||
- Placez la tête de lecture en cliquant sur les numéros de mesure.
|
||||
- Changez BPM, chiffrage de mesure et armure depuis la barre d’outils.
|
||||
|
||||
---
|
||||
|
||||
### Remarque
|
||||
|
||||
Par sécurité, lorsque K.G.Studio tourne hors d’un hôte local, les clés API ne sont pas conservées dans IndexedDB par défaut. Vous pouvez activer leur persistance dans les réglages, mais ce n’est pas recommandé sur un environnement partagé.
|
||||
|
||||
### Avertissement
|
||||
|
||||
K.G.Studio n’héberge aucun des modèles mentionnés et n’est affilié à aucun fournisseur de modèles. Toutes les données restent sur votre appareil ; vous êtes responsable des informations envoyées à des services tiers.
|
||||
@@ -0,0 +1,59 @@
|
||||
## Raccourcis
|
||||
|
||||
Ce guide récapitule les raccourcis clavier et les actions avec modificateurs actuellement disponibles dans K.G.Studio.
|
||||
|
||||
### Création selon la plateforme
|
||||
|
||||
- Sur **macOS**, utilisez `Cmd+clic` pour créer une région, une note ou un point d’automation avec l’outil pointeur.
|
||||
- Sur **Windows/Linux**, utilisez `Ctrl+clic` pour créer une région, une note ou un point d’automation avec l’outil pointeur.
|
||||
- Dans la timeline principale, un double-clic dans une zone vide crée une région lorsque l’outil pointeur est actif.
|
||||
- Dans le Piano Roll et les voies d’automation, l’outil crayon permet aussi de créer avec un simple clic.
|
||||
|
||||
### Raccourcis principaux
|
||||
|
||||
- `Espace` — Lecture / Arrêt
|
||||
- `C` — Activer / désactiver la boucle
|
||||
- `R` — Démarrer / arrêter l’enregistrement
|
||||
- `Cmd/Ctrl+Z` — Annuler
|
||||
- `Cmd/Ctrl+Shift+Z` — Rétablir
|
||||
- `Cmd/Ctrl+C` — Copier les éléments sélectionnés
|
||||
- `Cmd/Ctrl+V` — Coller
|
||||
- `Cmd/Ctrl+S` — Enregistrer le projet
|
||||
- `Cmd/Ctrl+A` — Sélectionner toutes les notes de la région MIDI active
|
||||
- `Cmd/Ctrl+T` — Couper la région sélectionnée à la tête de lecture
|
||||
- `Cmd/Ctrl+J` — Fusionner les régions MIDI sélectionnées
|
||||
|
||||
### Fenêtre de région / Piano Roll
|
||||
|
||||
- `E` — Ouvrir le Piano Roll pour une région MIDI sélectionnée, ou l’éditeur de forme d’onde pour une région audio sélectionnée. Si l’éditeur est déjà ouvert, `E` le ferme.
|
||||
- `N` — Ouvrir le Piano Roll en vue partition pour une région MIDI sélectionnée.
|
||||
- `Suppr` / `Retour arrière` — Supprimer les régions, notes ou points d’automation sélectionnés.
|
||||
- `Esc` — Fermer la fenêtre du Piano Roll.
|
||||
|
||||
### Sélection
|
||||
|
||||
- `Maj+clic` — Ajouter à la sélection.
|
||||
- Lasso dans une zone vide — Sélection rectangulaire de régions ou de points d’automation.
|
||||
- `Maj+lasso` dans la fenêtre Piano Roll — Basculer la sélection des éléments contenus dans la zone.
|
||||
|
||||
### Raccourcis du Piano Roll
|
||||
|
||||
- `G` — Faire défiler les modes du guide d’accords
|
||||
- `Tab` — Aller à la suggestion d’accord suivante
|
||||
- `Maj+Tab` — Revenir à la suggestion d’accord ou au renversement précédent
|
||||
|
||||
### Raccourcis de snap
|
||||
|
||||
- `1` — Aucun snap
|
||||
- `2` — Snap sur `1/4`
|
||||
- `3` — Snap sur `1/8`
|
||||
- `4` — Snap sur `1/16`
|
||||
|
||||
### Raccourcis de quantification
|
||||
|
||||
- `5` — Quantification de position sur `1/4`
|
||||
- `6` — Quantification de position sur `1/8`
|
||||
- `7` — Quantification de position sur `1/16`
|
||||
- `8` — Quantification de durée sur `1/4`
|
||||
- `9` — Quantification de durée sur `1/8`
|
||||
- `0` — Quantification de durée sur `1/16`
|
||||
@@ -0,0 +1,11 @@
|
||||
## Bon retour
|
||||
|
||||
Ravi de vous revoir. Votre fournisseur LLM semble déjà configuré, vous pouvez commencer à dialoguer immédiatement.
|
||||
|
||||
Conseils :
|
||||
- Utilisez `/clear` à tout moment pour réinitialiser le chat.
|
||||
- Tapez `/welcome` pour réafficher ce message.
|
||||
- Tapez `/help` pour ouvrir l’aide.
|
||||
- Tapez `/hotkeys` pour afficher le guide des raccourcis.
|
||||
|
||||
Bonne composition avec l’assistant musical K.G.Studio.
|
||||
@@ -0,0 +1,29 @@
|
||||
## Mode LLM local
|
||||
|
||||
Bienvenue dans **l’assistant musical K.G.Studio** en mode LLM local.
|
||||
|
||||
- Aucune API externe n’est nécessaire. Tout s’exécute directement dans votre navigateur, sans coût API supplémentaire.
|
||||
- Ce mode utilise **Gemma 4 E4B** via **LiteRT-LM** avec accélération **WebGPU**.
|
||||
- Configuration matérielle recommandée : GPU avec au moins **8 Go de VRAM** ou système avec au moins **16 Go de mémoire unifiée**.
|
||||
- Les performances restent plus limitées que celles des grands modèles hébergés dans le cloud, surtout pour les tâches longues, complexes ou très itératives.
|
||||
|
||||
### Flux de travail recommandé
|
||||
- Gardez des demandes courtes et ciblées.
|
||||
- Faites progresser le modèle étape par étape vers le résultat final.
|
||||
- Travaillez sur de petites régions musicales plutôt que sur des arrangements de morceau complet.
|
||||
- Préférez des consignes d’arrangement simples lorsque c’est possible.
|
||||
- Ouvrez une nouvelle conversation pour chaque tâche autonome.
|
||||
|
||||
Exemple :
|
||||
- Pour de meilleurs résultats, découpez les demandes complexes en plusieurs étapes.
|
||||
- Si vous voulez que le modèle écrive une progression d’accords à partir de la musique actuelle, commencez par : `Please read the current music.`
|
||||
- Une fois cette étape terminée, poursuivez avec : `Please write a chord progression based on it.`
|
||||
- Ce flux incrémental est généralement plus fiable en mode LLM local.
|
||||
- Gardez la région MIDI que vous souhaitez modifier sélectionnée pendant tout le flux de travail.
|
||||
- Il n’est pas nécessaire de changer de sélection vers une autre région uniquement pour `read_music`, car `read_music` peut lire la musique sur l’ensemble des pistes.
|
||||
|
||||
### Utiliser plutôt un LLM externe
|
||||
- Si vous souhaitez utiliser un modèle plus grand dans le cloud ou auto-hébergé, ouvrez **Réglages -> Général -> Fournisseur LLM** et quittez **LLM local (navigateur)**.
|
||||
- Pour un modèle cloud, vous pouvez utiliser **OpenAI**, ou **Serveur compatible OpenAI** avec un fournisseur comme OpenRouter.
|
||||
- Pour un modèle auto-hébergé, choisissez **Serveur compatible OpenAI** puis renseignez l’**URL de base** et le **Modèle** de votre serveur.
|
||||
- Après changement de fournisseur, démarrez une nouvelle conversation pour repartir proprement avec le nouveau modèle.
|
||||
@@ -0,0 +1,25 @@
|
||||
## Bienvenue
|
||||
|
||||
Bienvenue dans **l’assistant musical K.G.Studio**, votre partenaire IA dans le navigateur pour la composition et l’arrangement.
|
||||
|
||||
### Démarrage rapide
|
||||
**Configurer l’assistant musical K.G.Studio**
|
||||
- [Cliquez ici pour obtenir une clé API OpenRouter gratuite](https://openrouter.ai/keys) ; un compte OpenRouter peut être nécessaire.
|
||||
- Dans **Réglages ⚙️ → Général → Fournisseur LLM**, sélectionnez **Serveur compatible OpenAI**.
|
||||
- Dans **Serveur compatible OpenAI → Clé**, collez votre clé. Remarque : hors localhost, la clé n’est pas conservée après rechargement.
|
||||
- Dans **Serveur compatible OpenAI → Modèle**, saisissez `qwen/qwen3-30b-a3b:free`.
|
||||
- Dans **Serveur compatible OpenAI → URL de base**, saisissez `https://openrouter.ai/api/v1`.
|
||||
|
||||
*(Vous pouvez aussi utiliser l’API officielle OpenAI ou tout autre service compatible OpenAI.)*
|
||||
|
||||
**Opérations DAW de base**
|
||||
- Double-cliquez sur une piste, ou faites `Ctrl/Cmd+clic`, pour créer une région.
|
||||
- Faites glisser les bords d’une région pour la redimensionner ; faites glisser son corps pour la déplacer.
|
||||
- Cliquez sur le petit crayon en haut à gauche d’une région pour ouvrir le Piano Roll.
|
||||
- Dans le Piano Roll, double-cliquez ou faites `Ctrl/Cmd+clic` pour créer une note.
|
||||
- Cliquez pour sélectionner ; `Maj+clic` pour la multisélection ; glissez pour une sélection rectangulaire.
|
||||
- Faites glisser les bords d’une note pour modifier sa durée, ou son corps pour la déplacer.
|
||||
- Utilisez le snap dans la barre d’outils du Piano Roll pour quantifier sur la grille.
|
||||
|
||||
### Avertissement
|
||||
K.G.Studio n’est affilié à aucun fournisseur LLM. Toutes les données sont stockées localement sur votre appareil ; vous restez responsable des données envoyées à des services tiers.
|
||||
Reference in New Issue
Block a user