---
id: exteragram-alib
version: "1.0.6"
license: MIT
license_treatment: permissive
maintenance: active
---

# exteragram-alib — A reactive declarative UI and threading utility library for exteraGram / Telegram plugins.

License: permissive · Maintenance: active · Downloads: 83.0K/mo

## What it is and what it does

exteragram-alib is a UI and utility library for building plugins for the exteraGram Android Telegram client. It provides reactive state binding (State class), declarative UI widgets (Label, Button, Field, Toggle, Slider, etc.), layout containers (VBox, HBox, Card), and helper utilities for threading, Java reflection, local JSON storage, event dispatching, and network operations like caching and rate-limiting.

The library is designed to integrate directly into exteraGram's plugin system via the `__requirements__` metadata. Developers use it to construct settings screens and interactive interfaces that automatically update when underlying state changes, without manual UI refresh calls. It abstracts Android UI patterns into Python classes and handles the bridge to the host application's rendering layer.

Use it for:

- Build settings screens for exteraGram plugins with toggles, sliders, and text fields that react to state changes.
- Create interactive plugin UIs using declarative widgets and layout containers without direct Android API calls.
- Manage reactive state across plugin UI components so changes propagate automatically to all bound widgets.
- Implement plugin-specific dialogs, bottom sheets, and event-driven interactions within the Telegram client.
- Cache and rate-limit network requests from plugin code using built-in network decorators.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides reactive state management, declarative UI widgets, and threading utilities for building plugins for the exteraGram Android Telegram client.

Yes, if you are developing plugins for the exteraGram Android Telegram client. The library eliminates boilerplate for UI construction and state management specific to that platform. For general-purpose reactive UI or non-exteraGram projects, it is not applicable. No security issues detected and low install friction make it a straightforward add to an exteraGram plugin's dependencies.

## Install

pip install exteragram-alib
uv add exteragram-alib
poetry add exteragram-alib

## Installing exteragram-alib

Before you install: Low install friction with no runtime dependencies. Active maintenance status and recent release history suggest ongoing support.

License in practice: MIT license is permissive, allowing use in commercial and private projects with minimal restrictions.

Quickstart:

pip install exteragram-alib

from alib import State, Label, Button, VBox

my_state = State("Initial text")
label = Label(text=my_state)
button = Button(text="Click", on_click=lambda v: my_state.set("Updated"))
ui = VBox(children=[label, button])

Requires Python 3.8 or later; designed for use within exteraGram plugin environment.

Verify before relying:

- Whether the library functions outside the exteraGram plugin context or requires the host application.
- Performance characteristics with complex UI hierarchies or large state trees.
- Thread-safety guarantees for concurrent state mutations across multiple listeners.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 83.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

exteragram plugin ui library, reactive declarative ui framework, telegram client plugin development, android ui state management, telegram plugin utilities, reactive state binding, declarative widget framework, telegram-plugin, reactive-ui, android-development

[View on SkillFed](https://skillfed.io/packages/exteragram-alib) · [View on PyPI](https://pypi.org/project/exteragram-alib/)