{"id":15654325,"url":"https://github.com/timoniq/telegrinder","last_synced_at":"2026-04-30T01:09:31.275Z","repository":{"id":52717708,"uuid":"482441164","full_name":"timoniq/telegrinder","owner":"timoniq","description":"Modern visionary telegram bot framework","archived":false,"fork":false,"pushed_at":"2026-04-23T11:39:38.000Z","size":5008,"stargazers_count":64,"open_issues_count":6,"forks_count":8,"subscribers_count":4,"default_branch":"dev","last_synced_at":"2026-04-23T13:29:20.653Z","etag":null,"topics":["async","bot","chatbot","framework","telegram"],"latest_commit_sha":null,"homepage":"https://github.com/timoniq/telegrinder/blob/dev/docs/tutorial/en/0_tutorial.md","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/timoniq.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":"contributing.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-04-17T06:01:40.000Z","updated_at":"2026-04-23T11:39:42.000Z","dependencies_parsed_at":"2026-03-23T19:03:03.396Z","dependency_job_id":null,"html_url":"https://github.com/timoniq/telegrinder","commit_stats":{"total_commits":241,"total_committers":10,"mean_commits":24.1,"dds":0.5352697095435685,"last_synced_commit":"b7c97c8835748a70ba40c57b05c0872577976afc"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/timoniq/telegrinder","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timoniq%2Ftelegrinder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timoniq%2Ftelegrinder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timoniq%2Ftelegrinder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timoniq%2Ftelegrinder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/timoniq","download_url":"https://codeload.github.com/timoniq/telegrinder/tar.gz/refs/heads/dev","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timoniq%2Ftelegrinder/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32450235,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T22:27:22.272Z","status":"ssl_error","status_checked_at":"2026-04-29T22:10:49.234Z","response_time":110,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["async","bot","chatbot","framework","telegram"],"created_at":"2024-10-03T12:50:42.735Z","updated_at":"2026-04-30T01:09:31.270Z","avatar_url":"https://github.com/timoniq.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp\u003e\n  \u003ca href=\"https://github.com/timoniq/telegrinder\"\u003e\n    \u003cpicture\u003e\n      \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://raw.githubusercontent.com/timoniq/telegrinder/dev/docs/assets/logo-white.png\"\u003e\n      \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://raw.githubusercontent.com/timoniq/telegrinder/dev/docs/assets/logo-black.png\"\u003e\n      \u003cimg alt=\"Logo\" src=\"https://raw.githubusercontent.com/timoniq/telegrinder/dev/docs/assets/logo-black.png\" width=\"200\"\u003e\n    \u003c/picture\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003c/p\u003e\n\u003ch1\u003e\n  telegrinder\n\u003c/h1\u003e\n\n\u003cp\u003e\n— effective and reliable telegram bot building.\n\u003c/p\u003e\n\n\u003cp\u003e\n  \u003ca href=\"https://github.com/timoniq/telegrinder\"\u003e\u003cimg src=\"https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.github.com%2Frepos%2Ftimoniq%2Ftelegrinder%2Freleases%2Flatest\u0026query=%24.name\u0026style=flat-square\u0026logo=textpattern\u0026logoColor=fff\u0026label=version\u0026labelColor=black\u0026color=black\"\u003e\u003c/img\u003e\u003c/a\u003e\n  \u003ca href=\"#license\"\u003e\u003cimg alt=\"GitHub License\" src=\"https://img.shields.io/github/license/timoniq/telegrinder.svg?color=lightGreen\u0026labelColor=black\u0026style=flat-square\"\u003e\u003c/img\u003e\u003c/a\u003e\n  \u003ca href=\"https://docs.astral.sh/ruff/\"\u003e\u003cimg alt=\"Code Style\" src=\"https://img.shields.io/badge/code_style-Ruff-D7FF64?logo=ruff\u0026logoColor=fff\u0026style=flat-square\u0026labelColor=black\"\u003e\u003c/img\u003e\u003c/a\u003e\n  \u003ca href=\"https://docs.basedpyright.com/latest/\"\u003e\u003cimg alt=\"Type Checker\" src=\"https://img.shields.io/badge/types-basedpyright-black?logo=python\u0026color=%23FBCA04\u0026logoColor=edb641\u0026labelColor=black\u0026style=flat-square\"\u003e\u003c/img\u003e\u003c/a\u003e\n  \u003ca href=\"https://pypi.org/project/telegrinder/\"\u003e\u003cimg alt=\"Python versions\" src=\"https://img.shields.io/python/required-version-toml?tomlFilePath=https%3A%2F%2Fraw.githubusercontent.com%2Ftimoniq%2Ftelegrinder%2Frefs%2Fheads%2Fmain%2Fpyproject.toml\u0026style=flat-square\u0026logo=python\u0026logoColor=fff\u0026labelColor=black\"\u003e\u003c/img\u003e\u003c/a\u003e\n  \u003ca href=\"https://core.telegram.org/bots/api\"\u003e\u003cimg alt=\"Telegram Bot API Version\" src=\"https://img.shields.io/badge/dynamic/toml?url=https%3A%2F%2Fraw.githubusercontent.com%2Ftimoniq%2Ftelegrinder%2Frefs%2Fheads%2Fmain%2Ftypegen%2Fconfig.toml\u0026query=%24.telegram-bot-api.version\u0026style=flat-square\u0026logo=telegram\u0026label=Telegram%20API\u0026labelColor=black\u0026color=%23FBCA04\"\u003e\u003c/img\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\n* Type hinted \u0026 [type functional](https://github.com/timoniq/telegrinder/blob/dev/docs/tutorial/en/3_functional_bits.md)\n* Customizable and extensible\n* Fast models built on [msgspec](https://github.com/jcrist/msgspec)\n* API client powered by fast [wreq](https://github.com/0x676e67/wreq-python) library\n* Both low-level and high-level API\n* Convenient [dependency injection](https://github.com/timoniq/telegrinder/blob/dev/docs/tutorial/en/5_nodes.md) via nodes\n* \u003cdetails\u003e \u003csummary\u003eA variety of state management tools\u003c/summary\u003e\u003cp\u003e○ \u003ca href=\"https://github.com/timoniq/telegrinder/blob/dev/examples/blueprint_bot/handlers/with_enum.py#L18\"\u003ewaiter machine\u003c/a\u003e for runtime inline short state funneling\u003cbr\u003e○  \u003ca href=\"https://github.com/timoniq/telegrinder/blob/dev/examples/state_mutator_player.py\"\u003estate mutator\u003c/a\u003e to declare complex state sets\u003c/p\u003e\u003c/details\u003e\n\nBasic example:\n\n```python\nfrom telegrinder import API, Message, Telegrinder, Token\nfrom telegrinder.modules import setup_logger\nfrom telegrinder.rules import Text\n\nsetup_logger(level=\"INFO\")\napi = API(token=Token(\"123:token\"))\nbot = Telegrinder(api)\n\n\n@bot.on.message(Text(\"/start\"))\nasync def start(message: Message) -\u003e None:\n    me = (await api.get_me()).unwrap()\n    await message.answer(f\"Hello, {message.from_user.full_name}! I'm {me.full_name}.\")\n\n\nbot.run_forever()\n```\n\n# Getting started\n\nInstall using pip, uv or poetry:\n\n  \u003ca href=\"https://pypi.org/project/telegrinder/\"\u003e\u003cimg alt=\"PyPI Version\" src=\"https://img.shields.io/pypi/v/telegrinder.svg?labelColor=black\u0026style=flat-square\u0026logo=pypi\"\u003e\u003c/img\u003e\u003c/a\u003e\n\n```console\nuv add telegrinder\npoetry add telegrinder\npip install telegrinder\n```\n\nOr install from source (unstable):\n\n  \u003ca href=\"https://github.com/timoniq/telegrinder/actions/workflows/push.yml\"\u003e\u003cimg alt=\"GitHub CI\" src=\"https://img.shields.io/github/actions/workflow/status/timoniq/telegrinder/push.yml?branch=main\u0026style=flat-square\u0026labelColor=black\u0026label=CI\u0026logo=github\"\u003e\u003c/img\u003e\u003c/a\u003e\n\n```console\nuv add \"telegrinder @ git+https://github.com/timoniq/telegrinder@dev\"\npoetry add git+https://github.com/timoniq/telegrinder@dev\npip install git+https://github.com/timoniq/telegrinder@dev\n```\n\n# Documentation\n\n[**Tutorial 📖**](/docs/tutorial/en/0_tutorial.md)\n\n# Community\n\nJoin one of our [forums](https://github.com/timoniq/telegrinder/blob/dev/docs/community_links.md).\n\n# License\n\nTelegrinder is [MIT licensed](./LICENSE)\\\nCopyright © 2022 [timoniq](https://github.com/timoniq)\\\nCopyright © 2024 [luwqz1](https://github.com/luwqz1)\n\n# Contributors\n\n\u003cp\u003e\n    \u003cimg src=\"https://arseny.neocities.org/assets/te_agradezco.png\" height=\"50px\" style=\"vertical-align: middle;\"\u003e\n\u003c/p\u003e\n\n\\\n\u003ca href=\"https://github.com/timoniq/telegrinder/graphs/contributors\"\u003e\n \u003cimg src=\"https://contributors-img.web.app/image?repo=timoniq/telegrinder\"/\u003e\n\u003c/a\u003e\n\nWe welcome your pull requests ([contrubution notes](https://github.com/timoniq/telegrinder/blob/main/contributing.md)). Telegrinder is built by the community\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimoniq%2Ftelegrinder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftimoniq%2Ftelegrinder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimoniq%2Ftelegrinder/lists"}