Recipe

livekit-agent-worker

A LiveKit agent worker on Kubernetes via the helm provider's Workload synthesis, running an image the Release supplies (no external Helm chart, because the project publishes none for this service, and no pinned image, because it publishes none of those either — the agent framework ships as a language package). It renders a stateless Deployment, and a ConfigMap only for files a connection or the component's own `inject:` block dictates: no Service, because the worker serves no application traffic, and no volume for state, because it keeps a session's state in memory. The worker is configured entirely on the environment, in the variables the framework itself reads: the media server's WebSocket address and API key identifier, composed from the host, port and api_key the media server publishes, the dispatch name, and the log level. The one port declared is the framework's own health endpoint, which is a container port the probes reach on the pod address and which no Service publishes, so the worker exposes nothing to the rest of the Release. The token-signing secret arrives from the credential on the media_server connection as an env secretKeyRef, so the plaintext secret never appears in the worker's own manifest. The public key identifier travels over the same edge, so one key pair is authored once. A media_server connection writing an `inject:` block, or the component's own block, also delivers the names it dictates, as variables or as files mounted at the paths it names, beside the framework's variables. provides.agent_name is the dispatch name the Aggregate authored, republished so a consumer writing a dispatch rule reads it rather than repeating it.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:d068e26fde5dcd7c058880bf9b0159a252b9a76d2d9da683364b502c08e44395
Published
2026-11-10T10:25:08Z
Signing identity
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Signature

  • Officialapplication/vnd.dev.sigstore.bundle.v0.3+json

    https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

    sha256:197f79ff98e3d2d69ca4acb92beff6dcf2dbc7ecb8096090030a7669c2bee272

Reference at this version

oci://hub.aggrega.ai/recipe/helm/livekit-agent-worker:1.0.0
Target
—
Implements
core/ai-agent/livekit-agent-worker:1.0.0

Provides

Deterministic pointer templates this recipe wires for consumers.

NameTemplate
agent_name{{ .values.agent_name }}

Workload

Workload · replicas: 1 · containers: main

Locals

No locals declared.

Values mapping

No values mapping declared.

Relationships

Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.

Uses

Used by

Nothing in the catalog depends on this entity.

Recipe concept reference →

The Aggrega catalog — an open index of components, features, recipes, and the plugins that render them.

Built with the shared Aggrega design system.

Privacy