Skip to content

fr Installation

Jump to bottom
rcspam edited this page May 7, 2026 · 12 revisions

🌐 Langue : English | Français

Installation

dictée est distribuée sous forme de paquets pré-compilés pour les distributions Linux majeures, plus un tarball portable et une option depuis les sources pour tout le reste. Les variantes CPU et CUDA sont publiées pour chaque format.

Le chemin recommandé est l'installeur une ligne : il détecte automatiquement votre distribution et votre GPU, ajoute le dépôt CUDA NVIDIA si nécessaire, puis récupère le bon paquet depuis la dernière release GitHub.

Assistant de premier lancement

Table des matières

Installation une ligne

curl -fsSL https://raw.githubusercontent.com/rcspam/dictee/master/install.sh | bash

L'installeur :

  1. Détecte votre distribution (Ubuntu, Debian, Fedora, openSUSE, Arch) via /etc/os-release.
  2. Détecte un GPU NVIDIA via nvidia-smi (ou vous demande si la détection est ambiguë).
  3. Ajoute le dépôt CUDA NVIDIA APT/DNF si vous avez un GPU (requis pour libcudnn9-cuda-12 / cuda-cudart-12-x).
  4. Installe le .deb ou .rpm correspondant depuis la dernière release GitHub.
  5. Propose de lancer l'assistant de configuration (dictee-setup) si une session graphique est disponible.

Options de l'installeur

Passez les options après -- :

# Forcer la variante CPU (ignorer la détection GPU)
curl -fsSL https://raw.githubusercontent.com/rcspam/dictee/master/install.sh | bash -s -- --cpu

# Forcer la variante CUDA
curl -fsSL https://raw.githubusercontent.com/rcspam/dictee/master/install.sh | bash -s -- --gpu

# Épingler une version précise
curl -fsSL https://raw.githubusercontent.com/rcspam/dictee/master/install.sh | bash -s -- --version 1.3.3

# Non interactif (aucun prompt, détection automatique)
curl -fsSL https://raw.githubusercontent.com/rcspam/dictee/master/install.sh | bash -s -- --non-interactive

Distributions supportées

Distribution Mode Type de paquet Notes
Ubuntu 22.04 / 24.04 / 24.10 Natif .deb Entièrement testé
Debian 12+ Natif .deb Entièrement testé
Fedora 40+ Natif .rpm Entièrement testé (CI VM Fedora)
openSUSE Tumbleweed Natif .rpm Testé par la communauté
Arch Linux Natif AUR (source) makepkg -si
Tout autre Fallback .tar.gz Tarball portable

CPU vs CUDA

Deux paquets sont publiés pour chaque format :

  • dictee-cpu — inférence sur CPU. Recommandé pour les portables sans GPU NVIDIA, les anciens GPU (compute capability < 6.0), ou les GPU AMD/Intel.
  • dictee-cuda — inférence sur GPU NVIDIA via CUDA 12. Requiert le pilote NVIDIA 535+ et un GPU de compute capability ≥ 6.0 (Pascal ou plus récent).

Depuis la v1.3, le paquet CUDA intègre les bibliothèques runtime CUDA en interne (via un venv pip) — vous n'avez besoin que du pilote NVIDIA + libcudnn9 — pas besoin d'installer le toolkit CUDA complet. Voir GPU-Setup pour les prérequis par distribution.

Les deux paquets peuvent être installés, mais un seul à la fois est actif. L'outil dictee-switch-backend active le bon service systemd.

Benchmark — latence chaude Parakeet-TDT

Même utterance, même modèle, mesurée sur TUXEDO InfinityBook Pro Gen8 (MK2) — Intel Core i7-13700H vs RTX 4070 Laptop 8 Go, TUXEDO OS (kernel 6.17, NVIDIA 590.48.01) :

Durée audio CPU (i7-13700H) CUDA (RTX 4070) Accélération
3 s 0,4 s 0,09 s 4,4×
5 s 0,8 s 0,16 s 5,0×
30 s 4,7 s 0,9 s 5,2×
1 min 9,1 s 1,8 s 5,1×
5 min 43 s 8,9 s 4,8×

