Démarrage rapide — Vue d'ensemble¶
Temps jusqu'à la première requête bout-en-bout : 30 min walltime. Temps jusqu'au premier ressenti (sans installation) : 2 min.
Bienvenue. Ce guide en 9 chapitres vous emmène de zéro à votre première requête bout-en-bout sur AKKO. Que vous soyez data engineer, analyste, steward ou administrateur, chaque étape est courte, copier-coller, et validée contre la démo live à chaque release.
Qu'est-ce qu'AKKO ?¶
AKKO (Analytics Kernel, Keep Ownership) est une plateforme souveraine de données et d'IA que vous déployez sur votre propre infrastructure et opérez pour toujours. Elle est layer-first : chaque capacité nécessaire pour faire tourner un lakehouse moderne est livrée comme une couche pluggable, câblée avec SSO, gouvernance et observabilité dès le départ. Apportez vos serveurs, votre laptop ou votre cloud souverain — AKKO fonctionne de la même façon partout.
Les 10 couches Lego¶
AKKO est construite comme dix couches composables. Vous pouvez en remplacer n'importe laquelle sans réécrire les autres.
| # | Couche | Rôle |
|---|---|---|
| 1 | Compute | Transformations distribuées sur les tables lakehouse, batch et streaming. |
| 2 | Query Engine | SQL fédéré sur tous les catalogues, avec filtrage de lignes et de colonnes piloté par rôle. |
| 3 | Storage | Stockage objet compatible S3 qui héberge les zones raw, curated et serving. |
| 4 | Catalog | Format de table ouvert + catalogue REST exposant des tables gouvernées et versionnées. |
| 5 | Orchestration | Ordonnanceur de pipelines avec émission de lineage, retries et alertes SLA. |
| 6 | Lab | IDE notebooks dans le navigateur avec Python, R, Julia, Quarto et VS Code. |
| 7 | BI | Dashboards en libre service et SQL Lab ad-hoc avec assets partagés. |
| 8 | AI | Requêtes en langage naturel, RAG, passerelle de modèles, évaluation, inférence. |
| 9 | Governance | Fournisseur d'identité, moteur de politiques, piste d'audit et surface de revue steward. |
| 10 | Observability | Métriques, logs, traces, alertes et portail de dashboards unique. |
Pourquoi dix couches et pas une seule stack ? Chaque couche publie un contrat Protocol. Vous pouvez remplacer le moteur par défaut par un moteur partenaire en changeant une seule valeur Helm. Pas de re-platforming.
Pour qui ce guide ?¶
| Persona | Ce que vous allez apprendre |
|---|---|
| Data engineer | Démarrer la plateforme, brancher un catalogue, exécuter des transforms distribués. |
| Analyste | Poser une question en langage naturel, explorer un dashboard généré, le partager. |
| Steward | Reviewer les tags suggérés par l'IA, gouverner le PII, sortir des rapports d'audit. |
| Admin | Gérer les rôles, définir les scopes data, appliquer la politique d'identité. |
| Prospect | Visiter la démo live en 2 minutes, sans installation. |
Deux façons de suivre ce guide¶
Voie A — Démo live (instantanée)¶
Aucune installation. Ouvrez https://demo.akko-ai.com, connectez-vous avec un persona pré-injecté et faites le tour dans votre navigateur. Commencez par le chapitre 01 — Démarrage rapide (démo live).
Voie B — k3d local (15 min)¶
Déployez AKKO sur votre laptop avec Docker Desktop ou Colima. Vous possédez chaque couche, chaque octet reste local. Commencez par le chapitre 02 — Installer sur votre laptop.
Carte des chapitres¶
| # | Chapitre | Durée | Persona |
|---|---|---|---|
| 1 | Démarrage rapide — Démo live (sans installation) | 2 min | tout le monde |
| 2 | Installer sur votre laptop (k3d local) | 15 min | engineer / admin |
| 3 | Première connexion et les 5 personas | 5 min | tout le monde |
| 4 | Première requête — SQL en langage naturel | 5 min | analyste / engineer |
| 5 | Premier dashboard — Surface BI | 5 min | analyste / viewer |
| 6 | Première source de données — Ajouter un catalogue | 5 min | engineer / admin |
| 7 | Tour de gouvernance — RBAC Plateforme vs Data | 5 min | admin / steward |
| 8 | Dépannage | référence | tout le monde |
| 9 | Prochaines étapes | 2 min | tout le monde |
Conventions¶
Chaque chapitre suit la même forme :
- Estimation de durée en tête (
Durée : 5 min). - Badge persona en tête (
Persona : alice (admin)). - Un petit encadré Pré-requis.
- Des étapes numérotées avec commandes copier-coller et un Résultat attendu pour chacune.
- Des captures d'écran aux moments-clés.
- Une section Dépannage listant les 3 à 5 problèmes les plus fréquents.
- Un lien Suivant vers le chapitre suivant.
Toutes les commandes et URLs utilisent un placeholder
DEMO_HOSTque vous pouvez surcharger. Par défauthttps://demo.akko-ai.com(le bac à sable public). Pour une installation locale, remplacez-le par votre propre domaine (par exemplehttps://demo.akko.local).
Prêt ? Ouvrez le chapitre 1.