Instalación Manual y Configuración de Python

Si desea desarrollar motores personalizados, contribuir a OneASR o ejecutarlo de forma nativa en Apple Silicon Mac sin Docker, siga esta guía de configuración.

---

1. Requisitos Previos

• Python: 3.10 o 3.11 (el soporte para Python 3.12+ está en desarrollo)
• FFmpeg: Necesario para la decodificación y remuestreo de audio (brew install ffmpeg en macOS, apt install ffmpeg en Ubuntu)
• Git y Git LFS: Para clonar el repositorio y los pesos de los modelos

---

2. Clonación y Configuración del Entorno

# 1. Clonar el repositorio
git clone https://github.com/codeAndxv/OneASR.git
cd OneASR

# 2. Crear entorno virtual de Python
python3 -m venv .venv
source .venv/bin/activate

# 3. Actualizar pip e instalar dependencias principales
pip install --upgrade pip
pip install -r requirements.txt

---

3. Descarga de Modelos

Coloque los pesos de los modelos en el directorio models/ según los motores habilitados en config.yaml:

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

# Modelo de Streaming X-ASR (Sherpa-ONNX Zipformer)
# Coloque encoder, decoder, joiner y tokens.txt dentro de models/chunk-160ms-model/

---

4. Ejecución del Servidor

Inicie el servidor FastAPI mediante Uvicorn:

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

Salida:

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. Desarrollo de la Consola Web

El frontend integrado está construido con Vue 3 + Vite:

cd web
npm install
npm run dev   # Se ejecuta en http://localhost:5173 con proxy hacia :8000