Releases · huggingface/smolagents (original) (raw)

v1.24.0

What's Changed

Bump version to 1.24 by @aymeric-roucher in #1871
Fix: Add backward compatibility for deprecated HfApiModel by @MohammadKassas143 in #1863
Fix typo in secure_code_execution.md by @jonathanagustin in #1892
Update no-stop-sequence model list to support gpt-5.2* by @aymeric-roucher in #1895
Fix run_gaia.py token_counts when managed agent is called more than once by @suryabdev in #1878
🌐 [i18n-KO] Translated tools.md to Korean by @Kim-Ju-won in #1835
Support passing additional params to apply_chat_template by @albertvillanova in #1902
fix(gradio_ui): Gradio 6 compatibility by @alejandro-ao in #1903
Coerce tool calls from APIs into smolagents ChatMessageToolCall format by @aymeric-roucher in #1900
Add FinalAnswerStep to possible step_callbacks by @suryabdev in #1881
Upgrade GitHub Actions for Node 24 compatibility by @salmanmkc in #1909
fix: prevent FinalAnswerException from being caught by except Exception by @majiayu000 in #1914
Add DeepWiki badge to README by @aymeric-roucher in #1846
Implement robust timeout mechanism for Python execution by @albertvillanova in #1910

New Contributors

@MohammadKassas143 made their first contribution in #1863
@jonathanagustin made their first contribution in #1892
@alejandro-ao made their first contribution in #1903
@salmanmkc made their first contribution in #1909
@majiayu000 made their first contribution in #1914

Full Changelog: v1.23.0...v1.24.0

v1.23.0

Improvements ✨

Update final answer checks to accept the agent instance by @Zoe14 in #1648
Dialog mode CLI by @aymeric-roucher in #1540
Add Blaxel support for remote code execution by @Joffref in #1791
Proposition: Add exponential backoff with jitter for retries by @suryabdev in #1829
Cut generation at stop sequence post generation by @aymeric-roucher in #1802
Move executor type validation to python executor creation by @Lrakotoson in #1800
Support custom Python code executor in CodeAgent by @albertvillanova in #1707
Retry on rate limit errors by @aymeric-roucher in #1801
Change default InferenceClient model to Qwen/Qwen3-Next-80B-A3B-Thinking by @suryabdev in #1813
Remove 'Server' from model names in doc by @aymeric-roucher in #1812
Optimize comprehension evaluation with generator-based approach in LocalPythonExecutor by @albertvillanova in #1824
LocalPythonExecutor: Add support for nested dictcomp and setcomp by @suryabdev in #1823
Support parsing anyOf from MCP tools by @duguyue100 in #1708
Add Modal as sandbox option to docs front page by @sandcat100 in #1865
make additional_args nullable for managed agents by @nflo in #1827
vLLM: Move from guided_options_request to structured_outputs by @suryabdev in #1805

Fixes 🛠️

