# code-interpreter - Doramagic AI Context Pack

> Purpose: pre-work context for the user's host AI. This pack does not prove that the project has been installed, run, or validated.

## Project

- canonical_name: `e2b-dev/code-interpreter`
- capability: Python & JS/TS SDK for running AI-generated code/code interpreting in your AI app
- expected_user_outcome: Python & JS/TS SDK for running AI-generated code/code interpreting in your AI app

## Operating Boundaries

- Do not claim that the project has been installed, run, called through an API, or used on local files unless separate evidence proves it.
- Project facts must come from repo evidence, Claim Graph, or explicit source references.
- When a capability is not verified, mark it as unverified instead of completing it as fact.
- publish_status: `publishable`
- blocking_gaps: none

---

## Doramagic Context Augmentation

The following sections strengthen the repository context for a host AI. Human Manual data is a reading route, and pitfall notes become operating constraints.

## Human Manual Outline

Usage rule: this is only a reading route and salience signal, not factual authority. Concrete claims must still return to repo evidence or Claim Graph.

Host AI hard rules:
- Do not treat page titles, section order, summaries, or importance values as factual project evidence.
- When explaining the Human Manual outline, state that it is only a reading route or salience signal.
- Capability, installation, compatibility, runtime state, and risk claims must cite repo evidence, source paths, or Claim Graph.

- **Overview & Monorepo Architecture**: importance `high`
  - source_paths: README.md, package.json, pnpm-workspace.yaml, js/src/index.ts, python/e2b_code_interpreter/__init__.py
- **Client SDKs: JavaScript & Python APIs**: importance `high`
  - source_paths: js/src/sandbox.ts, js/src/index.ts, js/src/messaging.ts, js/src/charts.ts, js/src/consts.ts
- **Sandbox Template, Kernels & Custom Builds**: importance `high`
  - source_paths: template/README.md, template/template.py, template/build_prod.py, template/build_test.py, template/build_debug.py
- **Operations, Lifecycle & Common Failure Modes**: importance `high`
  - source_paths: README.md, js/package.json, python/package.json, template/package.json, python/e2b_code_interpreter/exceptions.py

## Repo Inspection Evidence

- repo_clone_verified: true
- repo_inspection_verified: true
- repo_commit: `efadb49cc87e06766bdb1cc6f33d3c54cd3e2607`
- inspected_files: `pnpm-lock.yaml`, `README.md`, `package.json`

Host AI hard rules:
- Without repo_clone_verified=true, do not claim that the source code has been read.
- Without repo_inspection_verified=true, do not write README, docs, or package-file conclusions as facts.
- Without quick_start_verified=true, do not claim that the Quick Start path has run successfully.

## Doramagic Pitfall Constraints

These rules come from Doramagic discovery, validation, or compilation findings. The host AI must treat them as operating constraints, not background notes.

### Constraint 1: Installation risk requires verification

- Trigger: Project evidence flags a installation risk. Review the linked source before relying on this workflow.
- Host AI rule: Reproduce the official install and quickstart path in an isolated environment.
- Why it matters: May increase setup, validation, or first-run risk for the user.
- Evidence: community_evidence:github | https://github.com/e2b-dev/code-interpreter/issues/150
- Hard boundary: Do not present this pitfall as solved, verified, or ignorable unless later evidence explicitly closes it.

### Constraint 2: Security or permission risk requires verification

- Trigger: Project evidence flags a security or permission risk. Review the linked source before relying on this workflow.
- Host AI rule: Reproduce the official install and quickstart path in an isolated environment.
- Why it matters: May increase setup, validation, or first-run risk for the user.
- Evidence: community_evidence:github | https://github.com/e2b-dev/code-interpreter/issues/200
- Hard boundary: Do not present this pitfall as solved, verified, or ignorable unless later evidence explicitly closes it.

### Constraint 3: Installation risk requires verification

- Trigger: Developers should check this installation risk before relying on the project: @e2b/code-interpreter-python@2.6.2
- Host AI rule: Before packaging this project, run the relevant install/config/quickstart check for: @e2b/code-interpreter-python@2.6.2. Context: Observed when using python
- Why it matters: Upgrade or migration may change expected behavior: @e2b/code-interpreter-python@2.6.2
- Evidence: failure_mode_cluster:github_release | https://github.com/e2b-dev/code-interpreter/releases/tag/%40e2b/code-interpreter-python%402.6.2
- Hard boundary: Do not present this pitfall as solved, verified, or ignorable unless later evidence explicitly closes it.

