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

# Python SDK

> Install modus-sdk and call Modus, scopes, workflows, and context from Python.

Official Python client for Modus — your organization's context layer for AI.

**Package release:** [`modus-sdk`](https://pypi.org/project/modus-sdk/) on PyPI.

## Installation

```bash theme={null}
pip install modus-sdk
```

Requires Python 3.10+.

## Authentication

Create an API token in the Modus app (**Settings → API Tokens**). Prefer an environment variable:

```bash theme={null}
export MODUS_API_KEY=modus_xxx
```

See [Authentication](/authentication) for token format and best practices.

## Quick start

```python theme={null}
import modus

# Reads MODUS_API_KEY env var, or pass api_key= explicitly
client = modus.Modus()

for scope in client.scopes.list():
    print(scope.name, scope.status)

scope = client.scopes.get("revenue-analysis")
print(scope.name, scope.description)

for item in client.context.items.list():
    print(item.uid, item.context_type, modus.context_item_label(item))
```

## Next steps

* Browse the full [Python SDK reference](/sdk/python) (classes, methods, types)
* [API](/api-reference) — REST playground and schemas
* [TypeScript SDK](/guides/sdk-typescript)
* [All SDKs](/guides/sdk)