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

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.0
File Size Uploaded Provenance Actions
zeroruntime-0.2.0.tar.gz 198.4 kB Without provenance Details for zeroruntime-0.2.0.tar.gz

Built distribution (wheel)

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

Total release size: 460.1 kB

Release files / zeroruntime-0.2.0.tar.gz

Download URL zeroruntime-0.2.0.tar.gz
Size 198.4 kB
Tags Source
SHA-256 checksum
How to use checksums
4802058ead705f73c385e9ade66cad827923de3308daab024428085d93e7087b
BLAKE2b-256 checksum
How to use checksums
f28b63b692ca47837d6f6d57531e2ec1ca3b82828729d93e41b0424872a67217
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.0-py3-none-any.whl

Download URL zeroruntime-0.2.0-py3-none-any.whl
Size 261.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e897bc27edb9848e37fda6442cdfa118aabc7f15c3d8c203f691cf58d3025566
BLAKE2b-256 checksum
How to use checksums
a3e00c8050cb849f2151ac93d239453d113be9e9e2e8bc74a9189eb97fbf7baa
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.0

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