zeroruntime 0.1.0b1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (88) hide show
  1. zeroruntime-0.1.0b1/LICENSE +54 -0
  2. zeroruntime-0.1.0b1/PKG-INFO +143 -0
  3. zeroruntime-0.1.0b1/README.md +100 -0
  4. zeroruntime-0.1.0b1/pyproject.toml +99 -0
  5. zeroruntime-0.1.0b1/setup.cfg +4 -0
  6. zeroruntime-0.1.0b1/zeroruntime.egg-info/PKG-INFO +143 -0
  7. zeroruntime-0.1.0b1/zeroruntime.egg-info/SOURCES.txt +86 -0
  8. zeroruntime-0.1.0b1/zeroruntime.egg-info/dependency_links.txt +1 -0
  9. zeroruntime-0.1.0b1/zeroruntime.egg-info/requires.txt +23 -0
  10. zeroruntime-0.1.0b1/zeroruntime.egg-info/top_level.txt +1 -0
  11. zeroruntime-0.1.0b1/zrt/__init__.py +62 -0
  12. zeroruntime-0.1.0b1/zrt/_client/__init__.py +1 -0
  13. zeroruntime-0.1.0b1/zrt/_client/auth.py +118 -0
  14. zeroruntime-0.1.0b1/zrt/_client/channel.py +342 -0
  15. zeroruntime-0.1.0b1/zrt/_client/credentials.py +76 -0
  16. zeroruntime-0.1.0b1/zrt/_client/registry.py +442 -0
  17. zeroruntime-0.1.0b1/zrt/_client/tool_bridge.py +186 -0
  18. zeroruntime-0.1.0b1/zrt/_client/translate.py +166 -0
  19. zeroruntime-0.1.0b1/zrt/_invoke.py +225 -0
  20. zeroruntime-0.1.0b1/zrt/_log_format.py +72 -0
  21. zeroruntime-0.1.0b1/zrt/_mcp_client.py +250 -0
  22. zeroruntime-0.1.0b1/zrt/_plugins/__init__.py +14 -0
  23. zeroruntime-0.1.0b1/zrt/_plugins/_registry.py +104 -0
  24. zeroruntime-0.1.0b1/zrt/_plugins/anam.py +43 -0
  25. zeroruntime-0.1.0b1/zrt/_plugins/anthropic.py +52 -0
  26. zeroruntime-0.1.0b1/zrt/_plugins/assemblyai.py +51 -0
  27. zeroruntime-0.1.0b1/zrt/_plugins/aws.py +91 -0
  28. zeroruntime-0.1.0b1/zrt/_plugins/azure.py +91 -0
  29. zeroruntime-0.1.0b1/zrt/_plugins/cambai.py +51 -0
  30. zeroruntime-0.1.0b1/zrt/_plugins/cartesia.py +70 -0
  31. zeroruntime-0.1.0b1/zrt/_plugins/cerebras.py +49 -0
  32. zeroruntime-0.1.0b1/zrt/_plugins/cometapi.py +77 -0
  33. zeroruntime-0.1.0b1/zrt/_plugins/deepgram.py +100 -0
  34. zeroruntime-0.1.0b1/zrt/_plugins/elevenlabs.py +79 -0
  35. zeroruntime-0.1.0b1/zrt/_plugins/gladia.py +49 -0
  36. zeroruntime-0.1.0b1/zrt/_plugins/google.py +132 -0
  37. zeroruntime-0.1.0b1/zrt/_plugins/groq.py +46 -0
  38. zeroruntime-0.1.0b1/zrt/_plugins/humeai.py +44 -0
  39. zeroruntime-0.1.0b1/zrt/_plugins/inworldai.py +51 -0
  40. zeroruntime-0.1.0b1/zrt/_plugins/lmnt.py +52 -0
  41. zeroruntime-0.1.0b1/zrt/_plugins/murfai.py +49 -0
  42. zeroruntime-0.1.0b1/zrt/_plugins/navana.py +44 -0
  43. zeroruntime-0.1.0b1/zrt/_plugins/neuphonic.py +47 -0
  44. zeroruntime-0.1.0b1/zrt/_plugins/nvidia.py +68 -0
  45. zeroruntime-0.1.0b1/zrt/_plugins/openai.py +145 -0
  46. zeroruntime-0.1.0b1/zrt/_plugins/papla.py +42 -0
  47. zeroruntime-0.1.0b1/zrt/_plugins/resemble.py +44 -0
  48. zeroruntime-0.1.0b1/zrt/_plugins/rime.py +53 -0
  49. zeroruntime-0.1.0b1/zrt/_plugins/rnnoise.py +38 -0
  50. zeroruntime-0.1.0b1/zrt/_plugins/sarvamai.py +104 -0
  51. zeroruntime-0.1.0b1/zrt/_plugins/silero.py +60 -0
  52. zeroruntime-0.1.0b1/zrt/_plugins/simli.py +45 -0
  53. zeroruntime-0.1.0b1/zrt/_plugins/smallestai.py +56 -0
  54. zeroruntime-0.1.0b1/zrt/_plugins/speechify.py +48 -0
  55. zeroruntime-0.1.0b1/zrt/_plugins/ultravox.py +44 -0
  56. zeroruntime-0.1.0b1/zrt/_plugins/xai.py +106 -0
  57. zeroruntime-0.1.0b1/zrt/_serve.py +456 -0
  58. zeroruntime-0.1.0b1/zrt/_spec.py +185 -0
  59. zeroruntime-0.1.0b1/zrt/_version.py +5 -0
  60. zeroruntime-0.1.0b1/zrt/_wire/__init__.py +5 -0
  61. zeroruntime-0.1.0b1/zrt/_wire/zeroruntime_pb2.py +186 -0
  62. zeroruntime-0.1.0b1/zrt/_wire/zeroruntime_pb2.pyi +910 -0
  63. zeroruntime-0.1.0b1/zrt/_wire/zeroruntime_pb2_grpc.py +317 -0
  64. zeroruntime-0.1.0b1/zrt/core/__init__.py +1 -0
  65. zeroruntime-0.1.0b1/zrt/core/_tasks.py +49 -0
  66. zeroruntime-0.1.0b1/zrt/core/agent.py +306 -0
  67. zeroruntime-0.1.0b1/zrt/core/enums.py +137 -0
  68. zeroruntime-0.1.0b1/zrt/core/errors.py +44 -0
  69. zeroruntime-0.1.0b1/zrt/core/events.py +146 -0
  70. zeroruntime-0.1.0b1/zrt/core/mcp.py +74 -0
  71. zeroruntime-0.1.0b1/zrt/core/pipeline.py +237 -0
  72. zeroruntime-0.1.0b1/zrt/core/room.py +215 -0
  73. zeroruntime-0.1.0b1/zrt/core/session.py +1202 -0
  74. zeroruntime-0.1.0b1/zrt/core/stt_stream.py +70 -0
  75. zeroruntime-0.1.0b1/zrt/core/tools.py +199 -0
  76. zeroruntime-0.1.0b1/zrt/core/transfer.py +160 -0
  77. zeroruntime-0.1.0b1/zrt/core/tuning.py +119 -0
  78. zeroruntime-0.1.0b1/zrt/core/utterance.py +47 -0
  79. zeroruntime-0.1.0b1/zrt/inference/__init__.py +80 -0
  80. zeroruntime-0.1.0b1/zrt/inference/_registry.py +45 -0
  81. zeroruntime-0.1.0b1/zrt/inference/denoise.py +44 -0
  82. zeroruntime-0.1.0b1/zrt/inference/llm.py +48 -0
  83. zeroruntime-0.1.0b1/zrt/inference/realtime.py +20 -0
  84. zeroruntime-0.1.0b1/zrt/inference/stt.py +76 -0
  85. zeroruntime-0.1.0b1/zrt/inference/tts.py +62 -0
  86. zeroruntime-0.1.0b1/zrt/inference/turn.py +54 -0
  87. zeroruntime-0.1.0b1/zrt/plugins/__init__.py +134 -0
  88. zeroruntime-0.1.0b1/zrt/py.typed +0 -0
