Orkeon
Contribuer

Une contribution utile abaisse le coût d’essayer Orkeon.

Orkeon est un projet jeune : un premier retour d’usage, même court, compte autant qu’un correctif.

Exemples

Ajouter une équipe d’exemple

  1. Choisissez l’une des catégories sous examples/ (nouvel onglet), où le dépôt publie ses équipes d’exemple.
  2. Écrivez l’équipe et son README d’après le gabarit (nouvel onglet).
  3. Vérifiez-la sans modèle avec orkeon run config.yaml --validate, puis sur un modèle local. Sous examples/, le fichier d’équipe s’appelle config.yaml ; celui de l’exemple de démarrage, crew.yaml. orkeon run exécute l’un comme l’autre.
  4. Ouvrez une pull request selon le guide de contribution (nouvel onglet).
  5. À la première, acceptez l’accord de contribution (nouvel onglet), une fois par compte.
examples/<catégorie>/<nn>-<nom>/une équipe d’exemple
config.yaml    # l’équipe : agents, tâches, outils, montages
usecase.yaml   # la fiche du cas d’usage, copiée d’un exemple voisin
README.md      # d’après le gabarit, en anglais
data/          # seulement si l’équipe monte ./data

Pour compiler et tester le dépôt, depuis votre fork, avec le SDK .NET 10 :

git clone https://github.com/your-username/orkeon.git && cd orkeon
dotnet restore Orkeon.sln
dotnet build Orkeon.sln --no-restore
dotnet test Orkeon.sln --no-build --filter "Category!=Integration&Category!=Slow"

Par l’accord de contribution, vous gardez votre droit d’auteur et accordez une licence au mainteneur du projet, transférable à la structure qui le portera.

Limites
  • L’accord de contribution est encore un brouillon, en attente de relecture juridique.
  • Orkeon est tenu par un seul mainteneur, sans support commercial.
Priorités

Les chantiers qui passent d’abord

  • Les bugs trouvés en lançant les exemples sur un modèle local.
  • Les tests d’interopérabilité MCP contre les serveurs de référence.
  • La performance.
  • La documentation, en anglais et en français, à jour dans le même commit.
Orientation

La stabilité de ce qui existe passe avant les ajouts

Un nouveau fournisseur de modèles, outil intégré, mode d’orchestration ou backend de mémoire attend qu’un besoin réel le demande. D’ici là, il s’écrit dans un fichier .ork.ts ou un plugin, sans toucher au cœur.

Canaux

Questions et bugs se traitent en public

Les Discussions (nouvel onglet) reçoivent les retours d’usage, les questions, les idées et les démonstrations. Un bug se signale dans les Issues d’Orkeon (nouvel onglet) ; un bug de Studio, dans celles d’Orkeon Studio (nouvel onglet).

Sécurité

Une faille se signale en privé

Écrivez à contact@orkeon.org, ou passez par le signalement privé de GitHub (onglet « Security » du dépôt, « Report a vulnerability »). La politique de sécurité (nouvel onglet) dit quoi joindre.