## What is E2B?
[E2B](https://e2b.dev/?utm_source=npm&utm_medium=referral&utm_campaign=readme&utm_content=code-interpreter) is an open-source infrastructure that allows you run to AI-generated code in secure isolated sandboxes in the cloud. To start and control sandboxes, use our [JavaScript SDK](https://www.npmjs.com/package/@e2b/code-interpreter) or [Python SDK](https://pypi.org/project/e2b_code_interpreter).
Source: [packages/code-interpreter-js](https://github.com/e2b-dev/E2B/tree/main/packages/code-interpreter-js)
## Run your first Sandbox
### 1. Install SDK
```
npm i @e2b/code-interpreter
```
### 2. Get your E2B API key
1. Sign up to E2B [here](https://e2b.dev/?utm_source=npm&utm_medium=referral&utm_campaign=readme&utm_content=code-interpreter).
2. Get your API key [here](https://e2b.dev/dashboard?tab=keys&utm_source=npm&utm_medium=referral&utm_campaign=readme&utm_content=code-interpreter).
3. Set environment variable with your API key.
```
E2B_API_KEY=e2b_***
```
### 3. Execute code with code interpreter inside Sandbox
```ts
import { Sandbox } from '@e2b/code-interpreter'
const sbx = await Sandbox.create()
await sbx.runCode('x = 1')
const execution = await sbx.runCode('x+=1; x')
console.log(execution.text) // outputs 2
```
### 4. Bind the configuration to a client
The top-level `Sandbox` export reads its configuration from the environment variables. To use an explicit configuration — e.g. several API keys or domains in one process — create an `E2B` client and use the resources it exposes:
```ts
import { E2B } from '@e2b/code-interpreter'
const client = new E2B({ apiKey: 'e2b_***', domain: 'e2b.dev' })
const sbx = await client.Sandbox.create()
const execution = await sbx.runCode('x = 1; x += 1; x')
// The core resources are bound to the client's configuration as well.
const volume = await client.Volume.create('my-volume')
const exists = await client.Template.exists('my-template')
await client.Secret.create('openai-api-key', 'sk-***')
// The classes can be destructured and used like the top-level ones.
const { Sandbox } = client
const paginator = Sandbox.list()
```
Per-call options still take precedence over the client's options, and clients are isolated from each other and from the env-configured top-level exports.
### 5. Check docs
Visit [E2B documentation](https://docs.e2b.dev/?utm_source=npm&utm_medium=referral&utm_campaign=readme&utm_content=code-interpreter).
### 6. E2B cookbook
Visit our [Cookbook](https://github.com/e2b-dev/e2b-cookbook/tree/main) to get inspired by examples with different LLMs and AI frameworks.
