TechPrufer
Get started
Modal
Modal logoModal · Feature trail

Client API Stability and Ergonomics

2 posts · Apr 2025 – Jun 2025

What this trail covers

Modal 1.0 marks a significant milestone in the maturity and stability of the Modal platform's client API. Key design principles for this release include avoiding unpredictable 'magic' behaviors by making features like package automounting explicit, separating core functionality from additional concepts through distinct decorators (e.g., `@modal.concurrent`), and consolidating related functionalities into canonical paths (e.g., managing local files within `modal.Image`). This release aims to provide a more predictable and easier-to-debug developer experience, with a more batched and predictable client release cycle.

All Modal trails
  1. Introducing: Modal 1.0Modal 1.0 introduces a more predictable and stable client API by moving away from implicit 'magic' behaviors like automatic package mounting, making them explicit via `modal.Image`. Core functionality is now separated from additional concepts using distinct decorators like `@modal.concurrent`. Local file management is consolidated under the `modal.Image` class, deprecating the `modal.Mount` object as a direct Function configuration. The client release cycle is now batched for better predictability.
  2. Modal SDKs for JavaScript and Go (alpha)Introduced alpha versions of official Modal SDKs for JavaScript and Go. These SDKs allow developers to call deployed Modal Functions and create/interact with isolated sandboxes from server-side JavaScript (Node, Deno, Bun) and Go code. The SDKs support calling functions with JSON-like or `bytes` data types and creating sandboxes for executing arbitrary code, running untrusted scripts, checking out Git repos, and running one-off jobs. Authentication can be done via CLI setup or environment variables. The post notes that deployment of Modal Functions still requires Python and that advanced function calling modes, sandbox tunnels, volumes, and container lifecycle management are coming soon.