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

# Quickstart

> Get started with in10nt in 5 minutes

## Installation

Install the SDK using npm or yarn:

```bash theme={null}
npm install @in10nt/sdk
```

```bash theme={null}
yarn add @in10nt/sdk
```

## Setup

Get your API key from the in10nt dashboard. You can either set it as an environment variable or pass it directly.

### Zero-config path (recommended)

```bash theme={null}
export IN10NT_API_KEY=your_api_key
```

```typescript theme={null}
import { Instance } from '@in10nt/sdk';

// Uses IN10NT_API_KEY automatically
const instance = await Instance.create({
  name: 'my-first-agent',
  description: 'My first coding agent'
});
```

### Client path

```typescript theme={null}
import { In10ntClient } from '@in10nt/sdk';

const client = new In10ntClient({
  apiKey: 'your_api_key'  // or set IN10NT_API_KEY env var
});
```

## Create Your First Agent

```typescript theme={null}
import { Instance } from '@in10nt/sdk';

const instance = await Instance.create({
  name: 'my-first-agent',
  description: 'My first coding agent'
});

const result = await instance.run(
  'Create a simple Express.js server with health check'
);

console.log(result.response);
console.log(`Tokens: ${result.tokensUsed}`);

await instance.destroy();
```

<Note>
  Both `name` and `description` are required when creating instances
</Note>

## Reconnect to an Existing Instance

```typescript theme={null}
// By ID
const instance = await Instance.connect('inst_abc123');

// List all
const all = await Instance.list();
```

## Next Steps

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/getting-started/authentication">
    Learn about API authentication
  </Card>

  <Card title="Instances API" icon="server" href="/api/instances">
    Explore instance management
  </Card>

  <Card title="Examples" icon="lightbulb" href="/guides/examples">
    See more usage examples
  </Card>

  <Card title="Best Practices" icon="star" href="/guides/best-practices">
    Learn recommended patterns
  </Card>
</CardGroup>

## What You Can Do

* **`Create instances`**: Spin up AI coding agents in seconds
* **`Run tasks`**: Execute complex coding tasks with natural language
* **`Maintain context`**: Continue conversations across multiple prompts
* **`Custom environments`**: Use any Docker image as your base
* **`Track usage`**: Monitor token consumption and costs
* **`Namespaced sub-modules`**: `instance.tasks.*`, `instance.ports.*`, `instance.files.*`