Fix agent logs: logging "None" and simplify the logic by @albertvillanova in #1788
Fix dict(message) bug in AgentMemory.replay for ChatMessage objects by @Flakes342 in #1763
Fix LocalPythonExecutor support for Enum and other metaclasses by @colesmcintosh in #1797
Handle None content in stop-sequence trimming by @chahn in #1826
Fix minor benchmark script bugs by @suryabdev in #1822
Fix YAML scanner error when building documentation by @albertvillanova in #1841
Pin huggingface-hub <1.0.0 to fix failed to build tokenizers by @albertvillanova in #1844
Fixed SyntaxError format: keep exception type and message on same line (#835) by @balazsthomay in #1864
Fix CLI Tool.from_space() call by auto-generating name and description (#1535) by @balazsthomay in #1859
Add gpt-5.1 support by @suryabdev in #1868
bug: role not converted back to enum by @njbrake in #1833
Parallel tool calls lose OpenTelemetry context: tool spans not nested under agent step by @Barcavin in #1840

Documentation 📚

Bump dev version: v1.23.0.dev0 by @albertvillanova in #1787
🌐 [i18n-KO] Translated memory.md to Korean by @HyunZ118 in #1793
🌐 [i18n-KO] Translated using_different_models.md to Korean by @FacerAin in #1772
🌐 [i18n-KO] Translated guided_tour.md to Korean by @FacerAin in #1711
🌐 [i18n-KO] Translated async_agent.md to Korean by @FacerAin in #1749
🌐 [i18n-KO] Translated agents.md to Korean by @Kim-Ju-won in #1720
🌐 [i18n-KO] Translated rag.md to Korean by @Kim-Ju-won in #1646
Documentation: Minor fixes by @suryabdev in #1809
🌐 [i18n-KO] Translated web_browser.md to Korean by @FacerAin in #1748
[i18n-es] Translating docs to spanish by @1-echo in #1806
🌐 [i18n-KO] Translated plan_customization.md to Korean by @FacerAin in #1771
🌐 [i18n-KO] Translated inspect_runs.md to Korean by @FacerAin in #1747
Build PR documentation for all languages by @albertvillanova in #1842

Full Changelog: v1.22.0...v1.23.0

v1.22.0

What's Changed

Bump dev version: v1.22.0.dev0 by @albertvillanova in #1657
refactor(PythonExecutor): inherit from ABC and declare abstract methods by @HairlessVillager in #1654
Fix error for GPT-5 not supporting the stop parameter by @Xmader in #1662
Enable return_full_result directly in run method by @aymeric-roucher in #1658
Make RunResult json serializable by @aymeric-roucher in #1659
Change truncation to remove end rather than middle by @aymeric-roucher in #1665
Document that model kwargs are forwarded to model completion call by @albertvillanova in #1679
Fix missing kwargs forward to vLLM model generate call by @albertvillanova in #1680
Raise RuntimeError with LiteLLM response details if no choices by @albertvillanova in #1683
Fix AmazonBedrockModel with reasoning/thinking content by @albertvillanova in #1681
Fix installation command in README by quoting extra by @shahgahmed in #1685
CI hotfix: Pin openai < 1.100.0 for litellm extra by @albertvillanova in #1693
Support openai 1.100 for litellm extra by @albertvillanova in #1698
Pin telemetry extra >=0.1.15 to use new TokenUsage structure by @albertvillanova in #1699
Add AGENTS.md by @albertvillanova in #1701
Test telemetry extra by @albertvillanova in #1700
Replace slim with bullseye base image in Docker executor by @albertvillanova in #1702
fix: error missing f-string by @njbrake in #1691
Support custom Dockerfile in DockerExecutor by @albertvillanova in #1705
Support MCP structured output and output schema by @chahn in #1663
Improve agent image handling by @aaron-ang in #1601
🌐 [i18n-KO] Translated multiagents.md to Korean by @pyapyapya in #1644
Fix CI 403 error for Wikipedia page in test_visit_webpage by @albertvillanova in #1716
fix typos in the system prompt by @Frame17 in #1710
Fix pip install commands by quoting extras by @albertvillanova in #1690
Fix deprecation warning about parameter messages by @albertvillanova in #1718
Fix warning about parameter max_new_tokens by @albertvillanova in #1721
Adds Modal Remote Executor by @thomasjpfan in #1722
Fix formatting of title in translation section of documentation by @albertvillanova in #1727
Remove untranslated sections from the documentation by @albertvillanova in #1729
fix: add ipykernel in dockerfile of prebuilt docker executor by @cyyeh in #1731
Fix E2BExecutor by pinning e2b-code-interpreter to < 2 by @albertvillanova in #1733
Fix DockerExecutor connection reset error with server readiness check by @benoriol in #1684
[i18n-KO] Translated building_good_agents.md to Korean by @FacerAin in #1714
🌐 [i18n-KO] Translated installation.md to Korean by @FacerAin in #1647
Support e2b-code-interpreter v2 by @August-murr in #1751
Fix token count initialization when plan_message.token_usage is None by @satwikkansal in #1752
Support user-configurable parameter override for model completion parameters by @albertvillanova in #1678
Fix error for grok-4/grok-3-mini not supporting the stop parameter by @suryabdev in #1766
Replace DockerExecutor Dockerfile with file object by @albertvillanova in #1738
Update documentation to clarify instructions are appended by @chahn in #1709
🌐 [i18n-KO] Translated react.md to Korean by @NSBG in #1666
Pass tools_to_call_from to TransformersModel._prepare_completion_kwargs by @albertvillanova in #1782
🌐 [i18n-KO] Translated models.md to Korean by @Kim-Ju-won in #1776
Fix AttributeError when trying to log a None by @albertvillanova in #1786
fix(agent): remove unused get_variable_names function by @keli-wen in #1784
Fix XPath injection in search_item_ctrl_f by @albertvillanova in #1768
Use context manager for per-operation websocket connection in DockerExecutor by @albertvillanova in #1750

New Contributors

@Xmader made their first contribution in #1662
@shahgahmed made their first contribution in #1685
@aaron-ang made their first contribution in #1601
@pyapyapya made their first contribution in #1644
@Frame17 made their first contribution in #1710
@cyyeh made their first contribution in #1731
@satwikkansal made their first contribution in #1752
@suryabdev made their first contribution in #1766
@Kim-Ju-won made their first contribution in #1776
@keli-wen made their first contribution in #1784

Full Changelog: v1.21.3...v1.22.0

v1.21.3

v1.21.2

v1.21.1

v1.21.0

Enhancements ✨

Tool & Model Improvements
- Add Tool to_code_prompt and to_tool_calling_prompt by @albertvillanova in #1599
- Improve function body extraction in tools by @HairlessVillager in #1627
- Support passing model_kwargs to TransformersModel by @albertvillanova in #1608
- Support dict messages as direct input to models by @albertvillanova in #1570
Executor Improvements
- Enhance LocalPythonExecutor security by blocking dunder calls by @nnfrog in #1551
- Fix continue semantics of LocalPythonExecutorby @adaminsky in #1645
- Fix GeneratorExp in LocalPythonExecutor to return Generator instead of list by @albertvillanova in #1650
Gradio & UI
- Reset agent memory on GradioUI clear button by @albertvillanova in #1611
- Use gr.Number for mapping integer and number type components in launch_gradio_demo by @karenwky in #1320

Bug Fixes 🐛

Fix: Prevent empty additional_args from being added to agent prompt by @jokokojote in #1566
Fix SyntaxError in generated Gradio app due to 'class' attribute by @albertvillanova in #1615
Fix serialization inconsistency in MultiStepAgent.to_dict/from_dict for managed_agents by @hazrmard in #1577
Fix a kwargs error in LocalPythonExecutor by @aymeric-roucher in #1583
Fix structured outputs by @MicrosoftJames in #1642
Fix bug where AmazonBedrockServerModel crashes in thinking mode by @benoriol in #1632
Fix: Remove duplicate line in tool_calling_agent prompt by @yusuf-eren in #1636
Fix: RemotePythonExecutor should not send variables if none exist by @thomasjpfan in #1605
Disable parallel tool calls for final answer by @aymeric-roucher in #1539

Documentation 📚

Improve Installation docs with uv option by @albertvillanova in #1550
Fix and improve MCP server security warnings in docs by @albertvillanova in #1549
DOC: Fix image link for docs (secure_code_execution.md) by @FacerAin in #1582
Update title of page "What are agents" by @aymeric-roucher in #1546
Enable multilingual docs by @albertvillanova in #1633
🌐 [i18n-KO] Translated index.md to Korean by @FacerAin in #1581
🌐 [i18n-KO] Translated text_to_sql.md to Korean by @NSBG in #1603

CI / Dependency Updates 🧪

Pin mcpadapt to support image/audio content by @albertvillanova in #1558
Temporarily skip wrongly implemented tests by @albertvillanova in #1571
CI hotfix: Pin mlx < 0.26.5 by @albertvillanova in #1586
Support mlx-0.26.5 by @albertvillanova in #1589
CI hotfix: Pin transformers < 4.54.0 by @albertvillanova in #1620
Support transformers 4.54.0 by @albertvillanova in #1625
Fix CI PytestUnknownMarkWarning: Unknown pytest.mark.timeout by @albertvillanova in #1630
Fix CI quality: remove trailing whitespace by @albertvillanova in #1617

Deprecations & Cleanups 🧹

Replace deprecated ast.Num and ast.Str with ast.Constant in tool validation by @WilliamRabuel in #1594
Remove deprecated grammar parameter by @albertvillanova in #1651
Remove deprecated token count attributes by @albertvillanova in #1652
Remove deprecated agent logs attribute by @albertvillanova in #1653
Remove mention of deprecated ManagedAgent from docs by @albertvillanova in #1655
Remove deprecated default sse transport by @albertvillanova in #1656
Replace duckduckgo_search with ddgs to address package rename warning by @WilliamRabuel in #1593
Remove unused is_same_item function by @albertvillanova in #1631
Remove unnecessary import by @rahul-1729 in #1639
Simplify _is_package_available by @albertvillanova in #1641

Miscellaneous 🔧

Add support for Amazon Bedrock API Keys by @colesmcintosh in #1612
Factorize create_agent_gradio_app_template function by @albertvillanova in #1616
Fix: Allow passing integers for floats by @aymeric-roucher in #1623
Fix Tool.forward to raise NotImplementedError instead of returning by @HairlessVillager in #1628
Make validate_tool_arguments raise instead of returning error string by @albertvillanova in #1634
Remove mention of python in additional args by @aymeric-roucher in #1584
ToolCallingAgent: remove unnecessary addition to model_output by @aymeric-roucher in #1622
Minor fix in toolCallingAgentPrompt by @rahul-1729 in #1574

Maintenance 🏗️

Bump dev version: v1.21.0.dev0 by @albertvillanova in #1544
Remove empty issue template by @albertvillanova in #1562
Improve issue templates by @albertvillanova in #1563
Add issue template for documentation improvements by @albertvillanova in #1564
Add uv option to CONTRIBUTING by @albertvillanova in #1561

New Contributors

@jokokojote made their first contribution in #1566
@rahul-1729 made their first contribution in #1574
@WilliamRabuel made their first contribution in #1594
@FacerAin made their first contribution in #1582
@thomasjpfan made their first contribution in #1605
@hazrmard made their first contribution in #1577
@HairlessVillager made their first contribution in #1628
@benoriol made their first contribution in #1632
@yusuf-eren made their first contribution in #1636
@nnfrog made their first contribution in #1551
@NSBG made their first contribution in #1603
@karenwky made their first contribution in #1320
@MicrosoftJames made their first contribution in #1642
@adaminsky made their first contribution in #1645

Full Changelog: v1.20.0...v1.21.0

v1.20.0

New Features ✨

Remote Execution:
- Implement remote Python WasmExecutor by @albertvillanova in #1261
Callbacks:
- Support callbacks after planning step by @albertvillanova in #1445
- Support multiple callbacks per step type in step_callbacks dict by @albertvillanova in #1517

Enhancements 🛠️

Models:
- Implement rate limiting in all API models by @albertvillanova in #1516
Tools:
- Implement exception mechanism for final answer in remote executors by @tobiasofsn in #1429
- Set default api_key_name in ApiWebSearchTool by @albertvillanova in #1507
- Implement rate limit mechanism in ApiWebSearchTool by @albertvillanova in #1508
- Implement rate limit mechanism in DuckDuckGoSearchTool by @albertvillanova in #1515
- Enable image output for Tool.from_space by @aymeric-roucher in #1510
- Add adapter_kwargs parameter to MCPClient by @LucasDltg in #1528
Validation of Tool Arguments:
- Support multiple types in tool arguments validation by @duguyue100 in #1505
- Fix input type validation when input schema has multiple types by @duguyue100 in #1530
- Fix optional args toolcalling by @aymeric-roucher in #1538
Agent Output Formatting:
- Implement CodeOutput as analog to ToolOutput by @albertvillanova in #1496
- Allow markdown or custom formatting for code blocks by @aymeric-roucher in #1493
Other:
- Add ApiWebSearchTool to all list by @albertvillanova in #1492
- Enforced type annotations in ChatMessage via MessageRole enum by @daavoo in #1479
- Check authorized imports in LocalPythonExecutor constructor by @jank in #265

Bug Fixes 🐛

Fix KeyError when agent reaches max steps with image input by @robin-ede in #1525
Fix when response.usage is None for some OpenRouter models by @sentienthouseplant in #1402
Fix incorrect token counting in streaming TransformersModel by @albertvillanova in #1503
Minor fix nested quotes that prevent execution by @vinoo-ganesh-keru in #1497
Fix ChatMessage attribute access after replacing dict with dataclass by @albertvillanova in #1534
Fix access of content field in ChatMessage by @mdr223 in #1533
Fix parallel final answers handling by @aymeric-roucher in #1482

Documentation Improvements 📚

Examples & Tutorials:
- Add complete Plan Customization example by @albertvillanova in #1506
- Add Async App with Agent example by @albertvillanova in #1509
- Improve Plan Customization example with Human-in-the-Loop by @albertvillanova in #1513
API References:
- Fix docstring of WikipediaSearchTool by @albertvillanova in #1521
- Explain rate_limit in tools docstrings by @albertvillanova in #1519
- Fix Examples in AmazonBedrockServerModel docstring by @albertvillanova in #1522
- Split Built-in Tools from Tools in Reference docs by @albertvillanova in #1520
Other:
- Update Langfuse tracing documentation to SDK v3 by @jannikmaierhoefer in #1447
- Fix use of context manager agent in docs by @albertvillanova in #1502

Maintenance 🏗️

Fix CI LiteLLM test_call_different_providers_without_key by @albertvillanova in #1527
Fix test_send_tools_with_default_wikipedia_search_tool by @albertvillanova in #1494
Fix DockerExecutor tests with final_answer by calling send_tools by @albertvillanova in #1495
Bump dev version: v1.20.0.dev0 by @albertvillanova in #1477

New Contributors

@sentienthouseplant made their first contribution in #1402
@daavoo made their first contribution in #1479
@duguyue100 made their first contribution in #1505
@vinoo-ganesh-keru made their first contribution in #1497
@robin-ede made their first contribution in #1525
@LucasDltg made their first contribution in #1528
@mdr223 made their first contribution in #1533

Full Changelog: v1.19.0...v1.20.0

v1.19.0

Enhancements 🛠️

Agent Upgrades:
- Support managed agents in ToolCallingAgent by @albertvillanova in #1456
- Support context managers for agent cleanup by @tobiasofsn in #1422
- Change code tags to xml by @aymeric-roucher in #1442
UI Improvements:
- Support reset_agent_memory in GradioUI by @JakeBx in #1420
Streaming Refactor:
- Transfer aggregation of streaming events off the Model class by @aymeric-roucher in #1449
Agent Output Tracking:
- Store CodeAgent code outputs in ActionStep by @aymeric-roucher in #1463

Bug Fixes 🐛

Fix Agent update planning logic by @Zoe14 in #1417
Remove plural from named argument return_full_results in examples by @vladlen32230 in #1434
Fix and refactor final answer checks by @aymeric-roucher in #1448
Fix logging of Docker build logs by @tobiasofsn in #1421
Add a mention of additional_args in the manager agent's prompt by @aymeric-roucher in #1441
Fix missing mentions of additional_args in manager agent prompts by @albertvillanova in #1459
Fix: __new__ method only accepts class object, remove **args and **kw… by @abdulhakkeempa in #1462
Do not wrap types in safer_func by @albertvillanova in #1475
Match multiline final answers in remote executors by @albertvillanova in #1444
Revert removal of the last message from memory_messages during planning by @Zoe14 in #1454

Documentation Improvements 📚

Quickstart Enhancements:
- Add simple tool usage in doc quickstart by @aymeric-roucher in #1470
- Add open-colab link to Quickstart docs by @albertvillanova in #1472
Reference Docs:
- Add AgentMemory to Reference docs by @albertvillanova in #1473
- Add docstrings to GradioUI by @albertvillanova in #1451
Fixes & Formatting:
- Correct broken link in documentation homepage by @johntony366 in #1468
- Rename docs files from .mdx to .md by @albertvillanova in #1471

Maintenance 🏗️

Bump dev version: v1.19.0.dev0 by @albertvillanova in #1427

New Contributors

@Zoe14 made their first contribution in #1417
@vladlen32230 made their first contribution in #1434
@JakeBx made their first contribution in #1420
@abdulhakkeempa made their first contribution in #1462
@johntony366 made their first contribution in #1468

Full Changelog: v1.18.0...v1.19.0

v1.18.0

New Features ✨

Multiple Parallel Tool Calls: ToolCallingAgent can now handle multiple tool calls in parallel, significantly enhancing performance for complex tasks.
- Support multiple tool calls in parallel in ToolCallingAgent by @albertvillanova in #1412
Streaming Output for ToolCallingAgent: ToolCallingAgent now supports streaming outputs, improving responsiveness and user experience during multi-step tool interactions
- Streaming outputs for ToolCallingAgent 🚀 by @aymeric-roucher in #1409
API Web Search Tool: Introduced a new ApiWebSearchTool, enabling structured web search capabilities via API.
- Create API web search tool by @albertvillanova in #1400

Enhancements 🛠️

Update prompts to avoid confusion: search -> web_search and wiki -> wiki_search by @SrzStephen in #1403
Make Agent.system_prompt read only by @albertvillanova in #1399
Support configurable tool_choice in prepare_completion_kwargs by @albertvillanova in #1392
Support passing additional params to MLXModel load and tokenizer.apply_chat_template by @albertvillanova in #1406
Support custom headers/params for ApiWebSearchTool by @albertvillanova in #1411

Bug Fixes 🐛

Fix: Support custom inputs execution for custom Final Answer Tool by @Lrakotoson in #1383
Fix @tool decorator for remote Python executor by @tobiasofsn in #1334
Always pass add_generation_prompt=True to apply_chat_template by @albertvillanova in #1416

Documentation Improvements 📚

Make docs neutral about agent types by @julien-c in #1376
Add MCP tools doc section by @aymeric-roucher in #1394
Update ToolCollection.from_mcp docstring examples by @neonwatty in #1398
Document better final_answer_checks by @albertvillanova in #1407
Fix typo in secure code execution documentation by @chahn in #1414
Add chat server demo to examples by @albertvillanova in #1415
Fix VLM model in web_browser example docs by @albertvillanova in #1424
Fix ValueError on Guided Tour docs by @albertvillanova in #1425
Explain agent types better in Guided tour docs by @albertvillanova in #1426
Add Quickstart page to docs by @albertvillanova in #1413

Maintenance 🏗️

Bump dev version: v1.18.0.dev0 by @albertvillanova in #1390

New Contributors

@Lrakotoson made their first contribution in #1383
@neonwatty made their first contribution in #1398
@SrzStephen made their first contribution in #1403
@chahn made their first contribution in #1414

Full Changelog: v1.17.0...v1.18.0