Yera Hub

The hub command interacts with a remote Yera Hub instance. Use it to upload compiled agents, trigger runs and stream their output, inspect uploaded agent metadata, and delete agents or individual versions. All subcommands resolve the target hub from the same priority order: an explicit --hub flag, then pyproject.toml, then the default in yera.toml.

yera hub

Upload, run, list, and delete apps on a remote hub.

yera hub upload

Upload an app from a Python file to the hub.

Args:
    app_path: Path to the Python file that defines the app.
    app_id: Hub-side app id override. Defaults to the loaded app's
        metadata identifier.
    hub: Hub name override. Resolution order: this flag, then
        ``pyproject.toml`` ``[tool.yera] hub``, then ``yera.toml``
        ``[hubs] default``.

yera hub upload APP_PATH [--app-id STR] [--hub STR]

Arguments

APP_PATH
type: str (required)

Path to the Python file that defines the app.

Options

--app-id
type: str = None

Hub-side app id override. Defaults to the loaded app's metadata identifier.

--hub
type: str = None

Hub name override. Resolution order: this flag, then pyproject.toml [tool.yera] hub, then yera.toml [hubs] default.

yera hub run

Run an uploaded app on the hub and stream output.

Args:
    app_id: App id on the hub.
    app_version: Version to run. If omitted, the hub uses the latest version.
    hub: Hub name override. Resolution order: this flag, then
        ``pyproject.toml`` ``[tool.yera] hub``, then ``yera.toml``
        ``[hubs] default``.

yera hub run APP_ID [APP_VERSION] [--hub STR]

Arguments

APP_ID
type: str (required)

App id on the hub.

APP_VERSION
type: int = None

Version to run. If omitted, the hub uses the latest version.

Options

--hub
type: str = None

Hub name override. Resolution order: this flag, then pyproject.toml [tool.yera] hub, then yera.toml [hubs] default.

yera hub get

Show one app and its versions as JSON.

Args:
    app_id: App id on the hub.
    hub: Hub name override. Resolution order: this flag, then
        ``pyproject.toml`` ``[tool.yera] hub``, then ``yera.toml``
        ``[hubs] default``.

yera hub get APP_ID [--hub STR]

Arguments

APP_ID
type: str (required)

App id on the hub.

Options

--hub
type: str = None

Hub name override. Resolution order: this flag, then pyproject.toml [tool.yera] hub, then yera.toml [hubs] default.

yera hub list

List all apps on the hub as JSON.

Args:
    hub: Hub name override. Resolution order: this flag, then
        ``pyproject.toml`` ``[tool.yera] hub``, then ``yera.toml``
        ``[hubs] default``.

yera hub list [--hub STR]

Options

--hub
type: str = None

Hub name override. Resolution order: this flag, then pyproject.toml [tool.yera] hub, then yera.toml [hubs] default.

yera hub delete

Delete an app or one of its versions from the hub.

Args:
    app_id: App id on the hub.
    app_version: If set, delete only this version. If omitted, all versions
        are deleted.
    hub: Hub name override. Resolution order: this flag, then
        ``pyproject.toml`` ``[tool.yera] hub``, then ``yera.toml``
        ``[hubs] default``.

yera hub delete APP_ID [APP_VERSION] [--hub STR]

Arguments

APP_ID
type: str (required)

App id on the hub.

APP_VERSION
type: int = None

If set, delete only this version. If omitted, all versions are deleted.

Options

--hub
type: str = None

Hub name override. Resolution order: this flag, then pyproject.toml [tool.yera] hub, then yera.toml [hubs] default.