Skip to main content

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-stream is 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, then open -a Tatolab
  • Linux (x86_64 with a Vulkan GPU): curl -fsSL https://get.tatolab.com/install.sh | sh

Then follow the Quickstart. tatolab new creates a project that already depends on this package, so you rarely pip install it 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.
  • tatolab on PyPI is a placeholder that installs nothing. Tatolab itself installs as an app, as above.

Licensed under the Business Source License 1.1.

Metadata

Release files for tatolab-stream 0.46.11

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tatolab-stream 0.46.11
File Size Uploaded
tatolab_stream-0.46.11.tar.gz 99.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for tatolab-stream 0.46.11
File Interpreter ABI Platform
tatolab_stream-0.46.11-py3-none-any.whl Python 3 none any Details

Total release size: 215.9 kB

Release files / tatolab_stream-0.46.11.tar.gz

Download URL tatolab_stream-0.46.11.tar.gz
Size 99.2 kB
Tags Source
SHA-256 checksum
How to use checksums
4b06eb6386b2a1fd13c150d481ee02d84b1074463ddd7819bf4e0b83e8f23d12
BLAKE2b-256 checksum
How to use checksums
b63a82632570b7c73f2c02c859049ce177e6135a15f7c01f23bc9bf936a7bc59
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.46.11-py3-none-any.whl

Download URL tatolab_stream-0.46.11-py3-none-any.whl
Size 116.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7f1f3f71e8aa996d228012fe3e72d8306463738f7adef93e4b51cdbaee5f3a85
BLAKE2b-256 checksum
How to use checksums
944ca5823726668bd48a164e4256af4e5000d9de20e6c532980fe4da445851d1
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 history Release notifications | RSS feed

This release

0.46.11 This release

2 release files

0.46.9

2 release files

0.46.8

2 release files

0.46.7

2 release files

0.46.6

2 release files

0.46.5

2 release files

0.46.4

2 release files

0.46.2

2 release files

0.46.1

2 release files

0.46.0

2 release files

0.45.6

2 release files

0.45.5

2 release files

0.45.4

2 release files

0.45.3

2 release files

0.45.2

2 release files

0.45.1

2 release files

0.45.0

2 release files

0.44.1

2 release files

0.44.0

2 release files

0.0.0

1 release file

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