> For the complete documentation index, see [llms.txt](https://bohd4nx.gitbook.io/pyfragment/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bohd4nx.gitbook.io/pyfragment/overview.md).

# Overview

`pyfragment` is an async Python client for [Fragment](https://fragment.com).

If you are integrating Fragment into a bot or backend, this docs set is meant to be practical, not theoretical.

**Recommended reading order:**

1. Install the package
2. Configure `FragmentClient`
3. Set up credentials and cookies
4. Run the quick start
5. Move to feature-specific flows

## Who this is for

* Python developers integrating Fragment into bots, services, and automation.
* Teams that need predictable typed results and explicit error behavior.

**Important:** this library is not affiliated with Fragment or Telegram.

## Where to begin

1. [Installation](/pyfragment/setup-guide/installation.md)
2. [Library and Configuration](/pyfragment/setup-guide/configuration.md)
3. [Credentials and Cookies](/pyfragment/setup-guide/credentials-and-cookies.md)
4. [Quick Start](/pyfragment/setup-guide/quickstart.md)

## Feature entry points

* Stars: [Purchase](/pyfragment/api-guides/stars/purchase.md), [Giveaway](/pyfragment/api-guides/stars/giveaway.md)
* Premium: [Purchase](/pyfragment/api-guides/premium/purchase.md), [Giveaway](/pyfragment/api-guides/premium/giveaway.md)
* Marketplace: [Overview](/pyfragment/api-guides/marketplace/overview.md), Ads: [Overview](/pyfragment/api-guides/ads/overview.md)
* Numbers: [Anonymous Numbers](/pyfragment/api-guides/anonymous-numbers/overview.md)
* Utility operations: [Raw API Calls](/pyfragment/api-guides/raw-call.md)

## Additional references

* [Error Handling](/pyfragment/errors.md)
* [Result Models](/pyfragment/reference/models.md)
* [Literal Types](/pyfragment/reference/literals.md)
* [Troubleshooting](/pyfragment/advanced/troubleshooting.md)

## Live examples

**Up-to-date runnable examples live in the main repository:**

* <https://github.com/bohd4nx/pyfragment/tree/master/examples>