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

# Box SDKs

> Use Box from Python and TypeScript/JavaScript services.

Use a Box SDK when you want typed calls for creating Boxes, prompting them, reading events, listing API key metadata, managing secrets, and opening desktop or SSH access.

<CardGroup cols={2}>
  <Card title="Python" href="/box/sdks/python">
    Install `ascii-box-sdk` from PyPI and use snake\_case methods.
  </Card>

  <Card title="TypeScript / JavaScript" href="/box/sdks/typescript">
    Install `@asciidev/box-sdk` from npm and use camelCase methods.
  </Card>
</CardGroup>

## Install

<CodeGroup>
  ```bash Python theme={null}
  python -m pip install ascii-box-sdk
  ```

  ```bash TypeScript / JavaScript theme={null}
  npm install @asciidev/box-sdk
  ```
</CodeGroup>

## Configure

Base URL:

```text theme={null}
https://ascii.dev/api/box/v1
```

Create a Box API key with `box api-key create` or in the [dashboard](https://box.ascii.dev/box/dashboard?tab=api-keys), store it as `BOX_API_KEY`, and pass it through the SDK `Configuration` object.

<Warning>
  Treat Box API keys, Box secrets, SSH keys, and returned desktop/VNC URLs as secrets. Do not log or persist them unredacted.
</Warning>

## Next steps

<CardGroup cols={2}>
  <Card title="Python SDK guide" href="/box/sdks/python">
    Configure the client, run the create/prompt example, and read the Python method and type reference.
  </Card>

  <Card title="TypeScript / JavaScript SDK guide" href="/box/sdks/typescript">
    Configure the client, run the create/prompt example, and read the TypeScript method and type reference.
  </Card>
</CardGroup>