yera.config.schema.profiles

Yera profile schemas: top-level environment context.

Symbols

class Profile — A Yera profile — one named environment context.
class ProfileModelDefaults — Yera profile model default values.
class ProfileProviderConnections — Yera profile provider connection config.
class Profiles — Yera profiles config loaded from ``yera.toml``.

Profile

Inherits: BaseModel

A Yera profile — one named environment context.

Ties together a set of provider connections and optional model defaults. The active profile is resolved via CLI --profile flag → pyproject.toml → yera.toml default.

Fields

name
type: str (required)

Name used to identify and select this profile.

description
type: str | None = None

A human-readable description of this profile.

providers
type: yera.config.schema.profiles.ProfileProviderConnections = <factory>

Map of provider type to connection name, e.g. {"aws": "work", "ollama": "local"}. Only providers needed by this profile need to be listed.

model_defaults
type: yera.config.schema.profiles.ProfileModelDefaults = <factory>

Map of model type to default model id, e.g. {"llm": "aws.meta.llama3"}. Optional — missing defaults are a runtime error when a default is actually needed.

mcp
type: list[str] = <factory>

Ordered names of MCP server connections enabled for this profile.

ProfileModelDefaults

Inherits: BaseModel

Yera profile model default values.

Fields

llm
type: str | None = None

Model identifier used by default for language generation.

embedding
type: str | None = None

Model identifier used by default for text embeddings.

tts
type: str | None = None

Model identifier used by default for text-to-speech generation.

stt
type: str | None = None

Model identifier used by default for speech-to-text transcription.

reranker
type: str | None = None

Model identifier used by default for document reranking.

ProfileProviderConnections

Inherits: BaseModel

Yera profile provider connection config.

Fields

anthropic
type: str | None = None

Connection this profile uses for Anthropic.

openai
type: str | None = None

Connection this profile uses for OpenAI.

mistral
type: str | None = None

Connection this profile uses for Mistral.

aws
type: str | None = None

Connection this profile uses for AWS.

azure
type: str | None = None

Connection this profile uses for Azure.

ollama
type: str | None = None

Connection this profile uses for Ollama.

llama_cpp
type: str | None = None

Connection this profile uses for llama.cpp.

openrouter
type: str | None = None

Connection this profile uses for OpenRouter.

gemini
type: str | None = None

Connection this profile uses for Gemini.

Methods

empty — Check if none of the profile's provider connections are configured.

ProfileProviderConnections.empty

empty() → bool

Check if none of the profile's provider connections are configured.

Returns

type: bool

True if none of the profile's provider connections are configured,

Profiles

Inherits: BaseModel

Yera profiles config loaded from yera.toml.

Raises

ValueError

If default is not a key in profiles.

Fields

default
type: str | None = None

Name of the profile to use when no override is set. Required — setup creates a default profile automatically.

profiles
type: dict[str, yera.config.schema.profiles.Profile] = <factory>

Named Yera profiles, keyed by profile name.

Methods

default_profile_exists — Check that the default profile name exists in profiles.

Profiles.default_profile_exists

default_profile_exists() → Profiles

Check that the default profile name exists in profiles.

Returns

type: Profiles

This validated profiles configuration.

Raises

ValueError

If default is not a key in profiles.