Installation Manuelle & Configuration Python

Si vous souhaitez développer des moteurs personnalisés, contribuer à OneASR ou l’exécuter nativement sur Mac Apple Silicon sans Docker, suivez ce guide.

---

1. Prérequis

• Python : 3.10 ou 3.11 (le support de Python 3.12+ est en cours)
• FFmpeg : Requis pour le décodage et le rééchantillonnage audio (brew install ffmpeg sur macOS, apt install ffmpeg sur Ubuntu)
• Git & Git LFS : Pour cloner le dépôt et les poids des modèles

---

2. Clonage & Configuration de l’Environnement

# 1. Cloner le dépôt
git clone https://github.com/codeAndxv/OneASR.git
cd OneASR

# 2. Créer l'environnement virtuel Python
python3 -m venv .venv
source .venv/bin/activate

# 3. Mettre à jour pip et installer les dépendances
pip install --upgrade pip
pip install -r requirements.txt

---

3. Téléchargement des Modèles

Placez les poids des modèles dans le répertoire models/ selon les moteurs activés dans config.yaml :

# Faster-Whisper Medium
git clone https://huggingface.co/Systran/faster-whisper-medium models/faster-whisper-medium

# Modèle de Streaming X-ASR (Sherpa-ONNX Zipformer)
# Placez encoder, decoder, joiner et tokens.txt dans models/chunk-160ms-model/

---

4. Démarrage du Serveur

Lancez le serveur FastAPI via Uvicorn :

uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload

Sortie :

INFO:     Started server process [88412]
INFO:     Waiting for application startup.
INFO:     Preloading ASR Engine: xasr
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)

---

5. Développement de la Console Web

L’interface intégrée est développée avec Vue 3 + Vite :

cd web
npm install
npm run dev   # S'exécute sur http://localhost:5173 avec proxy vers :8000