Assistant IA auto-hébergé : backend Go (API + SPA embarquée), base SQLite, connecteurs LLM multiples (via any-llm), authentification par mot de passe ou OpenID Connect.

Prérequis

Go >= 1.26
Node.js + npm (build du frontend)
(optionnel) un serveur OpenID Connect, ex. Keycloak

Installation

# 1. frontend : build la SPA et l'écrit dans backend/internal/http/web
cd backend/web
npm install
npm run build

# 2. backend
cd ..
go build -o lassistanoque .

Le Makefile du backend enchaîne les deux et produit les binaires multi-plateformes dans build/ :

make build          # linux/amd64, linux/arm64, windows, darwin...

Configuration

La configuration se fait par variables d'environnement, chargeables depuis un fichier .env placé dans le répertoire de lancement (backend) :

Variable	Défaut	Description
`LASSISTANOQUE_DB_TYPE`	`turso`	Type de base (seul `turso`/SQLite est implémenté)
`LASSISTANOQUE_DB_URL`	`lassistanoque.db`	Chemin du fichier SQLite
`LASSISTANOQUE_HTTP_PORT`	`3000`	Port du serveur HTTP
`LASSISTANOQUE_JWT_SECRET`	(obligatoire)	Secret de signature des tokens, ex. `openssl rand -base64 32`
`LASSISTANOQUE_STORAGE_TYPE`	`database`	Stockage des fichiers (seul `database` est implémenté)
`LASSISTANOQUE_SERVER_ID`	`default`	Identifiant du serveur

Exemple backend/.env :

LASSISTANOQUE_JWT_SECRET=<secret généré>
LASSISTANOQUE_HTTP_PORT=3000

Lancement

./lassistanoque serve

Les migrations de la base sont appliquées automatiquement au démarrage (ou manuellement avec ./lassistanoque migrate).
L'application est servie sur http://localhost:3000 (SPA + API /api).
Créez le premier compte depuis la page d'inscription (/register), puis configurez un fournisseur LLM et sa clé d'API dans les réglages de l'espace (settings/models).

Authentification OpenID Connect

Les fournisseurs OIDC sont enregistrés dans la table oidc :

insert into oidc (id, label, domain, client_id, client_secret, wellknown_url, _date_created, _version)
values (
  'keycloak',                          -- identifiant du fournisseur
  'Keycloak',                          -- libellé affiché sur la page de connexion
  'sso.example.com',                   -- domaine du fournisseur
  'lassistanoque',                     -- client_id
  '<client_secret>',
  'https://<keycloak>/realms/<realm>/.well-known/openid-configuration',
  datetime('now'),
  'v1'
);

Côté fournisseur (Keycloak) :

client de type confidential, Standard Flow (authorization code) activé ;
Valid Redirect URIs : http://localhost:3000/api/auth/oidc/callback (l'URL de callback est reconstruite depuis le Host de la requête ; derrière un reverse proxy, transmettre X-Forwarded-Proto et X-Forwarded-Host).

Flux : les fournisseurs configurés apparaissent comme boutons sur la page de connexion → redirection vers le fournisseur → au retour, le backend valide le state signé, échange le code, vérifie le token ID (signature JWKS, émetteur, audience) puis délivre les tokens applicatifs. À la première connexion, l'utilisateur est créé automatiquement avec son espace personnel.

Développement

# backend (API sur :3000)
cd backend
go run . serve

# frontend en mode dev (Vite sur :5173, API proxyfiée vers :3000)
cd web
npm run dev

Structure :

backend/
├── cmd/                 # CLI (serve, migrate, version) et assemblage IoC
├── internal/
│   ├── adapter/         # implémentations : db (turso/SQLite), auth (password, oidc), llm, tools, security (JWT)
│   ├── domain/          # entités et interfaces des repositories
│   ├── http/            # serveur HTTP, routes, SPA embarquée
│   └── service/         # logique métier (auth, chat, agents, tasks...)
└── web/                 # frontend SvelteKit

Tests : go test ./backend/...