Cloud quickstart

VoiceGateway Hosted Cloud is a managed collector, ClickHouse-backed storage, and shared dashboard at dash.voicegateway.dev. You bring your own provider API keys (OpenAI, Deepgram, Cartesia, and the rest). Your agent pushes per-call telemetry (spend, latency, call counts) to the hosted ingest endpoint, and the dashboard renders it. We store the telemetry rows, nothing else. The same attach() and guard() calls you use for self-hosting work identically here. Only the sink changes: a remote collector instead of a local SQLite file.

	Self-Host (OSS)	Hosted Cloud
Storage	SQLite, single process	ClickHouse, multi-tenant
Ingest	local sink, no network hop	push to `VOICEGW_COLLECTOR_URL`
Dashboard	`voicegw serve` on port 8080	`dash.voicegateway.dev`
Setup	`pip install` plus `voicegw.yaml`	three env vars
Right for	local dev, small teams, self-managed infra	multi-agent fleets, SaaS products, agency work

The SFU and SIP layers run from your own CLI either way.

The hosted cloud never receives your call audio or transcripts. attach() reads per-component metrics events (cost, latency, errors) and pushes only those numeric rows to the collector.

Open dash.voicegateway.dev and create an account. After signing in, go to Settings > Ingest keys and issue a new key.The key looks like vk_.... Copy it into your secret store immediately. The dashboard shows the full key only once.The same page shows your personal ingest URL, in the form:

https://<your-cloud-api-host>/v1/ingest

Copy that URL too. You will need both values in the next step.

Set the three environment variables

attach() reads three variables. Set them in your agent’s runtime environment (your shell, Dockerfile, Railway/Fly secret store, or .env file):

export VOICEGW_COLLECTOR_URL="https://<your-cloud-api-host>"
export VOICEGW_API_KEY="vk_your_ingest_key"
export VOICEGW_PROJECT="my-agent"

When VOICEGW_COLLECTOR_URL is present, attach() builds a remote sink that batches rows and pushes them to the hosted collector instead of writing to local SQLite. The vk_ key authenticates the request and maps every row to your tenant. VOICEGW_PROJECT tags every captured row so costs appear per-project on the dashboard.

Use your platform’s secret manager so the vk_ key never lands in source control.

Add attach() to your agent

Call attach() with no project= argument and it picks up VOICEGW_PROJECT automatically. Pass project= explicitly to override the env var for a specific call.

LiveKit
Pipecat

import voicegateway
from livekit.agents import AgentSession

async def entrypoint(ctx):
    session = AgentSession(...)
    voicegateway.attach(session)  # project comes from VOICEGW_PROJECT
    await session.start(...)

import voicegateway
from pipecat.pipeline.pipeline import Pipeline
from pipecat.pipeline.task import PipelineParams, PipelineTask

pipeline = Pipeline([...])
task = PipelineTask(
    pipeline,
    params=PipelineParams(enable_metrics=True, enable_usage_metrics=True),
)
voicegateway.attach(task)  # project comes from VOICEGW_PROJECT

That is the whole integration. The three env vars point telemetry at the hosted collector and tag every row with your project. Pass project= to attach() to override the env var for a specific session.

Watch costs land on the dashboard

Run a call. Within a few seconds, open dash.voicegateway.dev and navigate to your project. You will see spend, latency, and call counts broken down by STT, LLM, and TTS.

If rows do not appear after the first call, check that all three env vars are exported in the process that runs your agent, then see Troubleshooting.

Pricing

Plan	Price
Free	Permanent free tier
Pro	$9 for the first month, then$ 29/mo
Agency	$199/mo

See voicegateway.dev for the full breakdown and current usage-metered details.

Next steps

attach() reference

Full options for the attach call: project, budget, metadata, and flush behaviour.

guard() reference

Add real-time budget enforcement and per-call spend limits on top of attach.

Quickstart

Run the collector locally or on your own infra instead of using hosted cloud.

Setup

Run it

Deploy

Pricing

Next steps

attach() reference

guard() reference

Quickstart

​Pricing

​Next steps

attach() reference

guard() reference

Quickstart

Pricing

Next steps