Erste Schritte

Von der Installation bis zur ersten ausgeführten URI in vier Schritten. Die urirun CLI und der Python-Import-Namespace heißen beide urirun.

1. Installieren

Direkt von GitHub:

pip install "git+https://github.com/if-uri/urirun.git@main#subdirectory=adapters/python"

In der IFURI App ist urirun standardmäßig verfügbar — siehe die ifuri-app urirun-* Befehle.

2. Eine Registry erzeugen

Scanne ein Projekt und kompiliere eine Runtime-Registry mit einem einzigen Befehl. Der Scanner liest explizite Binding-Dateien, Dockerfile-Labels, Package-Skripte, Python-Entry-Points, Makefile-Targets und Shell-Skripte.

urirun scan ./project \
  --out generated/bindings.v2.json \
  --registry-out generated/registry.json

3. Routen prüfen

urirun validate generated/bindings.v2.json
urirun list generated/registry.json

4. Eine URI ausführen

Für befehlsartige Routen ist der Dry-Run die Voreinstellung (kein Risiko — er zeigt, was ausgeführt würde):

urirun run 'cli://local/git/status' --registry generated/registry.json

Die echte Ausführung benötigt eine Policy-Datei und das --execute-Flag:

urirun run 'cli://local/git/status' \
  --registry generated/registry.json \
  --policy policy.json \
  --allow 'cli://local/**' \
  --execute

Halte Shell-Templates hinter einer expliziten Policy mit allowShellTemplates: true. Das ist der sicherere Weg, statt Shell-Befehle von Hand zusammenzusetzen (urisys): Die URI-Adresse bleibt stabil und die Payload wird per Schema validiert.