Start Here

miniproto is an async-first MTProto protocol SDK. It owns connection, authorization, sessions, raw invocation, update state, and media primitives; it is not the future high-level application framework. Start with a throwaway bot session, then move to a protected durable session before handling a real account.

1. Install from a source checkout.
2. Run the five-minute bot quickstart against an account and chat you control.
3. Choose phone or bot authorization and store durable session material safely.
4. Make a first raw call, then a first high-level operation.
5. Use the small runnable examples as starting points rather than copying credentials into source files.

Every network example in this section requires real Telegram API credentials and, where applicable, a bot token or phone account. It is intentionally not part of the repository’s offline test suite. For the security and portability contract behind durable sessions, see Session Security. For generated Telegram API provenance and raw-surface limits, see Raw API.