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.1.9

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.1.9
File Size Uploaded Provenance Actions
zeroruntime-0.1.9.tar.gz 176.9 kB Without provenance Details for zeroruntime-0.1.9.tar.gz

Built distribution (wheel)

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

Total release size: 410.5 kB

Release files / zeroruntime-0.1.9.tar.gz

Download URL zeroruntime-0.1.9.tar.gz
Size 176.9 kB
Tags Source
SHA-256 checksum
How to use checksums
6f61898257c770875c3a70796483e47c967f4045b47bee0be8b0989ceb5aaa13
BLAKE2b-256 checksum
How to use checksums
c9b5eaff5474c0df84340fdd3b61115aa99d7349b22dbdeccd9d45d09d7fe053
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.1.9-py3-none-any.whl

Download URL zeroruntime-0.1.9-py3-none-any.whl
Size 233.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8199f71dc90c9b5307992650a3e298fd10399ab1649f27a9b261aefd948b9a5b
BLAKE2b-256 checksum
How to use checksums
97e3b82c649d7345f13d1681be788c5356a695f9d67882d9c780d88af989dac5
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.1.9

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.1.9 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