### Constraint 4: Installation risk requires verification

- Trigger: Developers should check this installation risk before relying on the project: @e2b/code-interpreter@2.4.2
- Host AI rule: Before packaging this project, run the relevant install/config/quickstart check for: @e2b/code-interpreter@2.4.2. Context: Source discussion did not expose a precise runtime context.
- Why it matters: Upgrade or migration may change expected behavior: @e2b/code-interpreter@2.4.2
- Evidence: failure_mode_cluster:github_release | https://github.com/e2b-dev/code-interpreter/releases/tag/%40e2b/code-interpreter%402.4.2
- Hard boundary: Do not present this pitfall as solved, verified, or ignorable unless later evidence explicitly closes it.

### Constraint 5: Installation risk requires verification

- Trigger: Developers should check this installation risk before relying on the project: Dependency Dashboard
- Host AI rule: Before packaging this project, run the relevant install/config/quickstart check for: Dependency Dashboard. Context: Observed when using node, python, docker, linux
- Why it matters: Developers may fail before the first successful local run: Dependency Dashboard
- Evidence: failure_mode_cluster:github_issue | https://github.com/e2b-dev/code-interpreter/issues/200
- Hard boundary: Do not present this pitfall as solved, verified, or ignorable unless later evidence explicitly closes it.

### Constraint 6: Installation risk requires verification

- Trigger: Developers should check this installation risk before relying on the project: Need UV-based code-interpreter custom template
- Host AI rule: Before packaging this project, run the relevant install/config/quickstart check for: Need UV-based code-interpreter custom template. Context: Observed when using python
- Why it matters: Developers may fail before the first successful local run: Need UV-based code-interpreter custom template
- Evidence: failure_mode_cluster:github_issue | https://github.com/e2b-dev/code-interpreter/issues/175
- Hard boundary: Do not present this pitfall as solved, verified, or ignorable unless later evidence explicitly closes it.

### Constraint 7: Installation risk requires verification

- Trigger: Project evidence flags a installation risk. Review the linked source before relying on this workflow.
- Host AI rule: Reproduce the official install and quickstart path in an isolated environment.
- Why it matters: May increase setup, validation, or first-run risk for the user.
- Evidence: community_evidence:github | https://github.com/e2b-dev/code-interpreter/issues/175
- Hard boundary: Do not present this pitfall as solved, verified, or ignorable unless later evidence explicitly closes it.

### Constraint 8: Configuration risk requires verification

- Trigger: Developers should check this configuration risk before relying on the project: @e2b/code-interpreter-python@2.7.0
- Host AI rule: Before packaging this project, run the relevant install/config/quickstart check for: @e2b/code-interpreter-python@2.7.0. Context: Observed when using python
- Why it matters: Upgrade or migration may change expected behavior: @e2b/code-interpreter-python@2.7.0
- Evidence: failure_mode_cluster:github_release | https://github.com/e2b-dev/code-interpreter/releases/tag/%40e2b/code-interpreter-python%402.7.0
- Hard boundary: Do not present this pitfall as solved, verified, or ignorable unless later evidence explicitly closes it.

### Constraint 9: Configuration risk requires verification

- Trigger: Developers should check this configuration risk before relying on the project: @e2b/code-interpreter@2.5.0
- Host AI rule: Before packaging this project, run the relevant install/config/quickstart check for: @e2b/code-interpreter@2.5.0. Context: Observed when using python
- Why it matters: Upgrade or migration may change expected behavior: @e2b/code-interpreter@2.5.0
- Evidence: failure_mode_cluster:github_release | https://github.com/e2b-dev/code-interpreter/releases/tag/%40e2b/code-interpreter%402.5.0
- Hard boundary: Do not present this pitfall as solved, verified, or ignorable unless later evidence explicitly closes it.

### Constraint 10: Capability evidence risk requires verification

- Trigger: README/documentation is current enough for a first validation pass.
- Host AI rule: Reproduce the official install and quickstart path in an isolated environment.
- Why it matters: May increase setup, validation, or first-run risk for the user.
- Evidence: capability.assumptions | github_repo:770633006 | https://github.com/e2b-dev/code-interpreter
- Hard boundary: Do not present this pitfall as solved, verified, or ignorable unless later evidence explicitly closes it.