tatolab-stream
The Python SDK for Tatolab, which turns cameras, microphones, screens, models and your own code into realtime streams that browsers, other streams and AI agents can read.
Looking to get started? Install the Tatolab app first, not this package.
tatolab-streamis the library you write streams with. It doesn't run them: the Tatolab runtime on your machine does, and it comes with the app.
- macOS (Apple silicon, macOS 15 or later):
brew install --cask tatolab/tap/tatolab, thenopen -a Tatolab- Linux (x86_64 with a Vulkan GPU):
curl -fsSL https://get.tatolab.com/install.sh | shThen follow the Quickstart.
tatolab newcreates a project that already depends on this package, so you rarelypip installit yourself.
What it is
A stream is an ordinary Python project. You write nodes as Python classes and connect them in a
function decorated @stream:
from tatolab.stream import CameraSource, DisplayWindow, StreamBuilder, stream
from nodes.inverting_effect import InvertingEffect
@stream
def main(stream_builder: StreamBuilder) -> None:
camera = stream_builder.add(CameraSource)
effect = stream_builder.add(InvertingEffect)
window = stream_builder.add(DisplayWindow, config={"title": "Tatolab"})
stream_builder.connect(camera.output("video"), effect.input("video_from_upstream"))
stream_builder.connect(effect.output("video_to_downstream"), window.input("video"))
stream_builder.expose(effect.output("video_to_downstream"))
tatolab dev runs it in the runtime. Each node runs in its own process, so one slow node never
blocks another. An exposed output gets an address other streams, agents and browsers can read.
This package holds the authoring API (@stream, @node, StreamBuilder), typed classes for
every built-in node (camera, display, microphone, speaker, H.264, H.265 and Opus codecs, MP4
recording, and more), and the protocols your nodes are handed at run time. It installs and imports without the runtime,
with complete type hints, so your editor, type checker and unit tests work on any machine.
Add it to an existing project
uv add tatolab-stream
The runtime runs your nodes with the project's .venv/bin/python, so anything you install there
your nodes can import. See Python SDK for details.
Supports CPython 3.10 to 3.13 (not the free-threaded builds).
Other packages
tatolab-webrtc: WHIP publish and WHEP play nodes.tatolabon PyPI is a placeholder that installs nothing. Tatolab itself installs as an app, as above.
Links
Licensed under the Business Source License 1.1.
1 maintainer
Metadata
1 maintainer
Release files for tatolab-stream 0.47.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 | |
|---|---|---|---|
| tatolab_stream-0.47.0.tar.gz | 96.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| tatolab_stream-0.47.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 210.5 kB
Release files / tatolab_stream-0.47.0.tar.gz
| Download URL | tatolab_stream-0.47.0.tar.gz |
|---|---|
| Size | 96.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
513bc006baae2f141511e627aab1bf77cffa100d10b260337d6904fbd53b43eb
|
|
BLAKE2b-256 checksum How to use checksums |
048cdd3bbe3414f6d64703a0822ad0da84042f22ad5f45dcb6e84c905a0e5433
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / tatolab_stream-0.47.0-py3-none-any.whl
| Download URL | tatolab_stream-0.47.0-py3-none-any.whl |
|---|---|
| Size | 113.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
abf65d48fbed188b5a0f1752d6d12ceb2f37dcb060751623ceb622c495f519b2
|
|
BLAKE2b-256 checksum How to use checksums |
fde4923f73f0667ed97e30318722885d8b30bba8132f6aef86bf10b9ff520b8f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
