yera.cli.commands.setup

Interactive setup commands.

Symbols

def cred_group — Interactive three-step wizard for credential group setup.
def hub — Interactive setup for a Yera Hub connection.
def setup — Run the Yera guided setup wizard.

cred_group

cred_group(
    ctx: Annotated[AppContext, Parameter(parse=False, show=False)],
) → None

Interactive three-step wizard for credential group setup.

Step 1: prompt for credential group name and write [tool.yera.overrides] cred-group. Step 2: add current project root to authorised_roots (TOFU). Step 3: optionally add initial credentials interactively.

hub

hub(
    local: bool = False,
    ctx: Annotated[AppContext, Parameter(parse=False, show=False)],
) → None

Interactive setup for a Yera Hub connection.

Parameters

local
type: bool = False

Required for now: only local hub setup is implemented. Prompts for hub name and URL and writes yera.toml, creating the file if missing.

setup

setup(
    profile: Annotated[str | None, Parameter(name='--profile', help='Name for the new profile. Prompted if omitted.')] = None,
    update: Annotated[bool, Parameter(name='--update', help='Overwrite an existing profile rather than erroring.', negative='')] = False,
    ctx: Annotated[AppContext, Parameter(parse=False, show=False)],
) → None

Run the Yera guided setup wizard.

Detects available provider credentials automatically, sets up provider connections, discovers available models, and creates a named profile wiring everything together.

Parameters

profile
type: Annotated[str | None, Parameter(name='--profile', help='Name for the new profile. Prompted if omitted.')] = None

Name for the new profile. If omitted, prompted interactively. Defaults to default if no profiles are configured yet.

update
type: Annotated[bool, Parameter(name='--update', help='Overwrite an existing profile rather than erroring.', negative='')] = False

If true, overwrite an existing profile rather than raising an error.