Open-source, secure environment with real-world tools for enterprise-grade agents.
Python agentaiai-agentai-agentscode-interpretercopilotdevelopmentdevtoolsgptgpt-4javascriptllmnextjsopenaipythonreactsoftwaretypescript
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.mdnew file mode 100644index 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.tsindex 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 TemplateBasereturn 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.tsindex 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.pyindex 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.