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.

Installer la ligne de commande
dotnet tool install -g Orkeon.Scripting.CliDemande le SDK .NET 10. Un script .ork.ts demande aussi esbuild (npm install -g esbuild) ; une équipe YAML, non.
sudo apt install orkeon orkeon-archive-keyringAvant la première installation, ajoutez une fois la source signée.
Vérifiez l’empreinte de l’archive avant de l’extraire :
shasum -a 256 --check --ignore-missing SHA256SUMSL’archive se télécharge sur la page des versions (nouvel onglet) : osx-arm64 pour Apple Silicon, osx-x64 pour Intel. La formule Homebrew n’est pas encore publiée.
tar -xzf orkeon-cli-*-osx-arm64.tar.gz && cd orkeon-cli-*-osx-arm64 && ./install.shL’archive n’est ni signée par un Apple Developer ID ni notarisée : install.sh retire lui-même la quarantaine de macOS. En cas de refus : xattr -dr com.apple.quarantine ~/.local/lib/orkeon.
Vous venez pour Studio ? Une fois la ligne de commande installée, revenez télécharger Orkeon Studio.
L’installateur .msi n’est pas signé : Windows SmartScreen demande confirmation (Informations complémentaires → Exécuter quand même). Comparez d’abord son empreinte à sa ligne dans SHA256SUMS.msi :
Get-FileHash .\orkeon-*-win-x64.msi -Algorithm SHA256L’archive zip, sans installation
Prenez orkeon-cli-*-win-x64.zip, dont l’empreinte est dans SHA256SUMS, puis double-cliquez sur install.cmd.
À lancer sur votre poste de travail.
Premier essai, sur un modèle local
Installer les prérequis
Ollama (nouvel onglet), installé une fois. Le SDK .NET 10 ne sert qu’à la voie
dotnet tool.Télécharger le modèle local
ollama pull qwen2.5:1.5bInstaller Orkeon
Ou par une autre voie d’installation.
dotnet tool install -g Orkeon.Scripting.CliCré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-quickstartorkeon run crew.yaml --mount ./out:/output:rwrefuséPuis le même dossier, monté en lecture seule : l’écriture est refusée. orkeon run crew.yaml --mount ./out:/output:rofile_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.
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 updatePuis :
sudo apt install orkeon orkeon-archive-keyringConteneur, 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.0Prenez 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.
- 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.