CUDA est ~5× plus rapide sur toutes les durées. Pour les dictées courtes (< 5 s, usage interactif typique), la différence est de ~600 ms — à la limite du perceptible. Pour la transcription de long format (réunions, podcasts), CUDA est quasi-obligatoire.

Installation manuelle par distribution

Téléchargez les paquets depuis la page des releases.

Ubuntu / Debian

Variante CPU :

sudo apt install ./dictee-cpu_1.3.3_amd64.deb

Variante CUDA — nécessite d'ajouter d'abord le dépôt APT CUDA NVIDIA :

# 1) Ajouter le dépôt CUDA NVIDIA (configuration unique)
wget https://developer.download.nvidia.com/compute/cuda/repos/ubuntu2404/x86_64/cuda-keyring_1.1-1_all.deb
sudo dpkg -i cuda-keyring_1.1-1_all.deb
sudo apt update

# 2) Installer dictée (toutes les dépendances résolues automatiquement)
sudo apt install ./dictee-cuda_1.3.3_amd64.deb

Remplacez ubuntu2404 par la version de votre distribution (ubuntu2204, ubuntu2410…). Matrice complète sur developer.download.nvidia.com/compute/cuda/repos.

Fedora / openSUSE

Variante CPU :

sudo dnf install ./dictee-cpu-1.3.3-1.x86_64.rpm

Variante CUDA — ajoutez d'abord le dépôt DNF CUDA NVIDIA :

# Exemple Fedora 41
sudo dnf config-manager addrepo --from-repofile=\
  https://developer.download.nvidia.com/compute/cuda/repos/fedora41/x86_64/cuda-fedora41.repo

sudo dnf install ./dictee-cuda-1.3.3-1.x86_64.rpm

Arch Linux (AUR)

Deux fichiers PKGBUILD sont maintenus à la racine du dépôt : PKGBUILD (CPU) et PKGBUILD-cuda (CUDA, avec ONNX Runtime intégré + wheels nvidia-*-cu12). Les deux fonctionnent sur x86_64 et aarch64.

Variante CPU :

git clone https://github.com/rcspam/dictee.git
cd dictee
makepkg -si

Variante CUDA :

git clone https://github.com/rcspam/dictee.git
cd dictee
makepkg -p PKGBUILD-cuda -si

Le PKGBUILD-cuda déclare le tarball ONNX Runtime dans source=() (téléchargé par makepkg), embarque libonnxruntime{,_providers_cuda,_providers_shared}.so, et exécute pip install nvidia-*-cu12 dans /opt/dictee/cuda-venv au post_install — symétrique avec pre_remove. Vous n'avez besoin que du pilote NVIDIA sur l'hôte ; aucun paquet cuda / cudnn système n'est requis.

Les deux PKGBUILDs incluent options=('!lto') et c'est OBLIGATOIRE sur Arch. /etc/makepkg.conf active LTO globalement, et combiné avec le static libonig.a d'onig_sys, le linker drop des sections et échoue avec undefined reference to onig_*. Retirer !lto reproduira le bug.

Tarball portable

Fonctionne sur tout Linux basé sur glibc (Slackware, Void, Gentoo, NixOS via nix-ld, etc.) :

tar xzf dictee-1.3.3_amd64.tar.gz
cd dictee-1.3.3
sudo ./install.sh

Le tarball intègre les binaires Rust, le plasmoid, les unités systemd utilisateur, et toutes les dépendances Python de l'UI. Il installe dans /usr/bin/, /usr/share/dictee/ et /usr/lib/systemd/user/.

Depuis les sources

git clone https://github.com/rcspam/dictee.git
cd dictee

# CPU uniquement
cargo build --release

# CUDA + diarisation
cargo build --release --features "cuda,sortformer"

sudo ./install.sh

Voir Developer-Guide pour la liste complète des features Cargo (coreml, tensorrt, openvino, webgpu…) et les scripts build-deb.sh / build-rpm.sh utilisés pour produire les paquets officiels.

ARM64 / Jetson

Aucun paquet ARM64 pré-compilé n'est publié — compilez depuis les sources sur l'appareil cible.

