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

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.1
File Size Uploaded Provenance Actions
zeroruntime-0.2.1.tar.gz 205.3 kB Without provenance Details for zeroruntime-0.2.1.tar.gz

Built distribution (wheel)

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

Total release size: 475.7 kB

Release files / zeroruntime-0.2.1.tar.gz

Download URL zeroruntime-0.2.1.tar.gz
Size 205.3 kB
Tags Source
SHA-256 checksum
How to use checksums
cc95ede68d1d7fe5f5fb835584b050b43cdfb07886f270c19329e45e2204febd
BLAKE2b-256 checksum
How to use checksums
ac58e4d24f7e02c756132d7555bfcac4a419b08ffd40ff1ae9e318b20d875bfe
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.1-py3-none-any.whl

Download URL zeroruntime-0.2.1-py3-none-any.whl
Size 270.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
489ad74971e48d01a3ea8ef68232e0d1f51f93b81e4fb8c6f6fa67ebdaa38e07
BLAKE2b-256 checksum
How to use checksums
38430c7dc08a58d1c1148b7d7c943d8c4096732b89d6bc13aadd6dbde29f7cdc
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.1

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