Skip to content

armgit / E2B

Public Imported from GitHub
0

Open-source, secure environment with real-world tools for enterprise-grade agents.

SDK: fromFedoraImage/fromAlpineImage/fromArchImage helpers (#1612)

Tomas Srnka1504fbc8434d
diff --git a/.changeset/multi-distro-base-image-helpers.md b/.changeset/multi-distro-base-image-helpers.md
new file mode 100644
index 000000000..2fd50c7f8
--- /dev/null
+++ b/.changeset/multi-distro-base-image-helpers.md
@@ -0,0 +1,6 @@
+---
+'e2b': minor
+'@e2b/python-sdk': minor
+---
+
+Add `fromFedoraImage`, `fromAlpineImage`, and `fromArchImage` base-image helpers to the `Template` builder (`from_fedora_image`, `from_alpine_image`, `from_arch_image` in the Python SDK), alongside the existing `fromUbuntuImage`/`fromDebianImage`/etc. Templates can now start from Fedora, Alpine, and Arch base images (the orchestrator identifies the distro from `/etc/os-release`). Fedora and Alpine default to pinned tags (`fedora:44`, `alpine:3.24`) so builds stay reproducible; Arch defaults to `latest` because it is a rolling release and provisioning runs `pacman -Syu` regardless.
diff --git a/packages/js-sdk/src/template/index.ts b/packages/js-sdk/src/template/index.ts
index 48ed679c2..8cbb8f2b9 100644
--- a/packages/js-sdk/src/template/index.ts
+++ b/packages/js-sdk/src/template/index.ts
@@ -426,6 +426,20 @@ export class TemplateBase
return this.fromImage(`ubuntu:${variant}`)
}
+ fromFedoraImage(variant: string = '44'): TemplateBuilder {
+ return this.fromImage(`fedora:${variant}`)
+ }
+
+ fromAlpineImage(variant: string = '3.24'): TemplateBuilder {
+ return this.fromImage(`alpine:${variant}`)
+ }
+
+ // Left on `latest`: Arch is a rolling release and template provisioning runs
+ // `pacman -Syu`, so pinning a tag would not change the built result.
+ fromArchImage(variant: string = 'latest'): TemplateBuilder {
+ return this.fromImage(`archlinux:${variant}`)
+ }
+
fromPythonImage(version: string = '3'): TemplateBuilder {
return this.fromImage(`python:${version}`)
}
diff --git a/packages/js-sdk/src/template/types.ts b/packages/js-sdk/src/template/types.ts
index ca3594c51..58b543a3e 100644
--- a/packages/js-sdk/src/template/types.ts
+++ b/packages/js-sdk/src/template/types.ts
@@ -245,6 +245,42 @@ export interface TemplateFromImage {
*/
fromUbuntuImage(variant?: string): TemplateBuilder
+ /**
+ * Start from a Fedora-based Docker image.
+ * @param variant Fedora variant (default: '42')
+ *
+ * @example
+ * ```ts
+ * Template().fromFedoraImage('42')
+ * ```
+ */
+ fromFedoraImage(variant?: string): TemplateBuilder
+
+ /**
+ * Start from an Alpine-based Docker image.
+ * @param variant Alpine variant (default: '3.22')
+ *
+ * @example
+ * ```ts
+ * Template().fromAlpineImage('3.22')
+ * ```
+ */
+ fromAlpineImage(variant?: string): TemplateBuilder
+
+ /**
+ * Start from an Arch Linux-based Docker image.
+ *
+ * Defaults to `latest`: Arch is a rolling release and template provisioning
+ * runs `pacman -Syu`, so pinning a tag would not change the built result.
+ * @param variant Arch Linux variant (default: 'latest')
+ *
+ * @example
+ * ```ts
+ * Template().fromArchImage('base-devel')
+ * ```
+ */
+ fromArchImage(variant?: string): TemplateBuilder
+
/**
* Start from a Python-based Docker image.
* @param version Python version (default: '3')
diff --git a/packages/python-sdk/e2b/template/main.py b/packages/python-sdk/e2b/template/main.py
index d2549f05d..46f97799b 100644
--- a/packages/python-sdk/e2b/template/main.py
+++ b/packages/python-sdk/e2b/template/main.py
@@ -846,6 +846,55 @@ class TemplateBase:
"""
return self.from_image(f"ubuntu:{variant}")
+ def from_fedora_image(self, variant: str = "42") -> TemplateBuilder:
+ """
+ Start template from a Fedora base image.
+
+ :param variant: Fedora image variant (default: '42')
+
+ :return: `TemplateBuilder` class
+
+ Example
+ ```python
+ Template().from_fedora_image('42')
+ ```
+ """
+ return self.from_image(f"fedora:{variant}")
+
+ def from_alpine_image(self, variant: str = "3.22") -> TemplateBuilder:
+ """
+ Start template from an Alpine base image.
+
+ :param variant: Alpine image variant (default: '3.22')
+
+ :return: `TemplateBuilder` class
+
+ Example
+ ```python
+ Template().from_alpine_image('3.22')
+ ```
+ """
+ return self.from_image(f"alpine:{variant}")
+
+ def from_arch_image(self, variant: str = "latest") -> TemplateBuilder:
+ """
+ Start template from an Arch Linux base image.
+
+ Defaults to `latest`: Arch is a rolling release and template
+ provisioning runs `pacman -Syu`, so pinning a tag would not change
+ the built result.
+
+ :param variant: Arch Linux image variant (default: 'latest')
+
+ :return: `TemplateBuilder` class
+
+ Example
+ ```python
+ Template().from_arch_image('base-devel')
+ ```
+ """
+ return self.from_image(f"archlinux:{variant}")
+
def from_python_image(self, version: str = "3") -> TemplateBuilder:
"""
Start template from a Python base image.