telegram-tools 3.0.0__tar.gz

telegram_tools-3.0.0/.env.example

@@ -0,0 +1,6 @@
+TELEGRAM_API_ID=123456
+TELEGRAM_API_HASH=replace-with-your-api-hash
+
+# Optional: override where the Telethon session file is stored.
+# Default: ~/.telegram-tools/telegram-tools.session
+#TELEGRAM_TOOLS_SESSION=/path/to/session

telegram_tools-3.0.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,47 @@
+name: Bug report
+description: Report a reproducible problem.
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Do not include Telegram API hashes, bot tokens, phone numbers, session files, `.env`, private exports, or screenshots with private chat data.
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: What went wrong?
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Reproduction
+      description: Commands and sanitized inputs that reproduce the issue.
+      placeholder: |
+        telegram-tools search --chat @example_group --contains deploy
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behavior
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: Version or commit
+      placeholder: "2.0.1 or commit SHA"
+  - type: textarea
+    id: validation
+    attributes:
+      label: Validation output
+      description: Paste sanitized `python -m pytest` or `telegram-tools doctor` output if relevant.

telegram_tools-3.0.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

telegram_tools-3.0.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,30 @@
+name: Feature request
+description: Suggest a focused improvement.
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Keep requests focused. Do not include credentials, private chat data, phone numbers, `.env`, or session files.
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What workflow is hard or missing?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: What should change?
+    validations:
+      required: true
+  - type: textarea
+    id: safety
+    attributes:
+      label: Safety impact
+      description: Does this touch message deletion, credentials, sessions, or exports?
+    validations:
+      required: true

telegram_tools-3.0.0/.github/pull_request_template.md

@@ -0,0 +1,16 @@
+## Summary
+
+- Summary of changes.
+
+## Safety
+
+- [ ] I did not include Telegram API hashes, bot tokens, phone numbers, `.env`, session files, or private exports.
+- [ ] I did not make destructive Telegram operations easier to run accidentally.
+- [ ] If I touched `clear-messages`, dry-run, `--execute`, typed `DELETE`, topic preservation, and topic ID preservation are covered by tests.
+
+## Validation
+
+- [ ] `python -m pytest`
+- [ ] `python -m compileall -q src`
+- [ ] `telegram-tools --help`
+- [ ] `telegram-tools doctor` if local Telegram config is available

telegram_tools-3.0.0/.github/workflows/tests.yml

@@ -0,0 +1,49 @@
+name: Tests
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  test:
+    name: Python ${{ matrix.python-version }}
+    runs-on: macos-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version:
+          - "3.11"
+          - "3.12"
+          - "3.13"
+          - "3.14"
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install package
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+
+      - name: Run tests
+        run: python -m pytest
+
+      - name: Compile sources
+        run: python -m compileall -q src
+
+      - name: Check CLI help
+        run: |
+          telegram-tools --help
+          telegram-tools discover --help
+          telegram-tools clear-messages --help
+          telegram-tools search --help
+          telegram-tools doctor --help

telegram_tools-3.0.0/.gitignore

@@ -0,0 +1,22 @@
+.DS_Store
+.venv/
+__pycache__/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+*.egg-info/
+dist/
+build/
+
+.env
+.env.*
+!.env.example
+
+.telegram-tools/
+*.session
+*.session-journal
+*.session-shm
+*.session-wal
+
+exports/
+*.log

telegram_tools-3.0.0/CHANGELOG.md

