---
title: "Kodema : l’usine logicielle open source"
description: "Pipelines de conteneurs, agents de code et approbations humaines derrière une même API. Installez Kodema en une commande, premier pipeline en quelques minutes."
canonical_url: https://optimi.com/fr/docs/kodema
md_url: https://optimi.com/fr/docs/kodema.md
language: fr
alternates:
  - lang: en
    url: https://optimi.com/en/docs/kodema
    md_url: https://optimi.com/en/docs/kodema.md
last_updated: 2026-11-14
---

# Kodema

Kodema est une **usine logicielle API-first et multi-tenant**, publiée sous
licence Apache-2.0 sur [github.com/optimiware/kodema](https://github.com/optimiware/kodema).
Les ingénieurs configurent les projets, les pipelines et les identifiants ; les
utilisateurs soumettent des tâches. Des pipelines de conteneurs, des agents de
code et des outils ordinaires produisent des modifications de code source, des
artefacts testés et des logiciels déployés. Les personnes répondent aux
questions et approuvent les candidats depuis une boîte de réception par rôle.

Tout le modèle tient en une phrase : **un pipeline est une liste ordonnée
d’actions ; une action exécute un conteneur ou demande une réponse ; une
exécution exécute un pipeline une fois ; une tâche est une conversation qui
démarre des exécutions.**

Ces pages décrivent **Kodema 0.2.1**. Le
[journal des modifications](https://github.com/optimiware/kodema/blob/master/CHANGELOG.md)
recense les changements et les limites connues de chaque version.

## Essayer en deux minutes

Sous Linux avec Podman 5 en mode rootless :

```sh
curl -fsSL https://raw.githubusercontent.com/optimiware/kodema/master/install.sh | sh
kodema up
source ~/.kodema/instances/default/env.sh
```

La première ligne installe les binaires `kodema` et `kodactl` dans
`~/.local/bin`, après les avoir vérifiés avec le fichier `SHA256SUMS` de la
version. `kodema up` démarre ensuite un Kodema local complet. Exécutez-y un
fichier de pipeline :

```sh
podman pull docker.io/library/alpine:3.24@sha256:0f49f331d9212aff11b932863be4eb01cdf962969aa86dab7d1ee21ac6f5f52b
cat > hello.yaml <<'EOF'
actions:
  - name: hello
    image: docker.io/library/alpine@sha256:0f49f331d9212aff11b932863be4eb01cdf962969aa86dab7d1ee21ac6f5f52b
    timeout: 2m
    commands:
      - echo "hello from a Kodema workload"
EOF
kodactl run hello.yaml
```

```text
execution execution-a917c44ec73787377abaf074c6b6b61f started
hello from a Kodema workload
execution execution-a917c44ec73787377abaf074c6b6b61f succeeded
```

Le **[démarrage rapide](/fr/docs/kodema/premiers-pas)** se poursuit avec les
approbations, les tâches, la connexion, Git et MCP.

## Comment un pipeline s’exécute

**Une exécution, des actions dans l’ordre**

![Une tâche, un push ou kodactl run démarre une exécution. Ses actions conteneur implement et test s’exécutent dans l’ordre dans un espace de travail partagé, une demande review attend un relecteur sans conteneur, et une acceptation permet à l’action integrate de s’exécuter.](/diagrams/kodema/execution-flow-fr.svg)

*Les actions s’exécutent une à la fois, dans l’ordre de déclaration. Une demande attend une personne ou un service sans retenir de conteneur, puis la même exécution se poursuit dans le même espace de travail.*

Un pipeline est un court fichier YAML. Chaque action conteneur indique une
image et les commandes à y exécuter ; chaque action de demande indique qui doit
répondre. Il n’y a ni conditions, ni branches parallèles, ni graphes de
dépendances à apprendre : le comportement conditionnel a sa place dans vos
scripts.

## Ce que vous pouvez construire

| Cas d’usage | À quoi cela ressemble dans Kodema |
| --- | --- |
| Intégration continue | Un pipeline avec `on.push` démarre à chaque push accepté et exécute vos commandes de test et de build |
| Livraison avec revue | Le build publie une empreinte d’image, une demande interroge `role/reviewer`, l’action suivante promeut exactement cette empreinte |
| Agents de code | Claude Code, Codex, OpenCode ou Pi s’exécutent comme des commandes de conteneur ordinaires et accèdent aux modèles par le proxy de Kodema, sans clé de fournisseur dans le conteneur |
| Travail avec des personnes dans la boucle | Une tâche porte la conversation ; un agent peut poser une question, passer le relais à une personne et reprendre dans une nouvelle exécution |
| Automatisation depuis votre éditeur | Chaque opération est aussi un outil MCP : un client MCP peut donc démarrer, inspecter et approuver le travail |

## Interfaces

- **`kodactl`**, le client en ligne de commande : exécuter des fichiers de
  pipeline, suivre les exécutions, lire les journaux, répondre aux demandes de
  la boîte de réception, gérer les tâches et les membres.
- **API REST** sous `/api/v1` : 58 opérations avec une même enveloppe de requête
  et de réponse, des clés d’idempotence et des versions optimistes.
- **MCP** sur `/mcp` : les mêmes opérations sous forme d’outils, via Streamable
  HTTP ou la passerelle `kodactl mcp stdio`.
- **Git** (facultatif) : un service compagnon avec des règles d’accès de style
  gitolite et des branches protégées par approbation.

## Plan de la documentation

| Page | À lire pour |
| --- | --- |
| **[Démarrage rapide](/fr/docs/kodema/premiers-pas)** | Installer Kodema en local, lancer un pipeline, approuver une demande, démarrer une tâche |
| **[Concepts](/fr/docs/kodema/concepts)** | Comprendre les pipelines, les actions, les exécutions, les tâches, les demandes et les rôles |
| **[Écrire des pipelines](/fr/docs/kodema/guide-developpeur)** | Retrouver les champs YAML, les fichiers visibles par un conteneur, les sorties et des recettes |
| **[Référence CLI](/fr/docs/kodema/cli)** | Trouver une commande, une option ou une variable d’environnement de `kodactl` ou de `kodema` |
| **[API et MCP](/fr/docs/kodema/api)** | Appeler Kodema depuis du code : enveloppe, erreurs, idempotence, routes, clients MCP |
| **[Architecture](/fr/docs/kodema/architecture)** | Voir comment le Kernel, le Shell et le Userland s’articulent |
| **[Exploitation](/fr/docs/kodema/exploitation)** | Choisir une installation, déployer sur Kubernetes, mettre à niveau, sauvegarder et restaurer |

## Choix de conception à connaître

- **Les pipelines sont envoyés par l’API.** Les fichiers conservés dans Git
  sont appliqués avec `kodactl pipeline apply` ; Kodema ne découvre jamais de
  définitions de pipeline lors d’un push.
- **Une exécution est immuable une fois admise.** Elle conserve le YAML exact,
  les empreintes d’image et les entrées avec lesquels elle a démarré. Modifier
  un pipeline ne change pas une exécution en cours.
- **Rien n’est rejoué à l’aveugle.** Une reprise du travail démarre une
  nouvelle exécution à la première action ; une commande interrompue n’est
  jamais reprise.
- **Les artefacts sont des valeurs, pas des entités.** Un build publie des
  octets dans votre registre et enregistre comme sortie une référence figée par
  empreinte.
- **Git, les agents et l’accès aux modèles sont facultatifs.** Un pipeline
  simple n’a besoin d’aucun d’eux.

## État du projet

Kodema 0.2.1 fonctionne sur un hôte unique avec Podman en mode rootless et sur
Kubernetes au moyen des charts Helm. `kodema up` n’a été exécuté que sous
Linux ; les binaires macOS sont compilés et n’ont pas été exécutés. Scaleway
est la seule cible cloud à avoir fonctionné en conditions réelles ; AWS et GCP
sont implémentés et n’ont pas été validés sur un cloud réel. Consultez
**[Exploitation](/fr/docs/kodema/exploitation)** pour la liste complète.

Kodema tire son nom du kodama (木霊), un esprit des arbres du folklore japonais :
il vit dans un arbre et se laisse rarement voir. Les pipelines et les agents
font des commits sur des branches pendant votre absence ; à votre retour, vous
trouvez le résultat, ainsi que tout ce qui attend votre approbation.
