Orkeon
Démarrer

Orkeon s’installe sur votre poste, quel que soit votre système.

Le premier essai tourne ensuite sur un modèle local, sans clé d’API. Pour un serveur, voyez la page Déployer.

Kama, une caisse à outils à la main, ouvre la porte de sa petite maison, des cartons empilés autour de lui
Par système

Installer la ligne de commande

.NET, tous systèmes
dotnet tool install -g Orkeon.Scripting.Cli

Demande le SDK .NET 10. Un script .ork.ts demande aussi esbuild (npm install -g esbuild) ; une équipe YAML, non.

À lancer sur votre poste de travail.

Deux minutes

Premier essai, sur un modèle local

  1. Installer les prérequis

    Ollama (nouvel onglet), installé une fois. Le SDK .NET 10 ne sert qu’à la voie dotnet tool.

  2. Télécharger le modèle local

    ollama pull qwen2.5:1.5b
  3. Installer Orkeon

    Ou par une autre voie d’installation.

    dotnet tool install -g Orkeon.Scripting.Cli
  4. Créer l’équipe, puis l’exécuter

    L’exemple de démarrage a un agent, et sa configuration désigne déjà Ollama.

    orkeon quickstart && cd orkeon-quickstart
    orkeon run crew.yaml --mount ./out:/output:rw
    refuséPuis le même dossier, monté en lecture seule : l’écriture est refusée.
    orkeon run crew.yaml --mount ./out:/output:ro
    file_write [FAIL]: Error: Access denied for '/output/hello.md': required Write, effective ReadOnly. Mounts granting Write: (none).

Pour vos propres équipes, orkeon init configure le fournisseur de modèle ; orkeon doctor dit ce qui manque.

Le guide d’installation (nouvel onglet) couvre le conteneur, les prérequis, la vérification de l’empreinte et le retour à une version antérieure.

Source apt

Debian et Ubuntu : ajouter la source signée

Ce bloc vérifie l’empreinte de la clé avant de la poser, puis ajoute la source du canal stable (guide apt (nouvel onglet)).

sudo apt-get update && sudo apt-get install -y ca-certificates curl
curl -fsSL -o /tmp/orkeon-archive-keyring.gpg \
  https://github.com/Orkeon/orkeon/raw/apt/orkeon-archive-keyring.gpg
echo "0cc5e804e1ee49c50ec5b23145ee7ee65d4834a08b8dc38914674249dfcc6a21  /tmp/orkeon-archive-keyring.gpg" | sha256sum --check
sudo install -m 0644 /tmp/orkeon-archive-keyring.gpg /usr/share/keyrings/orkeon-archive-keyring.gpg
sudo tee /etc/apt/sources.list.d/orkeon.sources > /dev/null <<'EOF'
Types: deb
URIs: https://github.com/Orkeon/orkeon/
Suites: raw/apt/stable/
Include: orkeon orkeon-archive-keyring
Signed-By: /usr/share/keyrings/orkeon-archive-keyring.gpg
EOF
sudo apt-get update

Puis :

sudo apt install orkeon orkeon-archive-keyring
Autres voies

Conteneur, package NuGet, sources

En conteneur : l’image embarque les équipes d’exemple, et la commande y ouvre un shell.

docker run -it --rm -e ORKEON_ENTRYPOINT=shell ghcr.io/orkeon/orkeon:1.0.0

Prenez une étiquette de la page des versions (nouvel onglet), jamais latest. L’image ne porte pas d’attestation de provenance : sur un serveur, épinglez-la par son empreinte (@sha256:…).

Dans votre application .NET : dotnet add package Orkeon, et Orkeon.Tools pour les outils intégrés (packages NuGet (nouvel onglet)).

Depuis les sources : git clone https://github.com/Orkeon/orkeon.git, puis dotnet build Orkeon.sln.

Limites
  • L’installateur Windows (.msi) n’est pas signé et l’archive macOS n’est pas notarisée : vérifiez leur empreinte avant de les lancer.
  • L’image de conteneur ne porte pas d’attestation de provenance.
  • La formule Homebrew n’est pas encore publiée.