@jennifer/telegram

A Telegram Bot API client for Jennifer programs: send messages, photos and files, attach inline keyboards, and poll for updates. Replaces the telegram module of Jennifer's standard library (shipped since 0.18.0, deprecated from 0.26.0, removed in 0.28.0); the API is unchanged, only the import differs.

Documentation

Install

jvc add @jennifer/telegram

This vendors the deck to vendor/jennifer/telegram/. Without jvc, unpack the src/ subtree of a release archive (jennifer-telegram-<version>.tar.gz) there.

Usage

import "@jennifer/telegram/" as telegram;

def bot as telegram.Bot init telegram.bot(os.getEnv("TELEGRAM_BOT_TOKEN"));
telegram.sendMessage($bot, 12345678, "deploy finished");

examples/send.j sends a plain message and one with a URL button.

Requirements

Jennifer 0.26.0 or newer and network access to the Telegram Bot API. Calls need the default jennifer binary; the stock jennifer-tiny has no network driver.

Development

tools/check-all.sh                   # the full gate, as CI runs it
jennifer test src/telegram_test.j      # the test overlay
tools/check-docs.sh                  # docs against the code
tools/pack.sh dist                   # build the release archive

Licence

LGPL-3.0-only, see LICENSE. Copyright (C) 2026 mplx <[email protected]>.

tools/check-headers.sh checks every source file's SPDX header against deck.toml.