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

# Installation

> Install and configure the Signa SDK

## Install

<CodeGroup>
  ```bash npm theme={null}
  npm install @signa-so/sdk
  ```

  ```bash yarn theme={null}
  yarn add @signa-so/sdk
  ```

  ```bash pnpm theme={null}
  pnpm add @signa-so/sdk
  ```

  ```bash bun theme={null}
  bun add @signa-so/sdk
  ```
</CodeGroup>

## Requirements

* Node.js 18+ or Bun 1.0+
* TypeScript 5.0+ (optional but recommended)

## Configuration

```typescript theme={null}
import { Signa } from '@signa-so/sdk';

const signa = new Signa({
  api_key: process.env.SIGNA_API_KEY,
  // Optional overrides
  base_url: 'https://api.signa.so',  // default
  timeout: 30_000,                    // 30s default
  max_retries: 2,                     // auto-retry on 429/5xx
});
```

## Environment Variables

The SDK reads `SIGNA_API_KEY` from the environment if no key is passed explicitly:

```bash theme={null}
export SIGNA_API_KEY=sig_your_key_here
```

```typescript theme={null}
// Will use SIGNA_API_KEY automatically
const signa = new Signa();
```