a240f99db5
## Summary - Updated root README, js-sdk README, and python-sdk README to show base `e2b` SDK install and usage as the default - Code-interpreter is now shown as an optional step for when `runCode()`/`run_code()` is actually needed - SDK links in descriptions now point to base `e2b` packages on npm/PyPI ## Why The base `e2b` package covers commands, files, git, networking, and sandbox lifecycle. Users who don't need code execution shouldn't be directed to install `@e2b/code-interpreter` / `e2b-code-interpreter` as their first step. ## Test plan - [ ] Verify README renders correctly on GitHub - [ ] Confirm base SDK examples use correct import syntax - [ ] Confirm code-interpreter section still shows correct usage for `runCode()`
3.1 KiB
3.1 KiB
What is E2B?
E2B is an open-source infrastructure that allows you to run AI-generated code in secure isolated sandboxes in the cloud. To start and control sandboxes, use our JavaScript SDK or Python SDK.
Run your first Sandbox
1. Install SDK
JavaScript / TypeScript
npm i e2b
Python
pip install e2b
2. Get your E2B API key
E2B_API_KEY=e2b_***
3. Start a sandbox and run commands
JavaScript / TypeScript
import Sandbox from 'e2b'
const sandbox = await Sandbox.create()
const result = await sandbox.commands.run('echo "Hello from E2B!"')
console.log(result.stdout) // Hello from E2B!
Python
from e2b import Sandbox
with Sandbox.create() as sandbox:
result = sandbox.commands.run('echo "Hello from E2B!"')
print(result.stdout) # Hello from E2B!
4. Code execution with Code Interpreter
If you need to execute code with runCode()/run_code(), install the Code Interpreter SDK:
npm i @e2b/code-interpreter # JavaScript/TypeScript
pip install e2b-code-interpreter # Python
import { Sandbox } from '@e2b/code-interpreter'
const sandbox = await Sandbox.create()
const execution = await sandbox.runCode('x = 1; x += 1; x')
console.log(execution.text) // outputs 2
5. Check docs
Visit E2B documentation.
6. E2B cookbook
Visit our Cookbook to get inspired by examples with different LLMs and AI frameworks.
Self-hosting
Read the self-hosting guide to learn how to set up the E2B infrastructure on your own. The infrastructure is deployed using Terraform.
Supported cloud providers:
- 🟢 AWS
- 🟢 Google Cloud (GCP)
- Azure
- General Linux machine