Plateforme Supportée Notes
NVIDIA Jetson (Orin, Xavier, Nano) ✅ CUDA Utilisez JetPack 6+ ; compilez avec --features cuda,sortformer
Raspberry Pi 4/5 ⚠ CPU seul Vosk recommandé pour la RAM limitée (~50 Mo modèle)
Apple Silicon (via Asahi Linux) ⚠ CPU seul Pas d'accélération GPU ; la feature coreml est macOS-only
Tout autre aarch64 ⚠ CPU seul Chemin tarball portable

Vérification post-install

Après installation, vérifiez la configuration :

# Binaire présent
which dictee
# → /usr/bin/dictee

# Service daemon activé (doit montrer 'active')
systemctl --user status dictee

# Détection du backend ASR
dictee-switch-backend status
# → ASR: parakeet (dictee.service, active)
# → Translate: google (trans)

Lancer la configuration

dictée ne s'ouvre pas automatiquement à l'installation. L'étape suivante est de lancer dictee-setup — au premier lancement, l'assistant de configuration guidé s'ouvre et vous fait passer en revue backend ASR, raccourcis, traduction, microphone, etc., puis écrit ~/.config/dictee/dictee.conf.

Quatre façons de le lancer

Méthode Commande / Action
Terminal dictee-setup (ou dictee-setup --wizard pour forcer l'assistant)
Menu d'applications Chercher « Configuration de Dictée » dans le menu de votre bureau (Paramètres · Accessibilité)
Icône tray Clic droit sur l'icône dictée → Configurer Dictée
Widget plasmoid Clic droit sur le plasmoid dictée → Configurer (KDE Plasma 6 uniquement)

Le premier lancement (sans dictee.conf existant) ouvre l'assistant 8 étapes automatiquement. Une fois l'assistant terminé, la même commande ré-ouvre l'interface sidebar classique — voir le tour complet : Configuration.

Après avoir complété l'assistant, associez votre raccourci clavier global et déclenchez une transcription de test :

# Test de transcription (micro requis, affichera une notification
# "dictée démarrée" puis transcrira pendant votre durée par défaut)
dictee

Désinstallation

Désinstallation une ligne (recommandée)

Le désinstalleur universel détecte automatiquement comment dictée a été installée (.deb / .rpm / pacman / tarball) et retire chaque couche. Les configurations utilisateur et les modèles sont préservés sauf si --purge est passé :

curl -fsSL https://raw.githubusercontent.com/rcspam/dictee/master/uninstall.sh | bash

Options (après --) :

# Supprimer aussi configs + modèles (wipe complet)
curl -fsSL https://raw.githubusercontent.com/rcspam/dictee/master/uninstall.sh | bash -s -- --purge

# Sauter le prompt interactif de suppression modèles (garde modèles, retire l'app seulement)
curl -fsSL https://raw.githubusercontent.com/rcspam/dictee/master/uninstall.sh | bash -s -- --keep-models

# Non interactif (valeurs par défaut, aucun prompt)
curl -fsSL https://raw.githubusercontent.com/rcspam/dictee/master/uninstall.sh | bash -s -- --non-interactive

Désinstallation manuelle par distribution

Debian / Ubuntu :

sudo apt remove --purge dictee-cpu dictee-cuda dictee-plasmoid

Fedora / openSUSE :

sudo dnf remove dictee-cpu dictee-cuda dictee-plasmoid

Arch Linux :

sudo pacman -Rns dictee

Installation tarball / depuis les sources :

sudo /usr/share/dictee/uninstall.sh

La désinstallation du paquet préserve votre configuration utilisateur (~/.config/dictee/, règles personnalisées, dictionnaire) et le cache de modèles (~/.cache/dictee/ ou /usr/share/dictee/tdt/). Pour tout supprimer :

rm -rf ~/.config/dictee/ ~/.cache/dictee/
sudo rm -rf /usr/share/dictee/tdt/ /usr/share/dictee/canary/

Étapes suivantes

📖 dictee Wiki

🇬🇧 Home · 🇫🇷 Accueil

Getting started / Premiers pas

Speech recognition / ASR

Translation / Traduction

Post-processing / Post-traitement

CLI

Reference / Référence

🏠 Repo · 📦 Releases · 🐛 Issues

Clone this wiki locally