https://aitoolchain.io/tools/smolagents New releases and features in smolagents, tracked by The AI Toolchain. en Fri, 29 May 2026 05:09:47 GMT https://github.com/huggingface/smolagents/releases/tag/v1.26.0 https://github.com/huggingface/smolagents/releases/tag/v1.26.0 Fri, 29 May 2026 05:09:47 GMT smolagents v1.26.0 adds Exa as a search engine option in WebSearchTool and removes the remote WasmExecutor. • Adds `Exa` as a supported search engine option in `WebSearchTool`. Breaking changes: • The remote `WasmExecutor` has been removed; any setup relying on it will break on upgrade. https://github.com/huggingface/smolagents/releases/tag/v1.24.0 https://github.com/huggingface/smolagents/releases/tag/v1.24.0 Fri, 16 Jan 2026 05:38:28 GMT smolagents v1.24.0 adds FinalAnswerStep callbacks, additional apply_chat_template params, and a robust Python execution timeout mechanism. • Adds `FinalAnswerStep` as a supported type in `step_callbacks`, enabling callbacks that fire on the agent's final answer step. • Supports passing additional params to `apply_chat_template`, giving callers finer control over prompt formatting. • Implements a robust timeout mechanism for Python code execution in the local sandbox. • Coerces tool calls from external APIs into the internal `ChatMessageToolCall` format, broadening compatibility with third-party model APIs. • Extends the no-stop-sequence model list to support `gpt-5.2*` model variants. https://github.com/huggingface/smolagents/releases/tag/v1.23.0 https://github.com/huggingface/smolagents/releases/tag/v1.23.0 Mon, 17 Nov 2025 14:35:02 GMT smolagents v1.23.0 adds a dialog-mode CLI, Blaxel remote execution, custom Python executors, and exponential-backoff retries. • Adds dialog mode to the CLI (`smolagents` CLI with dialog mode), enabling interactive multi-turn conversations from the command line. • Supports custom Python code executors in `CodeAgent`, letting practitioners plug in their own execution backend instead of the default `LocalPythonExecutor`. • Adds Blaxel integration as a remote code execution sandbox option for `CodeAgent`. • Adds exponential backoff with jitter for model call retries, including automatic retry on rate-limit errors. • Changes the default `InferenceClient` model to `Qwen/Qwen3-Next-80B-A3B-Thinking`. • Adds support for parsing `anyOf` type schemas from MCP tools, broadening MCP tool compatibility. • Adds support for nested dict comprehensions (`dictcomp`) and set comprehensions (`setcomp`) in `LocalPythonExecutor`. • Optimizes comprehension evaluation in `LocalPythonExecutor` using a generator-based approach. • Makes `additional_args` nullable for managed agents. • Migrates vLLM structured output from `guided_options_request` to `structured_outputs`. • Updates final answer checks to accept the agent instance, enabling richer validation logic. Breaking changes: • The default model used by `InferenceClient` changes to `Qwen/Qwen3-Next-80B-A3B-Thinking`; any code relying on the previous default model will silently switch targets on upgrade. • vLLM integration moves from `guided_options_request` to `structured_outputs` for structured output; configurations or wrappers that reference `guided_options_request` will break. https://github.com/huggingface/smolagents/releases/tag/v1.22.0 https://github.com/huggingface/smolagents/releases/tag/v1.22.0 Thu, 25 Sep 2025 08:47:27 GMT smolagents v1.22.0 adds Modal remote execution, custom Dockerfiles, MCP structured output, and user-configurable model parameter overrides. • Adds `return_full_result` parameter directly to the agent `run` method, enabling callers to retrieve the full `RunResult` object inline. • Adds support for custom Dockerfile in `DockerExecutor`, letting users supply their own build context instead of the default image. • Adds support for user-configurable parameter overrides for model completion parameters, allowing callers to override defaults passed to the underlying model completion call. • Adds `ModalRemoteExecutor` for running agent code on Modal's remote infrastructure. • Adds support for MCP structured output and output schema in MCP tool integrations. • Makes `RunResult` JSON-serializable, enabling downstream logging and persistence pipelines. • Supports `e2b-code-interpreter` v2 in `E2BExecutor`. https://github.com/huggingface/smolagents/releases/tag/v1.21.0 https://github.com/huggingface/smolagents/releases/tag/v1.21.0 Thu, 07 Aug 2025 10:48:49 GMT smolagents v1.21.0 adds Tool prompt methods, model_kwargs support for TransformersModel, Amazon Bedrock API key auth, and hardened LocalPythonExecutor. • Adds `model_kwargs` pass-through to `TransformersModel` for fine-grained inference control. • Adds to_code_prompt() and to_tool_calling_prompt() methods to `Tool` for generating prompt representations of tools. • Adds Amazon Bedrock API key authentication support to `AmazonBedrockServerModel`. • Supports passing plain `dict` messages as direct input to models. • Hardens `LocalPythonExecutor` security by blocking dunder (double-underscore) method calls. • Resets agent memory when the clear button is clicked in `GradioUI`. • Uses `gr.Number` for integer and number type components in `launch_gradio_demo` for more accurate input handling. Breaking changes: • The deprecated `grammar` parameter has been removed. • The deprecated token count attributes have been removed. • The deprecated agent `logs` attribute has been removed. • The deprecated default `sse` transport has been removed. https://github.com/huggingface/smolagents/releases/tag/v1.20.0 https://github.com/huggingface/smolagents/releases/tag/v1.20.0 Thu, 10 Jul 2025 16:22:39 GMT smolagents v1.20.0 adds a remote Python WasmExecutor, post-planning callbacks, rate limiting across API models and search tools, and image output for Tool.from_space. • Adds `adapter_kwargs` parameter to `MCPClient` for passing custom adapter configuration. • Adds `CodeOutput` class as an analog to `ToolOutput` for structured code output from agents. • Adds `ApiWebSearchTool` to the public `__all__` export list, making it directly importable from the package. • Adds import validation in the `LocalPythonExecutor` constructor, checking authorized imports at instantiation time rather than at execution time. • Enforces type annotations on `ChatMessage` roles via the `MessageRole` enum. • Implements a remote Python `WasmExecutor` for sandboxed, browser-compatible agent code execution. • Supports callbacks after the planning step via `step_callbacks`, extending the existing callback mechanism. • Supports multiple callbacks per step type in the `step_callbacks` dict. • Implements rate limit mechanism in `ApiWebSearchTool` and `DuckDuckGoSearchTool`. • Sets a default `api_key_name` in `ApiWebSearchTool`, reducing required configuration. • Enables image output for tools created via `Tool.from_space`. • Supports multiple types in tool argument validation, allowing union-typed inputs. • Allows markdown or custom formatting for code blocks in agent output. https://github.com/huggingface/smolagents/releases/tag/v1.19.0 https://github.com/huggingface/smolagents/releases/tag/v1.19.0 Tue, 24 Jun 2025 08:43:14 GMT smolagents v1.19.0 adds managed-agent support in ToolCallingAgent, context-manager cleanup, GradioUI memory reset, and CodeAgent output tracking. • Supports `reset_agent_memory` in `GradioUI`, letting users clear conversation history from the UI between sessions. • Stores `CodeAgent` code outputs in `ActionStep`, making intermediate code execution results available for downstream inspection. • Supports managed agents in `ToolCallingAgent`, enabling multi-agent orchestration through the tool-calling interface. • Supports context managers for agent cleanup, allowing `with` blocks to reliably tear down agent resources. • Transfers streaming event aggregation off the `Model` class, enabling more flexible streaming architectures. https://github.com/huggingface/smolagents/releases/tag/v1.18.0 https://github.com/huggingface/smolagents/releases/tag/v1.18.0 Tue, 10 Jun 2025 14:15:08 GMT smolagents v1.18.0 adds parallel tool calls, streaming output, and a new ApiWebSearchTool to ToolCallingAgent • Adds `ApiWebSearchTool` class for structured web search capabilities via API, with support for custom headers and params. • Adds configurable `tool_choice` support in `prepare_completion_kwargs` for fine-grained control over model tool selection. • Enables `ToolCallingAgent` to execute multiple tool calls in parallel, improving performance on complex multi-tool tasks. • Adds streaming output support to `ToolCallingAgent` for improved responsiveness during multi-step tool interactions. • Adds support for passing additional params to `MLXModel` load and `tokenizer.apply_chat_template`. • Makes `Agent.system_prompt` a read-only property. https://github.com/huggingface/smolagents/releases/tag/v1.17.0 https://github.com/huggingface/smolagents/releases/tag/v1.17.0 Tue, 27 May 2025 11:26:12 GMT smolagents v1.17.0 adds structured generation in CodeAgent, RunResult from Agent.run(), and streamable HTTP MCP server support. • Adds optional structured generation to `CodeAgent` via `use_structured_outputs_internally`, enabling more reliable and consistent code generation patterns. • Agent.run() now returns a `RunResult` object, providing richer metadata about agent execution. • Adds support for streamable HTTP MCP servers, expanding compatibility beyond standard MCP implementations. • Improves LaTeX rendering in `GradioUI` with extended delimiter support. Breaking changes: • The deprecated `from_hf_api` methods have been removed. https://github.com/huggingface/smolagents/releases/tag/v1.16.0 https://github.com/huggingface/smolagents/releases/tag/v1.16.0 Fri, 16 May 2025 05:59:44 GMT smolagents v1.16.0 adds Bing search, custom executor functions, code timeouts, and local web agent CLI support • Adds `executor_kwargs` parameter to `LocalPythonExecutor` for initialization customization of the local Python executor. • Adds timeout mechanism for code execution in the local Python executor. • Enables local web agents via `api_base` and `api_key` CLI arguments. • Supports passing custom functions to the local Python executor. • Adds Bing as a supported search engine in `WebSearchTool`. • Changes the default value of the `provider` argument in `InferenceClientModel` from `'hf-inference'` to `'auto'`, automatically selecting the first available provider per the user's configured priority. Breaking changes: • The default value of the `provider` argument in `InferenceClientModel` has changed from `'hf-inference'` to `'auto'`; existing setups relying on the `hf-inference` provider by default will now use whichever provider is ranked first in the user's inference-provider settings at https://hf.co/settings/inference-providers. https://github.com/huggingface/smolagents/releases/tag/v1.15.0 https://github.com/huggingface/smolagents/releases/tag/v1.15.0 Wed, 07 May 2025 15:25:24 GMT smolagents v1.15.0 adds streaming model output, a LiteLLM Router model, and a new WebSearchTool. • Adds `LiteLLMRouterModel` to support LiteLLM Router as a model backend, enabling load-balanced or fallback routing across LLM providers. • Adds `WebSearchTool`, replacing `DuckDuckGoSearchTool` as the recommended built-in web search tool. • Adds streaming model output support, including streaming Gradio chatbot outputs; introduces `ChatMessageStreamDelta` as the stream delta type. • Moves `MCPClient` to the root-level library and manages its dependencies as optional. Breaking changes: • `CompletionDelta` is renamed to `ChatMessageStreamDelta`; code referencing `CompletionDelta` will break. https://github.com/huggingface/smolagents/releases/tag/v1.14.0 https://github.com/huggingface/smolagents/releases/tag/v1.14.0 Fri, 18 Apr 2025 09:59:12 GMT smolagents v1.14.0 adds MCPClient for MCP server connections, Amazon Bedrock native support, and star-pattern import authorization. • Adds `MCPClient` class to manage connections to one or more MCP servers, enabling flexible multi-server integration within smolagents. • Introduces star-pattern-based import authorization for fine-grained control over which modules agents are permitted to import, improving sandboxed execution security. • Adds `client_kwargs` pass-through for `VLLMModel` to supply model client parameters to the underlying vLLM client. • Adds `api_key` argument to `HfApiModel` / `InferenceClientModel` for explicit key configuration. • Implements `Tool.from_dict` and `Agent.from_dict` for deserializing tools and agents from dictionary representations. • Supports `Literal` type annotations in the `@tool` decorator for defining enum-constrained arguments. • Adds custom Docker image support and enhanced configuration options for `DockerExecutor`. • Makes `MultiStepAgent` an abstract class, enabling cleaner subclassing for custom agent types. • Supports class docstrings and annotated assignments in `LocalPythonExecutor`, broadening the Python syntax handled during sandboxed code execution. Breaking changes: • `HfApiModel` is renamed to `InferenceClientModel`; any code importing or instantiating `HfApiModel` by that name will break. https://github.com/huggingface/smolagents/releases/tag/v1.13.0 https://github.com/huggingface/smolagents/releases/tag/v1.13.0 Wed, 02 Apr 2025 15:10:31 GMT smolagents v1.13.0 adds agent interruption, image observation logging in the Gradio UI, and automatic submodule import authorization. • Adds `trust_remote_code` parameter to `ToolCollection.from_mcp` for controlling remote code trust when loading MCP tool collections. • Authorizes submodule imports automatically when a top-level package is listed in `additional_authorized_imports` — e.g. `additional_authorized_imports=["numpy"]` now also permits `numpy.random` and other subpackages without listing each one explicitly. • Adds agent interruption support, allowing a running agent to be interrupted mid-execution. • Gradio UI now logs images observed by the agent during a run, making multimodal agent traces visible in the interface. • Exposes the underlying Gradio app object so users can retrieve and customize it directly. • Adds `WikipediaSearchTool` to the default tools available in smolagents. • Introduces distinct `AgentToolCallError` and `AgentToolExecutionError` exception types, separating tool-call failures from tool-execution failures. • Streaming run now yields `PlanningSteps`, making planning activity visible during streamed agent runs. https://github.com/huggingface/smolagents/releases/tag/v1.12.0 https://github.com/huggingface/smolagents/releases/tag/v1.12.0 Thu, 20 Mar 2025 09:37:38 GMT smolagents v1.12.0 adds MCP SSE server support and cuts planning step model calls in half. • Adds support for MCP SSE servers, enabling agents to connect to Server-Sent Events-based Model Context Protocol tool servers. • Reduces model calls in `planning_step` from 2 to 1, halving LLM API usage per planning cycle. https://github.com/huggingface/smolagents/releases/tag/v1.11.0 https://github.com/huggingface/smolagents/releases/tag/v1.11.0 Fri, 14 Mar 2025 19:55:16 GMT smolagents v1.11.0 adds VLLMModel, tightens sandbox security with module whitelisting, and expands E2B and OpenAI server options. • Adds `VLLMModel` class for running inference against vLLM-served models directly from smolagents. • Adds `flatten_messages_as_text` kwarg support to `OpenAIServerModel` for controlling message serialization behavior. • Supports passing arbitrary kwargs to `E2BExecutor` `Sandbox` constructor, unlocking full E2B sandbox configuration from the agent layer. • Forbids all modules by default in the local executor except those explicitly listed in `authorized_imports`, hardening sandboxed code execution. • Forbids access to all dunder attributes by default in the local executor, closing a class of sandbox escape vectors. • Switches dangerous-code detection from pattern matching to module-level checking, improving accuracy of sandbox security enforcement. • Adds `mlx-lm` to the `all` extras group, making Apple Silicon local inference available via a single install target. • Raises agent generation errors as exceptions instead of silently swallowing them, making failure modes visible to callers. • Logs agent thoughts when `verbosity_level` is set to high, giving practitioners full reasoning traces during debugging. Breaking changes: • Default `model_id` is removed from all model classes — callers that previously relied on the default must now pass an explicit `model_id`. • All modules are now forbidden in the local executor by default; only those in `authorized_imports` are allowed — existing agents that imported modules without declaring them in `authorized_imports` will break. https://github.com/huggingface/smolagents/releases/tag/v1.10.0 https://github.com/huggingface/smolagents/releases/tag/v1.10.0 Wed, 05 Mar 2025 18:04:08 GMT smolagents v1.10.0 adds a Docker sandbox executor, Serper search support, custom final-answer handling, and `--api-base`/`--api-key` CLI arguments. • Adds `executor="docker"` argument to agent initialization, running generated code inside a Docker sandbox for isolated execution. • Adds `--api-base` and `--api-key` arguments to the CLI for configuring model endpoints directly from the command line. • Adds support for Serper as a search backend, expanding the available web-search tools. • Enables custom `final_answer` handling in `CodeAgent` and via agent `__init__`, letting callers override how the agent surfaces its final result. • Hardens the local Python interpreter by blocking access to builtins and dangerous modules at return time, reducing sandbox-escape risk without additional configuration. • Supports running an Open DeepResearch demo, including compatibility with models beyond `o1` and Python ≥ 3.13 dependencies. https://github.com/huggingface/smolagents/releases/tag/v1.9.0 https://github.com/huggingface/smolagents/releases/tag/v1.9.0 Fri, 14 Feb 2025 11:26:48 GMT smolagents v1.9.0 adds MLX model support, agent sharing, Gradio share passthrough, and a PromptTemplates typed dict. • Adds `MLXModel` class, enabling local inference on Apple Silicon via the MLX framework. • Adds `share` parameter passthrough for Gradio, allowing agents to be exposed via a public Gradio link. • Adds `PromptTemplates` typed dict, providing structured, type-checked prompt template definitions. • Adds 'Share full agents' capability, enabling agents to be published and shared with others. • Adds default value for `max_new_tokens` parameter in `TransformersModel`, removing the requirement to set it explicitly. • `LiteLLMModel` now auto-detects message flattening requirements based on model information. • Extends the sandboxed Python interpreter to support non-bool comparison operators (e.g., returning non-boolean values from comparisons). • Plan user prompt moved to YAML, making plan prompt customization accessible via configuration. https://github.com/huggingface/smolagents/releases/tag/v1.8.0 https://github.com/huggingface/smolagents/releases/tag/v1.8.0 Fri, 07 Feb 2025 15:02:10 GMT smolagents v1.8.0 adds agent tree visualization, simplified managed agents via name/description attributes, and Open Deep Research. • Agents now accept `name` and `description` attributes directly to function as managed agents, replacing the removed `ManagedAgents` class. • New visualization method to display an agent's structure as a tree. • Releases Open Deep Research as a built-in example/capability. Breaking changes: • The `ManagedAgents` class has been removed; agents must now be configured as managed agents by setting `name` and `description` attributes directly on the agent object. • The `prompts_path` argument has been deleted; use `prompt_templates` instead. https://github.com/huggingface/smolagents/releases/tag/v1.7.0 https://github.com/huggingface/smolagents/releases/tag/v1.7.0 Fri, 31 Jan 2025 13:05:14 GMT smolagents v1.7.0 adds `smolagent` and `webagent` CLI commands, a persistent `memory` attribute, and an agent.replay() function. • Adds `smolagent` CLI command to run agents directly from the terminal (e.g. `smolagent "Your task!"`). • Adds `webagent` CLI command to launch a web browser agent from the terminal (e.g. `webagent "Find me a cheap train from Paris to Torino before Thursday"`). • Adds a `memory` attribute to agents for persistent storage of run history across steps. • Adds agent.replay() method to replay the last agent run from stored memories without making additional LLM calls. • Code execution outputs are now stored to memory even when an error is raised later, improving `CodeAgent` performance. • Supports third-party inference providers in `HfApiModel`. https://github.com/huggingface/smolagents/releases/tag/v1.6.0 https://github.com/huggingface/smolagents/releases/tag/v1.6.0 Tue, 28 Jan 2025 10:46:27 GMT smolagents v1.6.0 adds VLM auto-detection, DuckDuckGo kwargs, richer Gradio chatbot metrics, and makes transformers an optional dependency. • Adds `ddgs_kwargs` parameter to the `DuckDuckGoSearchTool` constructor, allowing callers to pass arbitrary keyword arguments to the underlying DDGS client. • Adds additional parameters support for the OpenAI client integration. • Adds kwargs passthrough to `gradio launch`, enabling full control over Gradio server startup options. • `TransformersModel` now auto-detects Vision-Language Models (VLMs), removing the need for manual configuration when loading a VLM. • Makes `transformers` an optional dependency, reducing the mandatory install footprint for users who do not need local transformer inference. • Gradio chatbot now displays step duration, step number, and token counts, and supports rendering nested thoughts. https://github.com/huggingface/smolagents/releases/tag/v1.5.0 https://github.com/huggingface/smolagents/releases/tag/v1.5.0 Fri, 24 Jan 2025 16:22:43 GMT smolagents v1.5.0 adds VLM support, Azure OpenAI integration, and tightened local interpreter security • Adds Azure OpenAI support as a model backend. • Adds VLM (vision-language model) support, enabling agents to process image inputs. • Hardens local interpreter security: builtin functions are now blocked unless explicitly added as tools. • Supports `any` and `none` tool types in tool call handling. https://github.com/huggingface/smolagents/releases/tag/v1.4.1 https://github.com/huggingface/smolagents/releases/tag/v1.4.1 Fri, 17 Jan 2025 20:00:35 GMT smolagents v1.4.1 adds MCP server support via ToolCollection, kwargs passthrough to all models, and new TransformersModel options. • Adds `trust_remote_code` argument to `TransformersModel` for loading custom model code from remote repositories. • Adds MCP (Model Context Protocol) server support via `ToolCollection`, making thousands of MCP-compatible tools usable with smolagents. • Allows passing arbitrary kwargs to all model classes, enabling fine-grained control over inference parameters at call time. • Makes the `openai` package an optional dependency, reducing mandatory install footprint. • Adds a max-length parameter for `print` outputs as an agent-level setting to cap verbose tool output. • Adds a resizable option to the Gradio UI component for improved usability. https://github.com/huggingface/smolagents/releases/tag/v1.3.0 https://github.com/huggingface/smolagents/releases/tag/v1.3.0 Wed, 15 Jan 2025 16:30:32 GMT smolagents v1.3.0 adds OpenTelemetry tracing, multi-GPU support, wildcard imports, and granular verbosity control. • Adds `verbosity_level=0/1/2` parameter to agent initialization, replacing the old `verbose=True/False` boolean for finer-grained log control. • Enables unrestricted code-sandbox imports via `additional_authorized_imports=['*']` on agent initialization. • Adds OpenTelemetry instrumentation support for tracing and inspecting agent runs. • Adds multi-GPU support for `TransformersModel`. • Adds file upload capability to `GradioUI`. Breaking changes: • The `verbose=True/False` agent initialization parameter is replaced by `verbosity_level=0/1/2`; existing code using `verbose=` will need to be updated. https://github.com/huggingface/smolagents/releases/tag/v1.2.0 https://github.com/huggingface/smolagents/releases/tag/v1.2.0 Fri, 10 Jan 2025 15:30:59 GMT smolagents v1.2.0 adds OpenAIServerModel, OpenTelemetry observability, Hugging Chat integration, and halves import time by dropping torch. • Adds `OpenAIServerModel` class, enabling use of any OpenAI-format-compatible inference server (TGI, vLLM, etc.) as a model backend. • Simplifies the `Model` base class to a single `__call__` method: passing `tools_to_call_from` returns a tool call; omitting it returns a plain string. • Adds OpenTelemetry support for agent observability and tracing. • Integrates `smolagents` tools into Hugging Chat, enabling agent tool use directly from the chat interface. • Halves library import time by removing the `torch` dependency. https://github.com/huggingface/smolagents/releases/tag/v1.1.0 https://github.com/huggingface/smolagents/releases/tag/v1.1.0 Mon, 06 Jan 2025 22:19:25 GMT smolagents v1.1.0 adds `max_results` to DDGS tool, `device` param for TransformerModel, and broader LiteLLMModel kwargs support. • Adds `max_results` keyword argument to the DDGS (DuckDuckGo Search) tool to control the number of results returned. • Adds `device` parameter to `TransformerModel` in `models.py` for explicit device placement. • Adds support for additional keyword arguments (kwargs) in `LiteLLMModel`, enabling pass-through of provider-specific options. • Adds a warning to `CodeAgent` when required imports are missing at runtime. Breaking changes: • The `max_iterations` argument to agent initialization is renamed to `max_steps`; any code constructing an agent with `max_iterations=...` will break.