Skip to main content

zeroruntime

Build real-time voice agents in Python. You describe the agent — instructions, tools, and a pipeline of providers — and the runtime runs it.

Install

pip install zeroruntime

or pin the version:

pip install zeroruntime==0.1.0

Requires Python 3.10 or newer.

Most providers need no extra: their credential is a string you set in the environment, so the base install is enough.

Quickstart

import zeroruntime
from zeroruntime import Agent, Pipeline, Room, function_tool
from zeroruntime.inference import TurnDetector
from zeroruntime.plugins import CartesiaTTS, DeepgramSTT, GoogleLLM, SileroVAD

# The agent registers as ZERORUNTIME_AGENT_ID (default "zeroruntime_agent").
# Agent cloud sets it to the deployment's agent id.


class VoiceAgent(Agent):
    def __init__(self) -> None:
        super().__init__(
            instructions="You are a helpful voice assistant.",
            pipeline=Pipeline(
                stt=DeepgramSTT(),
                llm=GoogleLLM(),
                tts=CartesiaTTS(),
                vad=SileroVAD(),
                turn_detector=TurnDetector(),
            ),
        )

    async def on_enter(self) -> None:
        await self.session.say("Hello, how can I help you today?")

    @function_tool
    async def get_weather(self, latitude: str, longitude: str) -> dict:
        """Fetch the current weather for a location.

        Args:
            latitude: Latitude of the location. Estimate it; do not ask.
            longitude: Longitude of the location. Estimate it; do not ask.
        """
        return {"latitude": latitude, "longitude": longitude, "temperature_c": 28}


def invoke_agent() -> None:
    zeroruntime.invoke(room=Room(name="Cascade Agent", playground=True))


if __name__ == "__main__":
    zeroruntime.serve(VoiceAgent, on_ready=invoke_agent)

Run it and the playground URL is printed once, on stdout. Open it to talk to the agent.

Credentials

Set your runtime token in the environment before serving:

export ZERORUNTIME_AUTH_TOKEN="..."

Vendor keys go in the environment too, one per provider you use — each provider names the variable it reads when the key is missing.

Providers

zeroruntime.plugins calls the vendor directly with your key on your account. zeroruntime.inference reaches a subset of the same providers through the runtime gateway instead. The names mirror each other, so swapping the import swaps who makes the call and who is billed:

from zeroruntime.plugins import DeepgramSTT    # your Deepgram account
from zeroruntime.inference import DeepgramSTT  # through the gateway

Metadata

Release files for zeroruntime 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for zeroruntime 0.2.2
File Size Uploaded Provenance Actions
zeroruntime-0.2.2.tar.gz 211.3 kB Without provenance Details for zeroruntime-0.2.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for zeroruntime 0.2.2
File Interpreter ABI Platform Actions
zeroruntime-0.2.2-py3-none-any.whl Python 3 none any Details for zeroruntime-0.2.2-py3-none-any.whl

Total release size: 489.8 kB

Release files / zeroruntime-0.2.2.tar.gz

Download URL zeroruntime-0.2.2.tar.gz
Size 211.3 kB
Tags Source
SHA-256 checksum
How to use checksums
2963e6f8b4208b4ab95b2fe93b1749cca30d5996ac412ba7afb55924e7eb82d9
BLAKE2b-256 checksum
How to use checksums
aa2a7d08f45d350c2574bb3d7be300c91f9e6356a81c2bef40b4dafbd692d47b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.24 {"installer":{"name":"uv","version":"0.9.24","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / zeroruntime-0.2.2-py3-none-any.whl

Download URL zeroruntime-0.2.2-py3-none-any.whl
Size 278.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b9b942297c49ca62ac79ade0ba61ec5cb09b8870e6f3d20647056110890ab98a
BLAKE2b-256 checksum
How to use checksums
a6941335be1f27e4e8c2f5b5b33a99a97f6aa9a73c1867e6c1ff6ddebe119da6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.24 {"installer":{"name":"uv","version":"0.9.24","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for zeroruntime 0.2.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.2.2 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page