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. Claude Code also reports the account's subscription usage as
Limits (five-hour and seven-day windows), and a call refused at the limit
fails with FailReason.USAGE_LIMIT. 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, failed_when_sent=False) leaves a reaction only when
nothing could be sent at all. A live
draft shows the usage ("5h 35% · 7d 13%"); Texts relabels it and words the
limit message, and Presenter(tz=...) sets the zone of its reset time. 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.
1 maintainer
Metadata
1 maintainer
Release files for televibe 0.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| televibe-0.2.1.tar.gz | 70.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| televibe-0.2.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 103.1 kB
Release files / televibe-0.2.1.tar.gz
| Download URL | televibe-0.2.1.tar.gz |
|---|---|
| Size | 70.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3b3a2cc58214aa5f594128adeae4cd36ff163f8a07aab8a8bce5b3226a54b058
|
|
BLAKE2b-256 checksum How to use checksums |
9b38ac8c76cddb7a1d3577d35ac973d37dd5d0c351ae027e4b59b8ffce5fa81d
|
| 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 logRelease files / televibe-0.2.1-py3-none-any.whl
| Download URL | televibe-0.2.1-py3-none-any.whl |
|---|---|
| Size | 32.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5821db5dc9d1d1cab937fd5363c635cefbd1e91ae018025fedd74b515ebd00e7
|
|
BLAKE2b-256 checksum How to use checksums |
481f1fc5f0ccfec0b2ed6116a8380f099e04d30f36fe69c03846984c6756478c
|
| 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