@@ -0,0 +1,54 @@
1
+ Zeroruntime SDK — Proprietary License
2
+
3
+ Copyright (c) 2026 Zujo Tech Pvt Ltd. All rights reserved.
4
+
5
+ This software, including its source code, object code, and accompanying
6
+ documentation (collectively, the "Software"), is the proprietary and
7
+ confidential property of Zujo Tech Pvt Ltd ("Licensor"). The Software is
8
+ licensed, not sold. No ownership rights are transferred to you. "Zero Runtime"
9
+ and "ZRT" are products and services of Zujo Tech Pvt Ltd.
10
+
11
+ 1. License Grant. Subject to your continued compliance with this License (and
12
+ with any separate written agreement you have entered into with Licensor),
13
+ Licensor grants you a limited, non-exclusive, non-transferable, non-
14
+ sublicensable, revocable license to install and use the Software solely to
15
+ develop and operate applications that connect to and interoperate with the
16
+ Zero Runtime service.
17
+
18
+ 2. Restrictions. Except to the extent expressly permitted in Section 1, by a
19
+ separate written agreement with Licensor, or by applicable law that cannot
20
+ be contractually waived, you may NOT:
21
+ (a) copy, modify, adapt, translate, or create derivative works of the
22
+ Software;
23
+ (b) distribute, publish, sublicense, sell, rent, lease, lend, or
24
+ otherwise make the Software available to any third party;
25
+ (c) reverse engineer, decompile, or disassemble the Software, or attempt
26
+ to derive its source code where not provided;
27
+ (d) use the Software to build or operate a product or service that
28
+ competes with the Zero Runtime service; or
29
+ (e) remove, obscure, or alter any proprietary notices, labels, or marks
30
+ on or in the Software.
31
+
32
+ 3. Ownership. The Software is protected by copyright and other intellectual
33
+ property laws and treaties. Licensor and its licensors retain all right,
34
+ title, and interest in and to the Software, including all intellectual
35
+ property rights therein.
36
+
37
+ 4. Termination. This License is effective until terminated. It terminates
38
+ automatically, without notice, if you breach any of its terms. Upon
39
+ termination you must cease all use of the Software and destroy all copies
40
+ in your possession or control.
41
+
42
+ 5. No Warranty. THE SOFTWARE IS PROVIDED "AS IS" AND "AS AVAILABLE", WITHOUT
43
+ WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
44
+ WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE, AND
45
+ NONINFRINGEMENT.
46
+
47
+ 6. Limitation of Liability. TO THE MAXIMUM EXTENT PERMITTED BY LAW, IN NO EVENT
48
+ SHALL LICENSOR BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL,
49
+ CONSEQUENTIAL, OR PUNITIVE DAMAGES, OR ANY LOSS OF PROFITS, DATA, OR USE,
50
+ ARISING OUT OF OR RELATED TO THIS LICENSE OR THE SOFTWARE, WHETHER IN
51
+ CONTRACT, TORT, OR OTHERWISE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
52
+ DAMAGES.
53
+
54
+ For licensing inquiries, contact: support@videosdk.live
@@ -0,0 +1,143 @@
1
+ Metadata-Version: 2.4
2
+ Name: zeroruntime
3
+ Version: 0.1.0b1
4
+ Summary: Build real-time voice agents in Python.
5
+ Author: ZeroRuntime
6
+ License-Expression: LicenseRef-Proprietary
7
+ Project-URL: Homepage, https://github.com/ZeroRuntimeAI/zeroruntime-py
8
+ Project-URL: Repository, https://github.com/ZeroRuntimeAI/zeroruntime-py
9
+ Project-URL: Issues, https://github.com/ZeroRuntimeAI/zeroruntime-py/issues
10
+ Keywords: voice,voice-agents,realtime,speech,stt,tts,llm,grpc
11
+ Classifier: Development Status :: 4 - Beta
12
+ Classifier: Intended Audience :: Developers
13
+ Classifier: Programming Language :: Python :: 3
14
+ Classifier: Programming Language :: Python :: 3.10
15
+ Classifier: Programming Language :: Python :: 3.11
16
+ Classifier: Programming Language :: Python :: 3.12
17
+ Classifier: Programming Language :: Python :: 3.13
18
+ Classifier: Programming Language :: Python :: 3.14
19
+ Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
20
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
21
+ Classifier: Typing :: Typed
22
+ Requires-Python: >=3.10
23
+ Description-Content-Type: text/markdown
24
+ License-File: LICENSE
25
+ Requires-Dist: grpcio>=1.83.0
26
+ Requires-Dist: protobuf<8.0,>=7.35.1
27
+ Requires-Dist: aiohttp>=3.9.0
28
+ Requires-Dist: python-dotenv>=1.0
29
+ Provides-Extra: mcp
30
+ Requires-Dist: mcp>=1.28.0; extra == "mcp"
31
+ Provides-Extra: vision
32
+ Requires-Dist: Pillow>=10.0; extra == "vision"
33
+ Provides-Extra: aws
34
+ Requires-Dist: boto3>=1.34; extra == "aws"
35
+ Provides-Extra: google
36
+ Requires-Dist: google-auth>=2.30; extra == "google"
37
+ Provides-Extra: all
38
+ Requires-Dist: zeroruntime[aws,google,mcp,vision]; extra == "all"
39
+ Provides-Extra: dev
40
+ Requires-Dist: pytest>=8.0; extra == "dev"
41
+ Requires-Dist: grpcio-tools==1.83.0; extra == "dev"
42
+ Dynamic: license-file
43
+
44
+ # zeroruntime
45
+
46
+ Build real-time voice agents in Python. You describe the agent — instructions,
47
+ tools, and a pipeline of providers — and the runtime runs it.
48
+
49
+ > **Beta.** This is a pre-release. The API may still change between betas, so
50
+ > pin an exact version in anything you depend on.
51
+
52
+ ## Install
53
+
54
+ Beta releases are not installed by default, so ask for them explicitly:
55
+
56
+ ```bash
57
+ pip install --pre zeroruntime
58
+ ```
59
+
60
+ or pin the version:
61
+
62
+ ```bash
63
+ pip install zeroruntime==0.1.0b1
64
+ ```
65
+
66
+ Requires Python 3.10 or newer.
67
+
68
+
69
+ Most providers need no extra: their credential is a string you set in the
70
+ environment, so the base install is enough.
71
+
72
+ ## Quickstart
73
+
74
+ ```python
75
+ import zrt
76
+ from zrt import Agent, Pipeline, Room, function_tool
77
+ from zrt.inference import TurnDetector
78
+ from zrt.plugins import CartesiaTTS, DeepgramSTT, GoogleLLM, SileroVAD
79
+
80
+ AGENT_ID = "cascade-basic-agent"
81
+
82
+
83
+ class VoiceAgent(Agent):
84
+ def __init__(self) -> None:
85
+ super().__init__(
86
+ agent_id=AGENT_ID,
87
+ instructions="You are a helpful voice assistant.",
88
+ pipeline=Pipeline(
89
+ stt=DeepgramSTT(),
90
+ llm=GoogleLLM(),
91
+ tts=CartesiaTTS(),
92
+ vad=SileroVAD(),
93
+ turn_detector=TurnDetector(),
94
+ ),
95
+ )
96
+
97
+ async def on_enter(self) -> None:
98
+ await self.session.say("Hello, how can I help you today?")
99
+
100
+ @function_tool
101
+ async def get_weather(self, latitude: str, longitude: str) -> dict:
102
+ """Fetch the current weather for a location.
103
+
104
+ Args:
105
+ latitude: Latitude of the location. Estimate it; do not ask.
106
+ longitude: Longitude of the location. Estimate it; do not ask.
107
+ """
108
+ return {"latitude": latitude, "longitude": longitude, "temperature_c": 28}
109
+
110
+
111
+ def invoke_agent() -> None:
112
+ zrt.invoke(AGENT_ID, room=Room(name="Cascade Agent", playground=True))
113
+
114
+
115
+ if __name__ == "__main__":
116
+ zrt.serve(VoiceAgent, on_ready=invoke_agent)
117
+ ```
118
+
119
+ Run it and the playground URL is printed once, on stdout. Open it to talk to
120
+ the agent.
121
+
122
+ ## Credentials
123
+
124
+ Set your runtime token in the environment before serving:
125
+
126
+ ```bash
127
+ export ZERORUNTIME_AUTH_TOKEN="..."
128
+ ```
129
+
130
+ Vendor keys go in the environment too, one per provider you use — each provider
131
+ names the variable it reads when the key is missing.
132
+
133
+ ## Providers
134
+
135
+ `zrt.plugins` calls the vendor directly with your key on your account.
136
+ `zrt.inference` reaches a subset of the same providers through the runtime
137
+ gateway instead. The names mirror each other, so swapping the import swaps who
138
+ makes the call and who is billed:
139
+
140
+ ```python
141
+ from zrt.plugins import DeepgramSTT # your Deepgram account
142
+ from zrt.inference import DeepgramSTT # through the gateway
143
+ ```
@@ -0,0 +1,100 @@
1
+ # zeroruntime
2
+
3
+ Build real-time voice agents in Python. You describe the agent — instructions,
4
+ tools, and a pipeline of providers — and the runtime runs it.
5
+
6
+ > **Beta.** This is a pre-release. The API may still change between betas, so
7
+ > pin an exact version in anything you depend on.
8
+
9
+ ## Install
10
+
11
+ Beta releases are not installed by default, so ask for them explicitly:
12
+
13
+ ```bash
14
+ pip install --pre zeroruntime
15
+ ```
16
+
17
+ or pin the version:
18
+
19
+ ```bash
20
+ pip install zeroruntime==0.1.0b1
21
+ ```
22
+
23
+ Requires Python 3.10 or newer.
24
+
25
+
26
+ Most providers need no extra: their credential is a string you set in the
27
+ environment, so the base install is enough.
28
+
29
+ ## Quickstart
30
+
31
+ ```python
32
+ import zrt
33
+ from zrt import Agent, Pipeline, Room, function_tool
34
+ from zrt.inference import TurnDetector
35
+ from zrt.plugins import CartesiaTTS, DeepgramSTT, GoogleLLM, SileroVAD
36
+
37
+ AGENT_ID = "cascade-basic-agent"
38
+
39
+
40
+ class VoiceAgent(Agent):
41
+ def __init__(self) -> None:
42
+ super().__init__(
43
+ agent_id=AGENT_ID,
44
+ instructions="You are a helpful voice assistant.",
45
+ pipeline=Pipeline(
46
+ stt=DeepgramSTT(),
47
+ llm=GoogleLLM(),
48
+ tts=CartesiaTTS(),
49
+ vad=SileroVAD(),
50
+ turn_detector=TurnDetector(),
51
+ ),
52
+ )
53
+
54
+ async def on_enter(self) -> None:
55
+ await self.session.say("Hello, how can I help you today?")
56
+
57
+ @function_tool
58
+ async def get_weather(self, latitude: str, longitude: str) -> dict:
59
+ """Fetch the current weather for a location.
60
+
61
+ Args:
62
+ latitude: Latitude of the location. Estimate it; do not ask.
63
+ longitude: Longitude of the location. Estimate it; do not ask.
64
+ """
65
+ return {"latitude": latitude, "longitude": longitude, "temperature_c": 28}
66
+
67
+
68
+ def invoke_agent() -> None:
69
+ zrt.invoke(AGENT_ID, room=Room(name="Cascade Agent", playground=True))
70
+
71
+
72
+ if __name__ == "__main__":
73
+ zrt.serve(VoiceAgent, on_ready=invoke_agent)
74
+ ```
75
+
76
+ Run it and the playground URL is printed once, on stdout. Open it to talk to
77
+ the agent.
78
+
79
+ ## Credentials
80
+
81
+ Set your runtime token in the environment before serving:
82
+
83
+ ```bash
84
+ export ZERORUNTIME_AUTH_TOKEN="..."
85
+ ```
86
+
87
+ Vendor keys go in the environment too, one per provider you use — each provider
88
+ names the variable it reads when the key is missing.
89
+
90
+ ## Providers
91
+
92
+ `zrt.plugins` calls the vendor directly with your key on your account.
93
+ `zrt.inference` reaches a subset of the same providers through the runtime
94
+ gateway instead. The names mirror each other, so swapping the import swaps who
95
+ makes the call and who is billed:
96
+
97
+ ```python
98
+ from zrt.plugins import DeepgramSTT # your Deepgram account
99
+ from zrt.inference import DeepgramSTT # through the gateway
100
+ ```
@@ -0,0 +1,99 @@
1
+ [build-system]
2
+ requires = ["setuptools>=77"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "zeroruntime"
7
+ dynamic = ["version"]
8
+ description = "Build real-time voice agents in Python."
9
+ readme = "README.md"
10
+ requires-python = ">=3.10" # dataclasses kw_only; the whole provider layer needs it
11
+ license = "LicenseRef-Proprietary"
12
+
13
+ license-files = ["LICENSE"]
14
+ authors = [{ name = "ZeroRuntime" }]
15
+ keywords = ["voice", "voice-agents", "realtime", "speech", "stt", "tts", "llm", "grpc"]
16
+
17
+ classifiers = [
18
+ "Development Status :: 4 - Beta",
19
+ "Intended Audience :: Developers",
20
+ "Programming Language :: Python :: 3",
21
+ "Programming Language :: Python :: 3.10",
22
+ "Programming Language :: Python :: 3.11",
23
+ "Programming Language :: Python :: 3.12",
24
+ "Programming Language :: Python :: 3.13",
25
+ "Programming Language :: Python :: 3.14",
26
+ "Topic :: Multimedia :: Sound/Audio :: Speech",
27
+ "Topic :: Software Development :: Libraries :: Python Modules",
28
+ "Typing :: Typed",
29
+ ]
30
+
31
+ # The base install describes sessions and carries credentials. It does not run
32
+ # agents: no audio stack, no ML runtime, and -- by construction -- no vendor SDK.
33
+ # Anything added here is installed on every developer laptop that pip installs
34
+ # this package, so the list is closed and tests/test_packaging.py pins it.
35
+ dependencies = [
36
+ # Both floored by the grpcio-tools pin in [dev], and for the same reason:
37
+ # protoc 1.83.0 stamps its own version into the generated code, and a runtime
38
+ # older than the gencode refuses to load on the first wire import. Declaring a
39
+ # lower floor makes the package installable but not usable.
40
+ #
41
+ # zrt/_wire/*_pb2.py ValidateProtobufRuntimeVersion(7, 35, 1)
42
+ # zrt/_wire/*_pb2_grpc.py GRPC_GENERATED_VERSION = '1.83.0'
43
+ #
44
+ # grpcio said >=1.81.0 while the gencode demanded 1.83.0, so an environment
45
+ # holding 1.82.0 resolved happily and then died at `serve()` with "the grpc
46
+ # package installed is at version 1.82.0, but the generated code ... depends
47
+ # on grpcio>=1.83.0". Keep both floors equal to what scripts/gen.py stamped.
48
+ "grpcio>=1.83.0",
49
+ "protobuf>=7.35.1,<8.0",
50
+ "aiohttp>=3.9.0",
51
+ "python-dotenv>=1.0",
52
+ ]
53
+
54
+ [project.urls]
55
+ Homepage = "https://github.com/ZeroRuntimeAI/zeroruntime-py"
56
+ Repository = "https://github.com/ZeroRuntimeAI/zeroruntime-py"
57
+ Issues = "https://github.com/ZeroRuntimeAI/zeroruntime-py/issues"
58
+
59
+ [project.optional-dependencies]
60
+ mcp = ["mcp>=1.28.0"]
61
+ vision = ["Pillow>=10.0"]
62
+ # Vendor extras exist only where the CLIENT genuinely needs a vendor package,
63
+ # i.e. where the credential is not a static string the client can read from the
64
+ # environment and ship. With descriptor-only providers that is 2 of 35.
65
+ # `pip install zeroruntime[deepgram]` would install literally nothing, so no
66
+ # such extra exists; pip warns about the unknown extra and installs the base.
67
+ aws = ["boto3>=1.34"]
68
+ google = ["google-auth>=2.30"]
69
+ all = ["zeroruntime[mcp,vision,aws,google]"]
70
+
71
+ # Not shipped to users. grpcio-tools carries protoc for scripts/gen.py; without
72
+ # it the wire stage of `gen.py --check` reports itself unavailable rather than
73
+ # passing silently.
74
+ #
75
+ # grpcio-tools is pinned exactly, not floored: `gen.py --check` compares
76
+ # generated bytes, and two protoc versions do not agree on them. A floor turns
77
+ # every grpcio-tools release into a red build on a file nobody touched. Moving
78
+ # the pin is a deliberate commit that regenerates zrt/_wire/ alongside it, and
79
+ # the pinned version decides the `protobuf` floor above -- 1.83.0 stamps the
80
+ # gencode as requiring runtime >= 7.35.1.
81
+ dev = [
82
+ "pytest>=8.0",
83
+ "grpcio-tools==1.83.0",
84
+ ]
85
+
86
+ [tool.setuptools.packages.find]
87
+ include = ["zrt*"]
88
+ namespaces = false
89
+
90
+ [tool.setuptools.package-data]
91
+ zrt = ["py.typed"]
92
+
93
+ [tool.setuptools.dynamic]
94
+ # Read statically out of zrt/_version.py. Pointing this at `zrt.__version__`
95
+ # also works but makes the build import the package.
96
+ version = { attr = "zrt._version.__version__" }
97
+
98
+ [tool.pytest.ini_options]
99
+ testpaths = ["tests"]
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
@@ -0,0 +1,143 @@
1
+ Metadata-Version: 2.4
2
+ Name: zeroruntime
3
+ Version: 0.1.0b1
4
+ Summary: Build real-time voice agents in Python.
5
+ Author: ZeroRuntime
6
+ License-Expression: LicenseRef-Proprietary
7
+ Project-URL: Homepage, https://github.com/ZeroRuntimeAI/zeroruntime-py
8
+ Project-URL: Repository, https://github.com/ZeroRuntimeAI/zeroruntime-py
9
+ Project-URL: Issues, https://github.com/ZeroRuntimeAI/zeroruntime-py/issues
10
+ Keywords: voice,voice-agents,realtime,speech,stt,tts,llm,grpc
11
+ Classifier: Development Status :: 4 - Beta
12
+ Classifier: Intended Audience :: Developers
13
+ Classifier: Programming Language :: Python :: 3
14
+ Classifier: Programming Language :: Python :: 3.10
15
+ Classifier: Programming Language :: Python :: 3.11
16
+ Classifier: Programming Language :: Python :: 3.12
17
+ Classifier: Programming Language :: Python :: 3.13
18
+ Classifier: Programming Language :: Python :: 3.14
19
+ Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
20
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
21
+ Classifier: Typing :: Typed
22
+ Requires-Python: >=3.10
23
+ Description-Content-Type: text/markdown
24
+ License-File: LICENSE
25
+ Requires-Dist: grpcio>=1.83.0
26
+ Requires-Dist: protobuf<8.0,>=7.35.1
27
+ Requires-Dist: aiohttp>=3.9.0
28
+ Requires-Dist: python-dotenv>=1.0
29
+ Provides-Extra: mcp
30
+ Requires-Dist: mcp>=1.28.0; extra == "mcp"
31
+ Provides-Extra: vision
32
+ Requires-Dist: Pillow>=10.0; extra == "vision"
33
+ Provides-Extra: aws
34
+ Requires-Dist: boto3>=1.34; extra == "aws"
35
+ Provides-Extra: google
36
+ Requires-Dist: google-auth>=2.30; extra == "google"
37
+ Provides-Extra: all
38
+ Requires-Dist: zeroruntime[aws,google,mcp,vision]; extra == "all"
39
+ Provides-Extra: dev
40
+ Requires-Dist: pytest>=8.0; extra == "dev"
41
+ Requires-Dist: grpcio-tools==1.83.0; extra == "dev"
42
+ Dynamic: license-file
43
+
44
+ # zeroruntime
45
+
46
+ Build real-time voice agents in Python. You describe the agent — instructions,
47
+ tools, and a pipeline of providers — and the runtime runs it.
48
+
49
+ > **Beta.** This is a pre-release. The API may still change between betas, so
50
+ > pin an exact version in anything you depend on.
51
+
52
+ ## Install
53
+
54
+ Beta releases are not installed by default, so ask for them explicitly:
55
+
56
+ ```bash
57
+ pip install --pre zeroruntime
58
+ ```
59
+
60
+ or pin the version:
61
+
62
+ ```bash
63
+ pip install zeroruntime==0.1.0b1
64
+ ```
65
+
66
+ Requires Python 3.10 or newer.
67
+
68
+
69
+ Most providers need no extra: their credential is a string you set in the
70
+ environment, so the base install is enough.
71
+
72
+ ## Quickstart
73
+
74
+ ```python
75
+ import zrt
76
+ from zrt import Agent, Pipeline, Room, function_tool
77
+ from zrt.inference import TurnDetector
78
+ from zrt.plugins import CartesiaTTS, DeepgramSTT, GoogleLLM, SileroVAD
79
+
80
+ AGENT_ID = "cascade-basic-agent"
81
+
82
+
83
+ class VoiceAgent(Agent):
84
+ def __init__(self) -> None:
85
+ super().__init__(
86
+ agent_id=AGENT_ID,
87
+ instructions="You are a helpful voice assistant.",
88
+ pipeline=Pipeline(
89
+ stt=DeepgramSTT(),
90
+ llm=GoogleLLM(),
91
+ tts=CartesiaTTS(),
92
+ vad=SileroVAD(),
93
+ turn_detector=TurnDetector(),
94
+ ),
95
+ )
96
+
97
+ async def on_enter(self) -> None:
98
+ await self.session.say("Hello, how can I help you today?")
99
+
100
+ @function_tool
101
+ async def get_weather(self, latitude: str, longitude: str) -> dict:
102
+ """Fetch the current weather for a location.
103
+
104
+ Args:
105
+ latitude: Latitude of the location. Estimate it; do not ask.
106
+ longitude: Longitude of the location. Estimate it; do not ask.
107
+ """
108
+ return {"latitude": latitude, "longitude": longitude, "temperature_c": 28}
109
+
110
+
111
+ def invoke_agent() -> None:
112
+ zrt.invoke(AGENT_ID, room=Room(name="Cascade Agent", playground=True))
113
+
114
+
115
+ if __name__ == "__main__":
116
+ zrt.serve(VoiceAgent, on_ready=invoke_agent)
117
+ ```
118
+
119
+ Run it and the playground URL is printed once, on stdout. Open it to talk to
120
+ the agent.
121
+
122
+ ## Credentials
123
+
124
+ Set your runtime token in the environment before serving:
125
+
126
+ ```bash
127
+ export ZERORUNTIME_AUTH_TOKEN="..."
128
+ ```
129
+
130
+ Vendor keys go in the environment too, one per provider you use — each provider
131
+ names the variable it reads when the key is missing.
132
+
133
+ ## Providers
134
+
135
+ `zrt.plugins` calls the vendor directly with your key on your account.
136
+ `zrt.inference` reaches a subset of the same providers through the runtime
137
+ gateway instead. The names mirror each other, so swapping the import swaps who
138
+ makes the call and who is billed:
139
+
140
+ ```python
141
+ from zrt.plugins import DeepgramSTT # your Deepgram account
142
+ from zrt.inference import DeepgramSTT # through the gateway
143
+ ```
@@ -0,0 +1,86 @@
1
+ LICENSE
2
+ README.md
3
+ pyproject.toml
4
+ zeroruntime.egg-info/PKG-INFO
5
+ zeroruntime.egg-info/SOURCES.txt
6
+ zeroruntime.egg-info/dependency_links.txt
7
+ zeroruntime.egg-info/requires.txt
8
+ zeroruntime.egg-info/top_level.txt
9
+ zrt/__init__.py
10
+ zrt/_invoke.py
11
+ zrt/_log_format.py
12
+ zrt/_mcp_client.py
13
+ zrt/_serve.py
14
+ zrt/_spec.py
15
+ zrt/_version.py
16
+ zrt/py.typed
17
+ zrt/_client/__init__.py
18
+ zrt/_client/auth.py
19
+ zrt/_client/channel.py
20
+ zrt/_client/credentials.py
21
+ zrt/_client/registry.py
22
+ zrt/_client/tool_bridge.py
23
+ zrt/_client/translate.py
24
+ zrt/_plugins/__init__.py
25
+ zrt/_plugins/_registry.py
26
+ zrt/_plugins/anam.py
27
+ zrt/_plugins/anthropic.py
28
+ zrt/_plugins/assemblyai.py
29
+ zrt/_plugins/aws.py
30
+ zrt/_plugins/azure.py
31
+ zrt/_plugins/cambai.py
32
+ zrt/_plugins/cartesia.py
33
+ zrt/_plugins/cerebras.py
34
+ zrt/_plugins/cometapi.py
35
+ zrt/_plugins/deepgram.py
36
+ zrt/_plugins/elevenlabs.py
37
+ zrt/_plugins/gladia.py
38
+ zrt/_plugins/google.py
39
+ zrt/_plugins/groq.py
40
+ zrt/_plugins/humeai.py
41
+ zrt/_plugins/inworldai.py
42
+ zrt/_plugins/lmnt.py
43
+ zrt/_plugins/murfai.py
44
+ zrt/_plugins/navana.py
45
+ zrt/_plugins/neuphonic.py
46
+ zrt/_plugins/nvidia.py
47
+ zrt/_plugins/openai.py
48
+ zrt/_plugins/papla.py
49
+ zrt/_plugins/resemble.py
50
+ zrt/_plugins/rime.py
51
+ zrt/_plugins/rnnoise.py
52
+ zrt/_plugins/sarvamai.py
53
+ zrt/_plugins/silero.py
54
+ zrt/_plugins/simli.py
55
+ zrt/_plugins/smallestai.py
56
+ zrt/_plugins/speechify.py
57
+ zrt/_plugins/ultravox.py
58
+ zrt/_plugins/xai.py
59
+ zrt/_wire/__init__.py
60
+ zrt/_wire/zeroruntime_pb2.py
61
+ zrt/_wire/zeroruntime_pb2.pyi
62
+ zrt/_wire/zeroruntime_pb2_grpc.py
63
+ zrt/core/__init__.py
64
+ zrt/core/_tasks.py
65
+ zrt/core/agent.py
66
+ zrt/core/enums.py
67
+ zrt/core/errors.py
68
+ zrt/core/events.py
69
+ zrt/core/mcp.py
70
+ zrt/core/pipeline.py
71
+ zrt/core/room.py
72
+ zrt/core/session.py
73
+ zrt/core/stt_stream.py
74
+ zrt/core/tools.py
75
+ zrt/core/transfer.py
76
+ zrt/core/tuning.py
77
+ zrt/core/utterance.py
78
+ zrt/inference/__init__.py
79
+ zrt/inference/_registry.py
80
+ zrt/inference/denoise.py
81
+ zrt/inference/llm.py
82
+ zrt/inference/realtime.py
83
+ zrt/inference/stt.py
84
+ zrt/inference/tts.py
85
+ zrt/inference/turn.py
86
+ zrt/plugins/__init__.py
@@ -0,0 +1,23 @@
1
+ grpcio>=1.83.0
2
+ protobuf<8.0,>=7.35.1
3
+ aiohttp>=3.9.0
4
+ python-dotenv>=1.0
5
+
6
+ [all]
7
+ zeroruntime[aws,google,mcp,vision]
8
+
9
+ [aws]
10
+ boto3>=1.34
11
+
12
+ [dev]
13
+ pytest>=8.0
14
+ grpcio-tools==1.83.0
15
+
16
+ [google]
17
+ google-auth>=2.30
18
+
19
+ [mcp]
20
+ mcp>=1.28.0
21
+
22
+ [vision]
23
+ Pillow>=10.0