> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markpdf.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install and configure the official Python SDK for Markpdf.

# Installation

Use `markpdf-py` when you want the Python client for scripts, services, notebooks, FastAPI/Django apps, workers, or automation.

## Install

<CodeGroup>
  ```bash pip theme={null}
  pip install markpdf-py
  ```

  ```bash uv theme={null}
  uv add markpdf-py
  ```

  ```bash poetry theme={null}
  poetry add markpdf-py
  ```
</CodeGroup>

The package installed from PyPI is `markpdf-py`; the Python import remains `markpdf`:

```python theme={null}
from markpdf import MarkpdfClient
```

## Configure the API key

Set the key in your environment:

```bash theme={null}
MARKPDF_API_KEY=YOUR_API_KEY
```

Then create the client:

```python theme={null}
from markpdf import MarkpdfClient

client = MarkpdfClient()
markdown = client.convert_file("report.pdf", mode="fast")
```

You can also pass the key explicitly in server-only code:

```python theme={null}
client = MarkpdfClient(api_key="YOUR_API_KEY")
```

## API endpoint

The production API endpoint is:

```text theme={null}
https://api.markpdf.tech
```

## Next step

Continue with [Quickstart](/docs/sdks/python/quickstart).