feat(openalice): déploiement in-cluster de l'agent IA financier (back-end finance d'Asa) (#61)

Déploie TraderAlice/OpenAlice (AGPL-3.0) dans le namespace ai comme back-end de
connaissances financières pour Asa, consommé via le connecteur MCP Ask.

- CI build-openalice.yml : rebuild depuis le Dockerfile amont (ref épinglée v0.60.0-beta.1)
  → ghcr.io/alkatrazz24/funk-openalice, bump manifest sur main
- k8s/apps/openalice : Deployment (restricted + fsGroup, Recreate), PVC 5Gi NFS /data,
  Service web:47331 + mcpask:3003, IngressRoute openalice.lab.local
- ArgoCD app + doc admin/ia/openalice.md (RAG) + MAJ CLAUDE.md
- Cerveau hybride : LiteLLM/Qwen3-8B local (gratuit) + Claude basculable ; données
  TraderHub (sans clé) + FMP gratuit. Lecture/recherche seule — aucun broker, zéro trading.

Onboarding premier boot (Web UI) imposé : credentials scellés dans /data par design.

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
ALI YESILKAYA 2026-06-28 12:39:35 +02:00 committed by GitHub
parent ebb2eec184
commit c2f7255da0
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
9 changed files with 341 additions and 1 deletions

View file

@ -0,0 +1,24 @@
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
name: openalice
namespace: argocd
finalizers:
- resources-finalizer.argocd.argoproj.io
spec:
project: default
source:
repoURL: git@github.com:Alkatrazz24/Funk-lab.git
targetRevision: main
path: k8s/apps/openalice
directory:
recurse: true
destination:
server: https://kubernetes.default.svc
namespace: ai
syncPolicy:
automated:
prune: true
selfHeal: true
syncOptions:
- CreateNamespace=true

View file

@ -0,0 +1,67 @@
# OpenAlice — agent IA financier (in-cluster)
[TraderAlice/OpenAlice](https://github.com/TraderAlice/OpenAlice) — *"one-person Wall Street"* :
agent autonome de recherche financière (actions, crypto, commodités, forex, macro). **AGPL-3.0**.
Déployé in-cluster (namespace `ai`, `openalice.lab.local`) comme **back-end de connaissances
financières d'Asa** : Asa lui parle via le connecteur **MCP Ask** (cf. PR outil `ask_alice`).
> ⚠️ **Logiciel beta, expérimental.** Ici on l'utilise en **lecture/recherche uniquement** :
> **aucun broker (UTA) connecté → zéro trading réel.** Données de marché via **TraderHub**
> (hébergé, sans clé) + clé **FMP** gratuite optionnelle pour les cours live.
## Image
Pas d'image publique : la CI (`.github/workflows/build-openalice.yml`) rebuild depuis le
Dockerfile amont à une **ref épinglée** (`OPENALICE_REF`) → `ghcr.io/alkatrazz24/funk-openalice`.
Changer de version = éditer `OPENALICE_REF` puis relancer le workflow (`workflow_dispatch`).
## Architecture du déploiement
| Composant | Détail |
|---|---|
| Deployment | 1 réplica, `Recreate` (volume RWO), PodSecurity *restricted* (uid 1000, `fsGroup` 1000) |
| PVC `openalice-data` | 5Gi NFS → `/data` (auth CLIs, sessions, **config + credentials scellés**, caches) |
| Service `openalice` | `web:47331` (Web UI) + `mcpask:3003` (MCP Ask, in-cluster, pour Asa) |
| IngressRoute | `openalice.lab.local` → 47331 |
Le cerveau d'Alice **n'est pas** une clé Claude par défaut : on le pointe sur **LiteLLM
(`storage-01:4000`) → Qwen3-8B** (gratuit), avec Claude basculable (hybride). Tout se règle
au **premier boot** (voir ci-dessous) car OpenAlice **scelle ses credentials dans `/data`**
(impossible à seeder en clair via ConfigMap — par design).
## Pré-requis manuels (une fois)
### 1. Secret de pull GHCR (si absent du ns `ai`)
```bash
kubectl -n ai create secret docker-registry ghcr-pull \
--docker-server=ghcr.io \
--docker-username=Alkatrazz24 \
--docker-password=<GHCR_PAT_read_packages>
```
### 2. Premier boot — onboarding via la Web UI
OpenAlice génère un **token admin** (256 bits) au premier démarrage. Le récupérer :
```bash
kubectl -n ai logs deploy/openalice | grep -i token
```
Ouvrir **http://openalice.lab.local**, coller le token, puis configurer :
1. **Settings AI Provider** — ajouter un credential **OpenAI-compatible** :
- baseUrl `http://192.168.10.1:4000/v1` · modèle `hermes-default` (ou `qwen3-8b`) · apiKey `lm-studio`
- (option **hybride**) ajouter aussi un credential **Anthropic** (Claude) avec ta clé pour basculer.
2. **Settings Market Data** — laisser **TraderHub** activé (par défaut). Ajouter la clé
**FMP** (palier gratuit, [financialmodelingprep.com](https://site.financialmodelingprep.com))
pour les cours/K-lines live (hors hub).
3. **Connectors MCP Ask****activer**, port **3003**. C'est l'entrée qu'Asa consomme
(`askWithSession`) via `http://openalice:3003` in-cluster.
Tout ceci est **persisté + scellé** dans le volume → survit aux redémarrages et rebuilds d'image.
## Asa (STT-server)
L'outil `ask_alice(question)` de la boucle agentique d'Asa délègue à Alice via MCP Ask
(`http://openalice:3003`). Voir `admin/ia/openalice.md` et le déploiement `stt`.

View file

@ -0,0 +1,81 @@
apiVersion: apps/v1
kind: Deployment
metadata:
name: openalice
namespace: ai
spec:
replicas: 1
# OpenAlice écrit dans un volume RWO (NFS) — pas de rolling avec 2 pods sur le même volume.
strategy:
type: Recreate
selector:
matchLabels:
app: openalice
template:
metadata:
labels:
app: openalice
spec:
# Image privée sur ghcr → secret de pull créé manuellement dans le ns ai
# (cf. README : kubectl create secret docker-registry ghcr-pull ...)
imagePullSecrets:
- name: ghcr-pull
# Conformité PodSecurity "restricted" (namespace ai). fsGroup 1000 → le volume NFS
# (HOME des CLIs + /data) est inscriptible par l'uid non-root de l'image.
securityContext:
runAsNonRoot: true
runAsUser: 1000
runAsGroup: 1000
fsGroup: 1000
seccompProfile:
type: RuntimeDefault
containers:
- name: openalice
# Tag amont géré par la CI (build-openalice.yml) : bumpé en <ref> à chaque build main.
image: ghcr.io/alkatrazz24/funk-openalice:v0.60.0-beta.1
securityContext:
allowPrivilegeEscalation: false
capabilities:
drop: ["ALL"]
ports:
- name: web
containerPort: 47331
# MCP Ask connector — consommé in-cluster par Asa (STT-server). À ACTIVER une fois
# au premier boot (Web UI Connectors) : { mcpAsk: { enabled: true, port: 3003 } }.
- name: mcpask
containerPort: 3003
env:
# OpenAlice stocke ses credentials (provider IA, clés vendor) SCELLÉS dans /data,
# configurés au premier boot via la Web UI — voir README. Rien de secret en env ici.
- name: TZ
value: "Europe/Paris"
# Derrière Traefik (entrypoint web) : on fait confiance au proxy in-cluster pour
# les en-têtes (IP réelle / host). LAN privé, HTTP.
- name: OPENALICE_TRUSTED_PROXIES
value: "10.42.0.0/16"
# Web UI Hono : le portail 47331 répond mais peut 401 derrière le gate admin →
# sonde TCP plutôt qu'HTTP. Démarrage lent (runtime Node + CLIs agent embarqués).
readinessProbe:
tcpSocket:
port: 47331
initialDelaySeconds: 20
periodSeconds: 15
livenessProbe:
tcpSocket:
port: 47331
initialDelaySeconds: 60
periodSeconds: 30
resources:
requests:
cpu: 200m
memory: 512Mi
limits:
cpu: "1"
memory: 1536Mi
volumeMounts:
- name: data
mountPath: /data
volumes:
- name: data
persistentVolumeClaim:
claimName: openalice-data

View file

@ -0,0 +1,14 @@
apiVersion: traefik.io/v1alpha1
kind: IngressRoute
metadata:
name: openalice
namespace: ai
spec:
entryPoints:
- web
routes:
- match: Host(`openalice.lab.local`)
kind: Rule
services:
- name: openalice
port: 47331

View file

@ -0,0 +1,14 @@
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: openalice-data
namespace: ai
spec:
# /data : auth des CLIs agent, sessions, config (credentials SCELLÉES au repos),
# caches, archive news, historique trading. Persiste config + onboarding premier boot.
accessModes:
- ReadWriteOnce
storageClassName: nfs
resources:
requests:
storage: 5Gi

View file

@ -0,0 +1,16 @@
apiVersion: v1
kind: Service
metadata:
name: openalice
namespace: ai
spec:
selector:
app: openalice
ports:
- name: web
port: 47331
targetPort: 47331
# MCP Ask — consommé par le STT-server (Asa) : http://openalice:3003 (in-cluster).
- name: mcpask
port: 3003
targetPort: 3003