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

# Configuration

> Settings, env vars, and precedence.

The SDK reads its config from three places. You rarely need more than the two credentials.

## Settings

| Setting           | Env var              | Constructor kwarg | Default                  |
| ----------------- | -------------------- | ----------------- | ------------------------ |
| Public API key id | `MUDRAID_API_KEY_ID` | `api_key_id=`     | required                 |
| Secret            | `MUDRAID_SECRET`     | `secret=`         | required                 |
| MudraID base URL  | `MUDRAID_BASE_URL`   | `base_url=`       | `https://api.mudraid.ai` |

<Note>
  The v0.1 alpha still ships an older placeholder as its built-in default. Set `MUDRAID_BASE_URL=https://api.mudraid.ai` explicitly until the package default is updated.
</Note>

## Precedence

Kwarg beats OS env. OS env beats `.env` file.

```python theme={null}
# .env sets one value, but an explicit kwarg wins:
agent = Agent(base_url="https://api.mudraid.ai")
```

## The `.env` file

The SDK loads `.env` on its own. Put your credentials there:

```env theme={null}
MUDRAID_API_KEY_ID=muid_kid_...
MUDRAID_SECRET=muid_sk_...
```

Add `.env` to `.gitignore`.

## What's not configurable

Timeouts and cache TTLs are internal. They're stable in v1. You don't tune them.

## Related

* [Overview](/sdks/python-sdk/overview)
* [Quickstart: Agent Developer](/guides/get-started/quickstart-agent)