@@ -0,0 +1,32 @@
+# Changelog
+
+All notable changes to this project will be documented here.
+
+This project follows a practical changelog style: user-visible changes, safety changes, and release notes belong here; active task tracking belongs outside the repo.
+
+## 3.0.0 - 2026-08-12
+
+First PyPI release. Curated to three tools: discovery, search/export, and clear-messages.
+
+- **Breaking:** remove `bot-inventory` and `bot-add` (and `bots.json` support).
+- **Breaking:** remove the macOS `.command` launchers — install with `pipx install telegram-tools` instead.
+- **Breaking:** session files and config now default to `~/.telegram-tools/` instead of the current directory. Migrate an existing login with `mv .telegram-tools ~/.telegram-tools` (and move your `.env` values into `~/.telegram-tools/.env` if you want them global). `TELEGRAM_TOOLS_SESSION` still overrides.
+- `.env` is now also read from `~/.telegram-tools/.env` (current directory still wins).
+- Rewrite README for the PyPI audience, including an api_id/api_hash setup walkthrough.
+
+## 2.0.1 - 2026-07-06
+
+- Add public-readiness documentation: license, contributing guide, security policy, code of conduct, issue templates, and pull request template.
+- Add GitHub Actions test workflow.
+- Add `telegram-tools doctor` for local setup checks that do not print secrets, token values, or session paths.
+- Replace machine-specific launcher paths with repository-relative path resolution.
+- Expand package metadata for public packaging.
+
+## 0.1.0 - 2026-07-06
+
+- Add interactive menu.
+- Add chat/topic discovery.
+- Add message search and JSON/CSV export.
+- Add dry-run-first clear-message workflow that preserves forum topics and topic IDs.
+- Add bot inventory and bot-add commands with masked token output.
+- Add clickable macOS `.command` launchers.

telegram_tools-3.0.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,21 @@
+# Code of Conduct
+
+## Expected Behavior
+
+- Be direct, respectful, and specific.
+- Assume good intent, but accept correction when impact says otherwise.
+- Keep discussion focused on the code, docs, safety, and user outcomes.
+- Do not post private data, credentials, or screenshots that expose other people.
+
+## Unacceptable Behavior
+
+- Harassment, threats, or personal attacks.
+- Discriminatory language or conduct.
+- Publishing private information without consent.
+- Repeated bad-faith arguments that block maintainers from doing the work.
+
+## Enforcement
+
+Maintainers may edit, hide, or remove comments and may block participants who violate this code of conduct.
+
+Report problems privately through the repository owner's GitHub profile or security advisory channel.

telegram_tools-3.0.0/CONTRIBUTING.md

@@ -0,0 +1,60 @@
+# Contributing
+
+Thanks for helping improve `telegram-tools`.
+
+## Safety First
+
+Do not include any real Telegram credentials or private chat data in issues, pull requests, commits, tests, screenshots, fixtures, or logs.
+
+Never commit:
+
+- `.env`
+- `.telegram-tools/`
+- `*.session*`
+- phone numbers
+- Telegram API hashes
+- bot tokens
+- exported private chat data
+
+## Development Setup
+
+```bash
+python3.11 -m venv .venv
+source .venv/bin/activate
+python -m pip install -e ".[dev]"
+```
+
+## Validation
+
+Run the full local check before opening a pull request:
+
+```bash
+python -m pytest
+python -m compileall -q src
+telegram-tools --help
+telegram-tools discover --help
+telegram-tools clear-messages --help
+telegram-tools search --help
+telegram-tools doctor --help
+```
+
+If you have local Telegram config and session storage, also run:
+
+```bash
+telegram-tools doctor
+```
+
+## Clear-Message Changes
+
+Be especially conservative around `clear-messages`.
+
+The required behavior is:
+
+- dry-run by default.
+- `--execute` is required before Telegram deletion APIs are called.
+- a typed `DELETE` prompt is required during execution.
+- forum topics are not deleted.
+- topic IDs do not change.
+- only messages collected from the selected chat/topic are deleted.
+
+Add or update tests for any change touching that flow.

telegram_tools-3.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 telegram-tools contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

