Skip to content

Models & agents

A model performs inference: it interprets input and generates output. An agent is a configured actor that uses a model with session context, available tools and a workflow. A tool call is not a property of the model alone; Aleph decides which capability is exposed and where that operation executes.

The Workshop composes these pieces. Specialized workspaces provide a domain-specific starting environment. Humans remain responsible for reviewing consequential outputs and authorizing connected or privileged actions where appropriate.

Aleph is designed to remain useful when the selected model changes. Use your own credentials for supported API providers, or an installed and authenticated CLI provider. The public getting started guide describes Claude Code and Codex as CLI paths. A local Qwen 8B path requires separate provisioning; model weights are not included in the current DMG. Provider adapters and supported CLI/agent runtimes are build-dependent; a name in the wider ecosystem is not a promise that a particular binary supports it.

BYOK is a credential configuration path, not the same thing as OAuth authorization for an external account. Local inference and remote inference also have different data boundaries. See local runtime and data and connectors and capabilities.

Aleph keeps context, memory, permissions, execution, interfaces, workflow state and artifacts outside any one model provider. This is why model choice is a layer of the application rather than its entire architecture.

  1. Open the model selector in Aleph.
  2. For an API provider, configure your own credentials where requested.
  3. For a CLI provider, install the relevant CLI and authenticate it before selecting it in Aleph.
  4. Check that the provider has current execution access; subscriptions, permissions, and usage limits still apply.

A provider appearing in a selector is not proof that it is installed or authorized. Authorizing a model also does not authorize an account connector. See your first task and the public getting started guide.