tglib 0.1.0

An experimental full MTProto Python client library

TGLib

An experimental, full-featured MTProto Python client library for Telegram.
Built from scratch. Async-first. Lightweight.

---

⚠️ Experimental

TGLib is currently in early development. APIs may change without notice. Use in production at your own risk. Contributions and feedback are welcome!

---

✨ Features

• 🔐 Full MTProto implementation — low-level Telegram protocol support
• ⚡ Async-first — built entirely on asyncio
• 🗄️ Session persistence — via aiosqlite
• 🔒 Encryption — powered by pyaes and pycryptodome
• 🪶 Lightweight — minimal dependencies, maximum control
• 🐍 Python 3.10+ — uses modern Python features

---

📦 Installation

From PyPI:

pip install tglib

From source:

git clone https://github.com/ankit-chaubey/TGLib.git
cd TGLib
pip install -e .

---

🚀 Quick Start

from tglib import Client

client = Client(
    api_id=YOUR_API_ID,
    api_hash="YOUR_API_HASH",
    session="my_session"
)

async def main():
    await client.start()
    me = await client.get_me()
    print(f"Logged in as: {me.first_name}")

client.run(main())

Get your api_id and api_hash from my.telegram.org

---

🔧 Dependencies

Package	Purpose
pyaes	AES encryption for MTProto
pycryptodome	RSA and additional crypto
aiosqlite	Async session storage

---

📁 Project Structure

TGLib/
├── tglib/
│   ├── __init__.py       # Entry point
│   ├── client/           # Client logic
│   ├── crypto/           # Encryption & MTProto
│   ├── network/          # TCP transport
│   └── types/            # Telegram types
├── setup.py
└── README.md

---

🤝 Contributing

Contributions are very welcome! Here's how to get started:

# Fork the repo, then:
git clone https://github.com/YOUR_USERNAME/TGLib.git
cd TGLib
pip install -e .

1. Create a new branch: git checkout -b feature/your-feature
2. Make your changes
3. Push and open a Pull Request

---

🐛 Issues & Feedback

Found a bug or have a suggestion?
👉 Open an issue

---

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

---

👤 Author

Ankit Chaubey
📧 [e-mail]
🐙 github.com/ankit-chaubey

---

Made with ❤️ and Python