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

# Installation

> Install the FlexOrch Python SDK.

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

Requires Python 3.10+.

***

## Setup

Set your API key as an environment variable:

```bash theme={null}
export FLEXORCH_API_KEY=dfx_your_key_here
```

The client picks it up automatically:

```python theme={null}
from flexorch_sdk import FlexOrch

client = FlexOrch()  # reads FLEXORCH_API_KEY from env
```

Or pass it explicitly:

```python theme={null}
client = FlexOrch(api_key="dfx_your_key_here")

# with options
client = FlexOrch(
    api_key="dfx_your_key_here",
    timeout=60,      # seconds — default 30
    max_retries=3,   # default 3
)
```

***

## Verify

```python theme={null}
from flexorch_sdk import FlexOrch

client = FlexOrch()
usage = client.usage.get()
print(usage["plan"])               # "trial"
print(usage["credits_used"])       # 0
print(usage["credits_remaining"])  # 1200
```