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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.