telegram_tools-3.0.0/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.5
+Name: telegram-tools
+Version: 3.0.0
+Summary: Local Telethon CLI for Telegram chat/topic ID discovery, message search/export, and topic message clearing.
+Project-URL: Homepage, https://github.com/banozz0/telegram-tools
+Project-URL: Repository, https://github.com/banozz0/telegram-tools
+Project-URL: Issues, https://github.com/banozz0/telegram-tools/issues
+Project-URL: Changelog, https://github.com/banozz0/telegram-tools/blob/main/CHANGELOG.md
+License: MIT License
+        
+        Copyright (c) 2026 telegram-tools contributors
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: cli,export,forum-topics,telegram,telethon
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Requires-Dist: python-dotenv<2,>=1.0
+Requires-Dist: telethon<2,>=1.44
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# telegram-tools
+
+A local CLI for operating your own Telegram chats: find the real IDs of your groups, channels, and forum topics, search and export messages, and clear all messages out of forum topics without destroying the topics themselves.
+
+Built on [Telethon](https://github.com/LonamiWebs/Telethon). Everything runs on your machine with your own Telegram API credentials — no server, no third party, nothing leaves your computer except the Telegram API calls you asked for.
+
+## What it does
+
+- **`discover`** — lists your chats, channels, and forum groups with their exact numeric IDs and every forum topic ID. The fastest way to answer "what is this chat's `-100…` ID and what are its topic IDs?"
+- **`search`** — searches messages by text, sender, date range, or topic, and prints a table or exports JSON/CSV.
+- **`clear-messages`** — deletes all messages inside selected forum topic(s) while preserving the topics and their IDs. Dry-run by default; deleting requires both `--execute` *and* typing `DELETE` at a prompt.
+- **`doctor`** — checks your local setup without printing any secrets.
+
+## What it doesn't do (on purpose)
+
+- No deleting or creating forum topics — topic IDs never change.
+- No media downloads.
+- No sending messages, no bots, no automation loops.
+- No cloud anything — credentials and session files stay in `~/.telegram-tools/`.
+
+## Install
+
+```bash
+pipx install telegram-tools
+# or
+uv tool install telegram-tools
+```
+
+Or from source: `pipx install git+https://github.com/banozz0/telegram-tools.git`
+
+Requires Python 3.11+.
+
+## Setup: your Telegram API credentials
+
+The tool logs in as *you* (a user account, not a bot), so it needs a Telegram API key. One-time, about two minutes:
+
+1. Open <https://my.telegram.org/apps> and log in with your Telegram phone number.
+2. Fill in the short "Create new application" form (any name/short name works; platform "Desktop").
+3. Copy the **App api_id** (a number) and **App api_hash** (a hex string).
+4. Store them where the tool can find them:
+
+```bash
+mkdir -p ~/.telegram-tools
+cat > ~/.telegram-tools/.env <<'EOF'
+TELEGRAM_API_ID=123456
+TELEGRAM_API_HASH=your-api-hash-here
+EOF
+```
+
+Shell environment variables and a `.env` in the current directory also work, and win over `~/.telegram-tools/.env`.
+
+Treat the api_hash like a password. The first command you run starts Telethon's interactive login (phone number + code from Telegram); the resulting session file is stored in `~/.telegram-tools/` and reused afterwards. Log out anytime by deleting the session file in that directory (your `.env` can stay) — the session also shows under Telegram's *Settings → Devices*.
+
+## 30 seconds of usage
+
+```bash
+# What are my chats and their IDs?
+telegram-tools discover            # admin/managed chats only
+telegram-tools discover --all      # everything
+
+# Search a group
+telegram-tools search --chat @mygroup --contains deploy
+
+# Export a topic to JSON
+telegram-tools search --chat @mygroup --topic 141 --output topic-141.json
+
+# Clear a topic (dry-run first — this is the default)
+telegram-tools clear-messages --chat @mygroup --topic 141
+# Actually delete: needs --execute AND typing DELETE at the prompt
+telegram-tools clear-messages --chat @mygroup --topic 141 --execute
+```
+
+Running `telegram-tools` with no arguments opens an interactive menu with the same operations.
+
+`discover` output looks like:
+
+```text
+Forum Groups
+============
+Example Forum
+Chat ID: -1001234567890
+Type: Forum Group
+Admin: yes
+
+Topics
+--------------------------------------------
+141   Deploys
+217   Support
+16    General
+```
+
+## Safety model
+
+| Command | Destructive? |
+| --- | --- |
+| `discover`, `search`, `doctor` | No — read-only |
+| `clear-messages` | Yes — but only with `--execute` **and** a typed `DELETE`, only messages, never topics |
+
+`clear-messages` also verifies you actually hold the delete-messages permission in the chat before doing anything, skips topic starter messages, and handles Telegram flood-wait limits automatically.
+
+## Status
+
+Stable for its three jobs; used regularly by its author. This is a solo project whose code was written by AI agents under review — issues are welcome, fixes are best-effort, and there is no support promise.
+
+## License
+
+MIT. See [LICENSE](LICENSE).

telegram_tools-3.0.0/README.md

@@ -0,0 +1,107 @@
+# telegram-tools
+
+A local CLI for operating your own Telegram chats: find the real IDs of your groups, channels, and forum topics, search and export messages, and clear all messages out of forum topics without destroying the topics themselves.
+
+Built on [Telethon](https://github.com/LonamiWebs/Telethon). Everything runs on your machine with your own Telegram API credentials — no server, no third party, nothing leaves your computer except the Telegram API calls you asked for.
+
+## What it does
+
+- **`discover`** — lists your chats, channels, and forum groups with their exact numeric IDs and every forum topic ID. The fastest way to answer "what is this chat's `-100…` ID and what are its topic IDs?"
+- **`search`** — searches messages by text, sender, date range, or topic, and prints a table or exports JSON/CSV.
+- **`clear-messages`** — deletes all messages inside selected forum topic(s) while preserving the topics and their IDs. Dry-run by default; deleting requires both `--execute` *and* typing `DELETE` at a prompt.
+- **`doctor`** — checks your local setup without printing any secrets.
+
+## What it doesn't do (on purpose)
+
+- No deleting or creating forum topics — topic IDs never change.
+- No media downloads.
+- No sending messages, no bots, no automation loops.
+- No cloud anything — credentials and session files stay in `~/.telegram-tools/`.
+
+## Install
+
+```bash
+pipx install telegram-tools
+# or
+uv tool install telegram-tools
+```
+
+Or from source: `pipx install git+https://github.com/banozz0/telegram-tools.git`
+
+Requires Python 3.11+.
+
+## Setup: your Telegram API credentials
+
+The tool logs in as *you* (a user account, not a bot), so it needs a Telegram API key. One-time, about two minutes:
+
+1. Open <https://my.telegram.org/apps> and log in with your Telegram phone number.
+2. Fill in the short "Create new application" form (any name/short name works; platform "Desktop").
+3. Copy the **App api_id** (a number) and **App api_hash** (a hex string).
+4. Store them where the tool can find them:
+
+```bash
+mkdir -p ~/.telegram-tools
+cat > ~/.telegram-tools/.env <<'EOF'
+TELEGRAM_API_ID=123456
+TELEGRAM_API_HASH=your-api-hash-here
+EOF
+```
+
+Shell environment variables and a `.env` in the current directory also work, and win over `~/.telegram-tools/.env`.
+
+Treat the api_hash like a password. The first command you run starts Telethon's interactive login (phone number + code from Telegram); the resulting session file is stored in `~/.telegram-tools/` and reused afterwards. Log out anytime by deleting the session file in that directory (your `.env` can stay) — the session also shows under Telegram's *Settings → Devices*.
+
+## 30 seconds of usage
+
+```bash
+# What are my chats and their IDs?
+telegram-tools discover            # admin/managed chats only
+telegram-tools discover --all      # everything
+
+# Search a group
+telegram-tools search --chat @mygroup --contains deploy
+
+# Export a topic to JSON
+telegram-tools search --chat @mygroup --topic 141 --output topic-141.json
+
+# Clear a topic (dry-run first — this is the default)
+telegram-tools clear-messages --chat @mygroup --topic 141
+# Actually delete: needs --execute AND typing DELETE at the prompt
+telegram-tools clear-messages --chat @mygroup --topic 141 --execute
+```
+
+Running `telegram-tools` with no arguments opens an interactive menu with the same operations.
+
+`discover` output looks like:
+
+```text
+Forum Groups
+============
+Example Forum
+Chat ID: -1001234567890
+Type: Forum Group
+Admin: yes
+
+Topics
+--------------------------------------------
+141   Deploys
+217   Support
+16    General
+```
+
+## Safety model
+
+| Command | Destructive? |
+| --- | --- |
+| `discover`, `search`, `doctor` | No — read-only |
+| `clear-messages` | Yes — but only with `--execute` **and** a typed `DELETE`, only messages, never topics |
+
+`clear-messages` also verifies you actually hold the delete-messages permission in the chat before doing anything, skips topic starter messages, and handles Telegram flood-wait limits automatically.
+
+## Status
+
+Stable for its three jobs; used regularly by its author. This is a solo project whose code was written by AI agents under review — issues are welcome, fixes are best-effort, and there is no support promise.
+
+## License
+
+MIT. See [LICENSE](LICENSE).

telegram_tools-3.0.0/SECURITY.md

@@ -0,0 +1,31 @@
+# Security Policy
+
+## Reporting Security Issues
+
+Please do not open public issues for vulnerabilities or accidental secret exposure.
+
+Report privately through GitHub security advisories for this repository, or contact the maintainer through a private channel listed on the repository owner profile.
+
+## Sensitive Data
+
+Do not include:
+
+- Telegram API hashes
+- bot tokens
+- phone numbers
+- `.env`
+- `.telegram-tools/`
+- `*.session*`
+- exported private chat data
+- screenshots that expose private chat names, members, phone numbers, or tokens
+
+If you accidentally expose a secret, revoke or rotate it before reporting.
+
+## Supported Versions
+
+Security fixes target the latest public release line.
+
+| Version | Supported |
+| --- | --- |
+| 3.x | Yes |
+| Earlier private/pre-public snapshots | No |

telegram_tools-3.0.0/docs/telethon-api-notes.md

@@ -0,0 +1,12 @@
+# Telethon API Notes
+
+Checked on 2026-07-06 before implementation.
+
+- Current stable release checked from PyPI: Telethon 1.44.0, released 2026-06-15.
+- Telethon sessions are local SQLite files by default and contain enough authorization data to reuse the login. This project stores them under `~/.telegram-tools/`, outside any repository.
+- `TelegramClient.iter_dialogs()` is the high-level API for listing open dialogs.
+- `TelegramClient.get_permissions(entity, user)` returns `ParticipantPermissions`; `is_admin` indicates admin/creator status.
+- `TelegramClient.iter_messages()` supports chat search through `search`, sender filtering through `from_user`, and thread/topic traversal through `reply_to`.
+- Telethon documents that `search` and `filter` have no effect with `reply_to`, so topic-scoped keyword search is implemented by iterating the topic and filtering locally.
+- `TelegramClient.delete_messages(entity, message_ids)` chunks IDs internally, but it does not validate that message IDs belong to the passed chat. This project only deletes IDs collected from the selected chat/topic in the same process.
+- Forum topic listing requires raw API support. In the Telethon 1.44.0 wheel, the relevant request class is `telethon.tl.functions.messages.GetForumTopicsRequest`.

telegram_tools-3.0.0/pyproject.toml

@@ -0,0 +1,50 @@
+[build-system]
+requires = ["hatchling>=1.25"]
+build-backend = "hatchling.build"
+
+[project]
+name = "telegram-tools"
+version = "3.0.0"
+description = "Local Telethon CLI for Telegram chat/topic ID discovery, message search/export, and topic message clearing."
+readme = "README.md"
+requires-python = ">=3.11"
+license = { file = "LICENSE" }
+keywords = ["telegram", "telethon", "cli", "forum-topics", "export"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Intended Audience :: End Users/Desktop",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Topic :: Communications :: Chat",
+  "Topic :: Utilities",
+]
+dependencies = [
+  "Telethon>=1.44,<2",
+  "python-dotenv>=1.0,<2",
+]
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=8.0",
+]
+
+[project.scripts]
+telegram-tools = "telegram_tools.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/banozz0/telegram-tools"
+Repository = "https://github.com/banozz0/telegram-tools"
+Issues = "https://github.com/banozz0/telegram-tools/issues"
+Changelog = "https://github.com/banozz0/telegram-tools/blob/main/CHANGELOG.md"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/telegram_tools"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]