v0.1.0 #6

Merged

pptx704 merged 24 commits from dev into main 2026-04-23 12:46:44 +00:00

Conversation 0 Commits 24 Files Changed 36 +11752 -141

pptx704 commented 2026-04-22 23:46:25 +00:00

Owner

Copy Link

Initial release of the Python SDK for the Wrenn microVM platform.

Highlights

• Capsule lifecycle — create, pause, resume, and destroy Firecracker microVMs with sync and async APIs
• Command execution — run shell commands with structured output (stdout, stderr, exit code)
• Filesystem — read, write, list, and manage files inside capsules
• PTY terminals — interactive terminal sessions over WebSocket
• Code interpreter — sandboxed code execution with structured Execution model
• Git integration — clone, branch, commit, diff, push/pull with built-in auth
• e2b-compatible — drop-in replacement for e2b; swap imports and go

Initial release of the Python SDK for the [Wrenn](https://wrenn.dev) microVM platform. ## Highlights - **Capsule lifecycle** — create, pause, resume, and destroy Firecracker microVMs with sync and async APIs - **Command execution** — run shell commands with structured output (stdout, stderr, exit code) - **Filesystem** — read, write, list, and manage files inside capsules - **PTY terminals** — interactive terminal sessions over WebSocket - **Code interpreter** — sandboxed code execution with structured `Execution` model - **Git integration** — clone, branch, commit, diff, push/pull with built-in auth - **e2b-compatible** — drop-in replacement for e2b; swap imports and go

pptx704 added 21 commits 2026-04-22 23:46:26 +00:00

feat: implement client architecture and sandbox environment ... f51a962fff

Introduces the core Wrenn client and a dedicated sandbox execution
environment. This includes automated model generation and a custom
exception hierarchy to support robust integration.

- Add `WrennClient` in `src/wrenn/client.py` for API interaction.
- Implement `Sandbox` in `src/wrenn/sandbox.py` for isolated execution.
- Add Pydantic/model support via `_generated.py`.
- Define project-specific error types in `exceptions.py`.
- Include AGENTS.md documentation for specialized logic.
- Add comprehensive unit and integration tests.
- Update build system (Makefile, uv.lock, pyproject.toml) and LICENSE.

feat: add sandbox filesystem and terminal support ... a5bf66c199

Add sandbox filesystem methods (list_dir, mkdir, remove, upload,
download, stream_upload, stream_download) and interactive PTY sessions
(PtySession, AsyncPtySession) with reconnect support per
FILE_TERMINAL.md spec. Refactor error handling into exceptions.py as
shared handle_response(). Replace API-key-only proxy auth with unified
_proxy_headers() supporting both API key and JWT. Fix stream_upload to
build multipart manually instead of relying on httpx files= with
generators. Switch Makefile SPEC_URL from main to dev branch. Regenerate
models from updated OpenAPI spec (adds teams, channels, metrics, PTY
endpoints). Add comprehensive unit and integration tests. Trim AGENTS.md
to verified facts only.

CI for linting and testing 340ed46df6

ci: bug fixes f3fd6865f9

ci: woodpecker doesn't support variable expansions outside of commands 976af9a209

fix: renamed sandbox to capsule bf5914c0a8

feat: created README 0ac9bf79ee

feat: redesign SDK with e2b-compatible interface ... 3cced768a4

Replace the WrennClient-centric API with a top-level Capsule class that
mirrors e2b's Sandbox interface, enabling drop-in migration. Key changes:

- Capsule/AsyncCapsule with direct construction (reads WRENN_API_KEY and
  WRENN_BASE_URL env vars), namespaced sub-objects (capsule.commands,
  capsule.files), dual instance/static lifecycle methods via _DualMethod
  descriptor (capsule.kill() and Capsule.kill(id))
- WrennClient simplified to API-key-only endpoints (capsules, snapshots);
  JWT-based resources (auth, hosts, teams) removed
- wrenn.code_interpreter submodule with Capsule subclass defaulting to
  code-runner-beta template and run_code() support
- Sandbox alias emits FutureWarning instead of DeprecationWarning

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

chore: update OpenAPI schema, generated models, and build config ... eecf1dc65b

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

feat: rename kill to destroy, improve code interpreter, update README ... 3d0eda5c60

- Rename Capsule.kill/AsyncCapsule.kill to destroy for frontend consistency
- Add Sandbox deprecation alias to wrenn.code_interpreter module
- run_code text falls back to stripped stdout when no expression result
- Strip quotes from string expression results (matching e2b behavior)
- _ensure_kernel reuses existing Jupyter kernels before creating new ones
- Rewrite README with complete examples for capsules and code interpreter
- Remove stale AGENTS.md

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

chore: add python-dotenv dependency ... 7b9a06d1b5

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Merge pull request 'feat: implement client architecture and sandbox environment' (#3) from feat/client-and-sandbox-support into dev ... 7e7ecbd48a

Reviewed-on: #3

feat: redesign code interpreter with structured Execution model ... 3f97c73b2f

Replace flat CodeResult with a proper model hierarchy: Execution
(top-level), Result (per-output with typed MIME fields), Logs
(stdout/stderr as lists), and ExecutionError (structured
name/value/traceback). Handle display_data messages for rich output,
add streaming callbacks (on_result, on_stdout, on_stderr, on_error),
and remove the misleading stdout-to-text fallback.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Updated dependency 42bcc792d6

docs: add Google-style docstrings to all public SDK methods 7b35ffb60c

Minor patches 61bc040098

Added git integration 6bdf28e2ae

fix: wrap commands in /bin/sh -c for proper server-side argv expansion ... ee1f55635f

The server-side agent runs commands through a nice wrapper that uses
"${@}" expansion. Sending the full command string as a single cmd field
caused nice to treat it as one executable name. Now Commands.run sends
cmd=/bin/sh args=["-c", cmd_string] so "${@}" expands into proper argv.

test: add integration tests for capsule lifecycle, commands, files, and git ... 82e181dd7e

43 tests across 4 classes hitting the live API. Shared capsule per class
to minimize VM boot overhead. All capsules destroyed in teardown.
Skips automatically when WRENN_API_KEY is not available.

Updated readme bab53aedbe

Merge pull request 'Feat: Added git support' (#5) from feat/git-support into dev ... ad64c85393

Reviewed-on: #5

pptx704 added 1 commit 2026-04-23 12:33:30 +00:00

ci: add test pipeline, PyPI release workflow, and lint fixes ... 68c7d0de42

- Update Woodpecker to run unit and integration tests in parallel
- Add GitHub Actions workflow for PyPI trusted publishing on main
- Add license, classifiers, keywords, and URLs to pyproject.toml
- Fix ruff lint errors (unused imports, duplicate class name) and formatting

pptx704 added 1 commit 2026-04-23 12:36:46 +00:00

Updated woodpecker config 2faf0dd0ae

pptx704 added 1 commit 2026-04-23 12:38:43 +00:00

Merge branch 'main' into dev 3f26a2fbcf

pptx704 merged commit d46a715839 into main 2026-04-23 12:46:44 +00:00

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

No items

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

pptx704 tksadik92

No Assignees

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: wrenn/python-sdk#6

No description provided.