Handleiding voor on-premise-implementatie

1. Doelarchitectuur

TranscribIA on-premise gebruikt een zelfstandige Docker Compose -stack die applicatiediensten en databases op één host aanstuurt (of verdeeld volgens uw infrastructuur). Rekenintensieve transcriptie wordt uitgevoerd op een externe GPU-server die daarvoor is bestemd.

De GPU-transcriptieserver (motoren WhisperX en pyannote, CUDA-uitvoering) is een afzonderlijk onderdeel dat met de stack is verbonden. Afhankelijk van uw netwerktopologie kan dit op de GPU-host of op een aparte server draaien.

2. Hardwarevereisten

Applicatieserver

Transcriptieserver — GPU

Transcriptie en diarisatie draaien op een grafische accelerator. Twee hardwaregroepen worden ondersteund:

3. Softwarevereisten

4. Installatiestappen

De repository bevat een Makefile en een .env.example. De standaardprocedure omvat enkele opdrachten:

git clone <repo-transcribia> transcribia
cd transcribia

# 2. Préparer le fichier d'environnement
cp .env.example .env
#   → renseigner DB_PASSWORD, REDIS_PASSWORD, clés IA…

# 3. Installation complète
#    (build images + dépendances Composer/NPM + migrations + seed)
make install

# ── ou, étape par étape ──────────────────────
docker compose build
docker compose up -d
docker compose exec app php artisan key:generate
docker compose exec app php artisan migrate
docker compose exec app php artisan db:seed

Handige doelen: make up, make down, make restart, make logs, make migrate, make seed.

5. Configuratie (.env)

De volgende variabelen sturen database, cache en AI-motoren aan. Bij 100% on-premisewordt de lokale LLM ingeschakeld en blijft de cloudsleutel leeg:

# ── Base de données PostgreSQL ──────────────
DB_DATABASE=transcribia
DB_USERNAME=transcribia
DB_PASSWORD=<mot-de-passe-fort>

# ── Redis (cache + queues + sessions) ────────
REDIS_PASSWORD=<mot-de-passe-fort>

# ── Moteurs IA ───────────────────────────────
ALLOW_LOCAL_LLM=true
LLM_BASE_URL=http://llm-local:8000/v1     # serveur LLM local
OPENROUTER_API_KEY=                         # vide en full on-premise

ALLOW_LOCAL_LLM schakelt generatie (samenvattingen, besluiten enz.) naar uw lokale endpoint, opgegeven via LLM_BASE_URL. Zolang OPENROUTER_API_KEY leeg blijft, gaan geen AI-aanroepen buiten uw infrastructuur.

6. Air-gapmodus (offline)

Voor omgevingen zonder internettoegang werkt TranscribIA volledig offline met drie voorzorgsmaatregelen:

• Vooraf gedownloade modellen : WhisperX- en pyannote-modellen (en eventuele lokale LLM's) worden via een verbonden werkstation van Hugging Face gedownload en naar de doelserver overgebracht.
• Lokaal beschikbare Docker-images : images worden uit een archief geladen (docker load) in plaats van uit een openbaar register opgehaald.
• Handmatige updates : nieuwe versies worden via pakkettoverdracht toegepast, zonder git pull of docker pull online.

export HF_HUB_OFFLINE=1   # Hugging Face : pas d'accès réseau
export TRANSFORMERS_OFFLINE=1

7. Eerste start en controle

Elke dienst in de docker-compose.yml biedt een healthcheck. Controle na de start:

docker compose ps                       # tous les services "healthy"
docker compose exec app php artisan migrate:status
curl -fsS http://localhost:3480/        # page d'accueil (HTTP 200)
docker compose logs -f app              # journaux applicatifs

Een dienst die de status healthy niet bereikt, wijst meestal op een ontbrekende omgevingsvariabele (DB / Redis) of een niet-gedetecteerde GPU op de transcriptieserver.

8. Updates en onderhoud

# Récupérer la nouvelle version
git pull

# Reconstruire + migrer
make install

# Redémarrer proprement
docker compose up -d

• Back-ups : plan regelmatige PostgreSQL-dumps en back-ups van het volume storage/ (audiobestanden, exports), bij voorkeur extern.
• Logrotatie : beheerd door Docker (json-file, 10 MB × 3 bestanden per dienst).
• Patches : beveiligingsupdates worden geleverd door AMBASSADIA SARL en via dezelfde procedure toegepast.

9. Monitoring

• Containerstatus : docker compose ps en ingebouwde healthchecks.
• Applicatielogboeken : docker compose logs -f app (Laravel); gestructureerde logboeken in storage/logs.
• Wachtrijen : monitoring van workers queue, queue-ai, queue-media via Redis.
• GPU : nvidia-smi -l 5 voor de belasting en VRAM van de transcriptieserver.
• Meetgegevens : op verzoek export naar uw bestaande monitoring (Prometheus/Grafana enz.).

10. Verantwoordelijkheden — klant en Transcribia

Indicatieve verdeling van beheerverantwoordelijkheden bij on-premise-implementatie:

De precieze rolverdeling en SLA's worden vastgelegd in de ondersteuningsovereenkomst en on-premiseverwerkersovereenkomst. Deze handleiding vervangt die contractdocumenten niet.