STT-server — orchestrateur AI (in-cluster)
API FastAPI déployée dans le cluster k8s (namespace ai). Reçoit les requêtes des clients
STT et route l'inférence vers LiteLLM (s01) → Qwen3 (g01) / Claude.
API
| Méthode |
Route |
Corps |
Réponse |
GET |
/healthz |
— |
{status, version} |
POST |
/v1/ask |
{text} |
{reply} |
Configuration (variables d'env)
| Var |
Défaut |
Rôle |
STT_LITELLM_URL |
http://192.168.10.1:4000/v1/chat/completions |
endpoint LiteLLM (IP directe s01, cf. open-webui) |
STT_LITELLM_KEY |
lm-studio |
clé LiteLLM (valeur exacte attendue) |
STT_MODEL |
hermes-default |
alias LiteLLM (bascule Qwen/Claude via hermes-switch) |
STT_SYSTEM_PROMPT |
prompt vocal FR concis |
persona |
STT_MAX_TOKENS / STT_TEMPERATURE |
200 / 0.7 |
génération |
Dev local
cd stt/server
pip install -e .
STT_LITELLM_URL=http://192.168.1.200:4000/v1/chat/completions stt-server # :8000
curl -s localhost:8000/healthz
curl -s localhost:8000/v1/ask -H 'content-type: application/json' -d '{"text":"bonjour"}'
Déploiement
- Image construite/poussée par
.github/workflows/build-stt-server.yml → ghcr.io/alkatrazz24/funk-stt-server.
- Manifests :
k8s/apps/stt/ ; Application ArgoCD : k8s/apps-of-apps/apps/stt.yaml (depuis main).
- Accès LiteLLM (hors cluster) : IP directe
192.168.10.1:4000 (même pattern qu'open-webui).
À venir
- Intégration des outils Hermes (« agir sur Funk ») via le gateway
:8080 — nécessite
de spécifier son API. Aujourd'hui : inférence/chat seulement (via LiteLLM).
- Mémoire centralisée : Qdrant (s01) + distillation versionnée (
server/memory/).
- Sessions multi-clients + historique.