Skip to main content

televibe

Run headless coding agents (Claude Code, Codex) one turn at a time, as resumable sessions with a typed event stream.

televibe starts the agent, turns its output into common events (Started, Message, ToolUse, Warning, then exactly one Done or Failed), and kills what it started on timeout, cancel, or when the caller walks away. What to do with the output is the caller's business: televibe never sends a message anywhere.

The optional Telegram layer does: pip install 'televibe[telegram]' adds televibe.telegram, which shows a turn in a chat (reactions, typing or a live draft, the answer) and keeps one session per reply chain. It is a set of parts for an aiogram bot, not a framework. Every reaction can be replaced, and Reactions(done=None) leaves no reaction once the answer is sent. See SPEC.md section 12.

Install: pip install televibe, or pip install 'televibe[telegram]' with the Telegram layer. Python 3.12+, Linux and macOS.

Status: 0.1, alpha. Tests: uv run pytest; live tests against real agents: see tests/test_live.py. MIT licensed.

  • SPEC.md is the specification. It is the law: numbered requirements, each claimed by a test.

Metadata

Release files for televibe 0.1.1

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

Source distribution (sdist)

Source distribution for televibe 0.1.1
File Size Uploaded
televibe-0.1.1.tar.gz 65.8 kB Details

Built distribution (wheel)

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

Total release size: 96.7 kB

Release files / televibe-0.1.1.tar.gz

Download URL televibe-0.1.1.tar.gz
Size 65.8 kB
Tags Source
SHA-256 checksum
How to use checksums
21bbe32a1e2b4f37abd6afd1f39d600e37ac466d9e857731f54a05a4091fd1b8
BLAKE2b-256 checksum
How to use checksums
d0ba9f5a61cd82ee0ae94bb3c290fc684660613edc2b3285bf90d7264d1d9450
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 9, 2026.

Transparency log

Release files / televibe-0.1.1-py3-none-any.whl

Download URL televibe-0.1.1-py3-none-any.whl
Size 30.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ce032610de46d58b6416cea2081d243b9d34e05679065fd4dfedb5ff1d8e3471
BLAKE2b-256 checksum
How to use checksums
5476351cae8046e4b6f08db9454f48433004917b23f60a0ee5edd7de16779909
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 9, 2026.

Transparency log

Release history Release notifications | RSS feed

0.6.0

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.0

2 release files

0.2.1

2 release files

0.2.0

2 release files

This release

0.1.1 This release

2 release files

0.1.0

2 release files

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