dictia-public/deployment/README.md

DictIA — Deployment Infrastructure

Infrastructure de deploiement reproductible pour DictIA .

Choix de profil

Quel est ton setup?
    |
    +-- VPS / serveur cloud?
    |   --> cloud (ASR Proxy GCP GPU on demand)
    |
    +-- Machine locale avec GPU NVIDIA?
    |   --> local-gpu (WhisperX sur GPU, le plus rapide)
    |
    +-- Machine locale sans GPU?
        --> local-cpu (WhisperX sur CPU, lent mais fonctionnel)

Quickstart

git clone https://gitea.innova-ai.ca/Innova-AI/dictia-public.git
cd dictia
git checkout dictia-branding
bash deployment/setup.sh

Le script detecte le hardware et guide l'installation.

Architecture

deployment/
├── setup.sh                  # Installateur principal
├── docker/
│   ├── docker-compose.cloud.yml
│   ├── docker-compose.local-cpu.yml
│   ├── docker-compose.local-gpu.yml
│   └── .env.example
├── asr-proxy/                # Proxy GCP GPU (cloud seulement)
│   ├── proxy.py
│   ├── dashboard.html
│   ├── requirements.txt
│   ├── setup.sh
│   └── asr-proxy.service
├── security/                 # Securite Docker (cloud)
│   ├── docker-daemon.json
│   ├── iptables-rules.sh
│   └── docker-iptables.service
├── config/
│   ├── nginx/dictia.conf
│   ├── tailscale/setup-serve.sh
│   └── systemd/dictia.service
├── tools/
│   ├── backup.sh
│   ├── restore.sh
│   ├── update.sh
│   └── health-check.sh
└── docs/
    ├── QUICKSTART.md
    ├── VPS-SETUP.md
    ├── LOCAL-SETUP.md
    ├── MAINTENANCE.md
    └── TROUBLESHOOTING.md

Profil Cloud

Internet --> Tailscale --> VPS
                           |
                      DictIA :8899
                           |
                      ASR Proxy :9090
                           |
                      GCP GPU (auto start/stop)
                           |
                      WhisperX :9000

Profil Local GPU/CPU

localhost:8899 --> DictIA container
                       |
                  WhisperX container :9000
                       |
                  GPU local (ou CPU)

Documentation

• QUICKSTART.md — Demarrage rapide par profil
• VPS-SETUP.md — Setup VPS complet from scratch
• LOCAL-SETUP.md — Setup local GPU/CPU
• MAINTENANCE.md — Backup, restore, update, monitoring
• TROUBLESHOOTING.md — Problemes courants + solutions

Mise a jour upstream

Tous les fichiers dans deployment/ sont specifiques a DictIA. Aucun conflit lors des merges upstream, sauf deployment/setup.sh (qui remplace le setup.sh original de Speakr).