Windows

Fenêtres¶

Ce document couvre l'installation de l'application principale karaoké sur Windows, pour le service Demucs, se référer à Services aux entreprises.

1. Télécharger Python/UV et dépendances¶

Python 3.11 ou plus tard, assurez-vous de vérifier "Ajouter Python à PATH" lors de l'installation.
UV
ffmpeg 6.0 ou une version ultérieure, ajouter à PATH.
Deno ajouter à PATH, seulement si nécessaire.

2. Ajouter un binaire à PATH¶

Ouvrez « Modifier les variables d'environnement système » et ajoutez ce qui suit à PATH :

C:\Tools\ffmpeg\bin (ou partout où vous avez installé ffmpeg, ffprobe et ffplay.exe)
chemin Deno si nécessaire, par exemple C:\Tools\deno

Vérifier sur la ligne de commande :

ffmpeg -version
uv --version
deno --version  # only if needed
python --version

3. Télécharger et configurer l'application¶

git clone https://github.com/vttc08/demucs-karaoke-app.git
cd demucs-karaoke-app
uv venv
uv pip install -e .

Tip

Si git n'est pas disponible, vous pouvez télécharger le zip de GitHub et l'extraire.

Note

L'installation par défaut n'inclut pas numpy et scipy, qui sont nécessaires pour synchronisation vocale. Si vous avez besoin d'une synchronisation vocale, installez le vocal-sync supplémentaire:

uv pip install -e .[vocal-sync]

4. Construire la documentation¶

Pour la configuration non-Docker, la documentation statique n'est pas incluse. Il est bon d'exécuter l'application sans elle et d'utiliser le documentation en ligne. Pour construire la documentation, installez mkdocs et mkdocs-material:

uv pip install mkdocs mkdocs-material mkdocs-minify-plugin mkdocs-static-i18n
uv run scripts/build_docs.py

5. Configurer l'environnement¶

cp .env.example .env

La configuration d'environnement par défaut devrait fonctionner pour la plupart des cas d'utilisation. Vous pouvez examiner la configuration détaillée dans le Configuration page.

6. Exécution de la demande¶

uv run uvicorn main:app --host 0.0.0.0 --port 8000

Pour le démarrage sans surveillance, utilisez Task Scheduler ou un wrapper de service comme NSSM. Store media, cache, logs et la base SQLite sous un répertoire que le compte de service peut lire et écrire.

7. Configurer l'utilisateur admin et les préréglages par défaut¶

Pendant l'exécution de l'application, ouvrez une autre fenêtre PowerShell dans le répertoire de l'application. Créez le premier utilisateur d'administration et installez les préréglages d'étape par défaut :

uv run python scripts/admin_user.py create --username admin
uv run python scripts/default_presets.py

Une fois l'application en cours d'exécution, ouvrez http://<your-server-ip>:8000/login et connectez-vous avec l'utilisateur administrateur que vous venez de créer.