Smolagents

What's Changed

New Features 🚀
* Add VLM support by merveenoyan in https://github.com/huggingface/smolagents/pull/220

Fixes 🐛
* refactor: update model type to ChatMessage in agent classes by jank in https://github.com/huggingface/smolagents/pull/263
* Fixes AttributeError: 'CodeAgent' object has no attribute 'logger' 258 by joaopauloschuler in https://github.com/huggingface/smolagents/pull/259
* Improve tool call argument parsing by aymeric-roucher in https://github.com/huggingface/smolagents/pull/267
* Remove unused and undocumented `test_mode` parameter by Wauplin in https://github.com/huggingface/smolagents/pull/273
* Fix Bug in from_langchain in tools.py by RolandJAAI in https://github.com/huggingface/smolagents/pull/268
* Python interpreter: improve suggestions for possible mappings by aymeric-roucher in https://github.com/huggingface/smolagents/pull/266
* Improve python executor's error logging by aymeric-roucher in https://github.com/huggingface/smolagents/pull/275
* The use of BASE_PYTHON_TOOLS enables the use of compile, exec and eval by tandiapa in https://github.com/huggingface/smolagents/pull/274
* Try first dunder method in evaluate_augassign by albertvillanova in https://github.com/huggingface/smolagents/pull/285
* Add cool GIF of agent run inspection using Phoenix by aymeric-roucher in https://github.com/huggingface/smolagents/pull/277
* Remove pickle5 package from E2BExecutor by albertvillanova in https://github.com/huggingface/smolagents/pull/295
* Fuse stream and direct run calls by clefourrier in https://github.com/huggingface/smolagents/pull/296
* minor fix for console in AgentLogger by nbroad1881 in https://github.com/huggingface/smolagents/pull/303
* Add Azure OpenAI support by vladiliescu in https://github.com/huggingface/smolagents/pull/282
* Fix arg passing to AgentExecutionError by albertvillanova in https://github.com/huggingface/smolagents/pull/309
* refactor(models): restructure model parameter handling by kingdomad in https://github.com/huggingface/smolagents/pull/227
* Local interpreter security: prevent builtins functions from being used if they have not been added as tools by tandiapa in https://github.com/huggingface/smolagents/pull/299
* Support any and none tool types by aymeric-roucher in https://github.com/huggingface/smolagents/pull/280
* Minor fix: adding a 60 seconds timeout to the visit webpage tool by Killian-pit in https://github.com/huggingface/smolagents/pull/308
* Fix: source code inspection in interactive shells by antoinejeannot in https://github.com/huggingface/smolagents/pull/281
* Refactor evaluate_augassign and test all operators by albertvillanova in https://github.com/huggingface/smolagents/pull/313
* Unset temperature in models by aymeric-roucher in https://github.com/huggingface/smolagents/pull/315
* Fix tool calls with LiteLLM and tool optional types by aymeric-roucher in https://github.com/huggingface/smolagents/pull/318
* Multiple tool example by touseefahmed96 in https://github.com/huggingface/smolagents/pull/293
* RAG on your huggingface_doc data using chromadb and groq api by touseefahmed96 in https://github.com/huggingface/smolagents/pull/235
* Improve static tools initialization safety by kingdomad in https://github.com/huggingface/smolagents/pull/324
* Append unused error message to memory by albertvillanova in https://github.com/huggingface/smolagents/pull/325

Documentation and examples 📚
* Fix code examples with additional_args and num_ctx examples also in zh docs by RolandJAAI in https://github.com/huggingface/smolagents/pull/260
* Update building_good_agents.md by derekalia in https://github.com/huggingface/smolagents/pull/283
* Update guided_tour.md by sanjeed5 in https://github.com/huggingface/smolagents/pull/287
* Added Hindi docs for smolagents by keetrap in https://github.com/huggingface/smolagents/pull/279
* Update README and documentation to clarify Hub integrations with Gradio Spaces by davidberenstein1957 in https://github.com/huggingface/smolagents/pull/306
* Update README.md fix quick demo code import bug by Deng-Xian-Sheng in https://github.com/huggingface/smolagents/pull/327
* Add args to MultiStepAgent docstring by albertvillanova in https://github.com/huggingface/smolagents/pull/332
* Fix MultiStepAgent docstring by albertvillanova in https://github.com/huggingface/smolagents/pull/336
* Fix docstrings of models by albertvillanova in https://github.com/huggingface/smolagents/pull/344
* docstring args for ToolCallingAgent, CodeAgent and ManagedAgent by touseefahmed96 in https://github.com/huggingface/smolagents/pull/335
* Corrected tool examples in ToolCallingAgent system prompts by RolandJAAI in https://github.com/huggingface/smolagents/pull/341
* Improve inference choice examples by aymeric-roucher in https://github.com/huggingface/smolagents/pull/311

Maintenance 🏗️
* Add linter rules + apply make style by Wauplin in https://github.com/huggingface/smolagents/pull/255
* Fix CI quality issue by albertvillanova in https://github.com/huggingface/smolagents/pull/272
* Bump version to 1.5.0.dev by aymeric-roucher in https://github.com/huggingface/smolagents/pull/256
* Make import time faster (optional deps + delay imports) by Wauplin in https://github.com/huggingface/smolagents/pull/253
* Fix CI quality by albertvillanova in https://github.com/huggingface/smolagents/pull/286
* Add huggingface-hub as required dependency by albertvillanova in https://github.com/huggingface/smolagents/pull/288
* Make e2b optional dependency by albertvillanova in https://github.com/huggingface/smolagents/pull/292
* Remove package json files by albertvillanova in https://github.com/huggingface/smolagents/pull/314
* Update README instructions to run tests by albertvillanova in https://github.com/huggingface/smolagents/pull/328
* Move torchvision to the torch extra by nonsleepr in https://github.com/huggingface/smolagents/pull/297

New Contributors
* tandiapa made their first contribution in https://github.com/huggingface/smolagents/pull/274
* keetrap made their first contribution in https://github.com/huggingface/smolagents/pull/279
* sanjeed5 made their first contribution in https://github.com/huggingface/smolagents/pull/287
* davidberenstein1957 made their first contribution in https://github.com/huggingface/smolagents/pull/306
* clefourrier made their first contribution in https://github.com/huggingface/smolagents/pull/296
* nbroad1881 made their first contribution in https://github.com/huggingface/smolagents/pull/303
* vladiliescu made their first contribution in https://github.com/huggingface/smolagents/pull/282
* Killian-pit made their first contribution in https://github.com/huggingface/smolagents/pull/308
* antoinejeannot made their first contribution in https://github.com/huggingface/smolagents/pull/281
* touseefahmed96 made their first contribution in https://github.com/huggingface/smolagents/pull/293
* Deng-Xian-Sheng made their first contribution in https://github.com/huggingface/smolagents/pull/327
* nonsleepr made their first contribution in https://github.com/huggingface/smolagents/pull/297
* merveenoyan made their first contribution in https://github.com/huggingface/smolagents/pull/220

**Full Changelog**: https://github.com/huggingface/smolagents/compare/v1.4.1...v1.5.0

What's Changed

New features 🚀
* Add support for MCP Servers tools as `ToolCollection` by grll in https://github.com/huggingface/smolagents/pull/232
- This enables using Model Context Protocol (MCP) servers, thus makes many, many tools compatible with `smolagents`: find a list on [glama.ai](https://glama.ai/mcp/servers?attributes=) or [smithery.ai](https://smithery.ai/) ✨
* Allow passing kwargs to all models by aymeric-roucher in https://github.com/huggingface/smolagents/pull/222
* Add Chinese translations for multi-agent example by FanwangM in https://github.com/huggingface/smolagents/pull/246

Fixes 🐛
* Fix subpackage import vulnerability by aymeric-roucher in https://github.com/huggingface/smolagents/pull/238
* Fix typo in building_good_agents.md by rug in https://github.com/huggingface/smolagents/pull/193
* Align data types in example benchmark by albertvillanova in https://github.com/huggingface/smolagents/pull/205
* Rename the split of the benchmark dataset from train to test by albertvillanova in https://github.com/huggingface/smolagents/pull/216
* Fix vanilla model answer in example benchmark by albertvillanova in https://github.com/huggingface/smolagents/pull/219
* Fix additional args in stream_to_gradio by aymeric-roucher in https://github.com/huggingface/smolagents/pull/221
* Return textboxes on Gradio file upload errors by stackviolator in https://github.com/huggingface/smolagents/pull/214
* Docs Bug - fix tool example with additional args by RolandJAAI in https://github.com/huggingface/smolagents/pull/228
* Dead Link to Duck Duck Go search tool by matterattetatte in https://github.com/huggingface/smolagents/pull/233
* Fix missing python modules in CodeAgent system prompt by edbeeching in https://github.com/huggingface/smolagents/pull/226

Adjustments 🔧
* Clean makefile, pyproject.toml and CI by Wauplin in https://github.com/huggingface/smolagents/pull/229
* Add resizeable option to Gradio UI component for better usabilty by jank in https://github.com/huggingface/smolagents/pull/234
* Add trust_remote_code arg to TransformersModel by aymeric-roucher in https://github.com/huggingface/smolagents/pull/240
* Make openai dependency optional by albertvillanova in https://github.com/huggingface/smolagents/pull/236
* Remove dependency on _is_package_available from transformers by albertvillanova in https://github.com/huggingface/smolagents/pull/247
* Update README.md by aymeric-roucher in https://github.com/huggingface/smolagents/pull/208
* Set ollama context length in example to 8192 to make it work by RolandJAAI in https://github.com/huggingface/smolagents/pull/252
* chore: unset console width, utilize auto detect feature by simpletrontdip in https://github.com/huggingface/smolagents/pull/196
* Max length of "print" outputs as a parameter of an agent by IlyaGusev in https://github.com/huggingface/smolagents/pull/209
* Small fixes in docs by MoritzLaurer in https://github.com/huggingface/smolagents/pull/245
* Fixes before release by aymeric-roucher in https://github.com/huggingface/smolagents/pull/254

New Contributors
* rug made their first contribution in https://github.com/huggingface/smolagents/pull/193
* RolandJAAI made their first contribution in https://github.com/huggingface/smolagents/pull/228
* matterattetatte made their first contribution in https://github.com/huggingface/smolagents/pull/233
* jank made their first contribution in https://github.com/huggingface/smolagents/pull/234
* edbeeching made their first contribution in https://github.com/huggingface/smolagents/pull/226
* Wauplin made their first contribution in https://github.com/huggingface/smolagents/pull/229
* FanwangM made their first contribution in https://github.com/huggingface/smolagents/pull/246
* simpletrontdip made their first contribution in https://github.com/huggingface/smolagents/pull/196
* MoritzLaurer made their first contribution in https://github.com/huggingface/smolagents/pull/245
* grll made their first contribution in https://github.com/huggingface/smolagents/pull/232

**Full Changelog**: https://github.com/huggingface/smolagents/compare/v1.3.0...v1.4.1

What's Changed

New features 🚀
* We now support OpenTelemetry instrumentation! Find a [detailed tutorial here](https://huggingface.co/docs/smolagents/tutorials/inspect_runs) 📊 by aymeric-roucher in https://github.com/huggingface/smolagents/pull/200
<img width="1577" alt="inspect_run_phoenix" src="https://github.com/user-attachments/assets/851b610b-c661-4abe-b6ee-aa11d22bb811" />

* We now have a Chinese (mandarin) version of the doc for `smolagents`! by Ayuilos in https://github.com/huggingface/smolagents/pull/156

* Add option to upload files to GradioUI by stackviolator in https://github.com/huggingface/smolagents/pull/138
* feat: Add multi-GPU support for TransformersModel by 6643789wsx in https://github.com/huggingface/smolagents/pull/139
* More flexible verbosity level: now use `verbosity_level=0/1/2` instead of `verbose=True/False` upon agent initialization by aymeric-roucher in https://github.com/huggingface/smolagents/pull/150. This gives you more fine-grained control over verbosity!
* Agents can now import anything using` additional_authorized_imports=['*']`! Contributed by joaopauloschuler in https://github.com/huggingface/smolagents/pull/129

Fixes and smol improvements 🔧
* Add top level docs link to README by robtaylor in https://github.com/huggingface/smolagents/pull/121
* Added the right link for website button by AngeloKiriakoulis in https://github.com/huggingface/smolagents/pull/159
* Tools from Spaces: Fix bug preventing use of long prompts. by jkingston in https://github.com/huggingface/smolagents/pull/134
* Fix typo in dosctrings by chloefeal in https://github.com/huggingface/smolagents/pull/155
* Log list of tool calls in ActionStep by aymeric-roucher in https://github.com/huggingface/smolagents/pull/172
* Bug fixes on TransformersModel by AngeloKiriakoulis in https://github.com/huggingface/smolagents/pull/165
* Fix wrong return value in agents.md doc by sidtuladhar in https://github.com/huggingface/smolagents/pull/164
* Fix minor issues in docs by duydl in https://github.com/huggingface/smolagents/pull/173
* Fix quality issues by albertvillanova in https://github.com/huggingface/smolagents/pull/171
* Clean local python interpreter: propagate imports by aymeric-roucher in https://github.com/huggingface/smolagents/pull/175
* Fix tool_calls parsing error in `ToolCallingAgent` when using `OpenAIServerModel` by tanhuajie in https://github.com/huggingface/smolagents/pull/160
* Fix minor issues in building_good_agents docs by albertvillanova in https://github.com/huggingface/smolagents/pull/170
* bugfix: Fix plan_update message display by IlyaGusev in https://github.com/huggingface/smolagents/pull/179
* Make default tools more robust by aymeric-roucher in https://github.com/huggingface/smolagents/pull/186
* Implemented support for ast.Pass in the interpeter. by AngeloKiriakoulis in https://github.com/huggingface/smolagents/pull/189
* Support pandas' iloc indexer by aymeric-roucher in https://github.com/huggingface/smolagents/pull/191
* The call.func parameter type of the local_python_executor.evaluate_call function might be ast.Subscript by nvrxq in https://github.com/huggingface/smolagents/pull/194
* bug fix: fix string concatenation bug in GradioUI.log_user_message by kingdomad in https://github.com/huggingface/smolagents/pull/199
* Fix import from ChatMessage in test_monitoring by aymeric-roucher in https://github.com/huggingface/smolagents/pull/202
* Fix quality in gradio_ui by albertvillanova in https://github.com/huggingface/smolagents/pull/206
* Pre-release fixes by aymeric-roucher in https://github.com/huggingface/smolagents/pull/207
* Document OpenTelemetry usage by aymeric-roucher in https://github.com/huggingface/smolagents/pull/204

New Contributors
* robtaylor made their first contribution in https://github.com/huggingface/smolagents/pull/121
* AngeloKiriakoulis made their first contribution in https://github.com/huggingface/smolagents/pull/159
* jkingston made their first contribution in https://github.com/huggingface/smolagents/pull/134
* chloefeal made their first contribution in https://github.com/huggingface/smolagents/pull/155
* sidtuladhar made their first contribution in https://github.com/huggingface/smolagents/pull/164
* Ayuilos made their first contribution in https://github.com/huggingface/smolagents/pull/156
* duydl made their first contribution in https://github.com/huggingface/smolagents/pull/173
* stackviolator made their first contribution in https://github.com/huggingface/smolagents/pull/138
* albertvillanova made their first contribution in https://github.com/huggingface/smolagents/pull/171
* tanhuajie made their first contribution in https://github.com/huggingface/smolagents/pull/160
* IlyaGusev made their first contribution in https://github.com/huggingface/smolagents/pull/179
* 6643789wsx made their first contribution in https://github.com/huggingface/smolagents/pull/139
* nvrxq made their first contribution in https://github.com/huggingface/smolagents/pull/194
* kingdomad made their first contribution in https://github.com/huggingface/smolagents/pull/199

**Full Changelog**: https://github.com/huggingface/smolagents/compare/v1.2.2...v1.3.0

What's Changed

**Big features:**
* Add an OpenAIServerModel by Zetaphor in https://github.com/huggingface/smolagents/pull/109
- This unlocks using any OpenAI-format-compatible server like TGI or vLLM.
* Enable `smolagent` tools in [Hugging Chat](https://huggingface.co/chat/)! 🚀 in https://github.com/huggingface/smolagents/pull/132
- Demo incoming!
* Vastly simplify Model class ✨ in https://github.com/huggingface/smolagents/pull/146
- Now `Model` subclasses have only one `__call__` method: if arg `tools_to_call_from` is passed, this method will return a tool call instead of just a string.
* Halve import time by removing torch dependency in https://github.com/huggingface/smolagents/pull/147
- Following up on https://github.com/huggingface/smolagents/issues/100 raised by xianminx, removing dependency on `torch` allowed to halve the library loading time!
* Support OpenTelemetry in https://github.com/huggingface/smolagents/pull/136
- This is still cooking, more stuff needs to be done, but we'll have observability!

**Other important features**
* Include missing pip install library in RAG example by DarwinAnim8or in https://github.com/huggingface/smolagents/pull/92
* Update rag.md with missing verb by derekalia in https://github.com/huggingface/smolagents/pull/95
* Small tweaks to Gradio demo by freddyaboulton in https://github.com/huggingface/smolagents/pull/93
* Fixing spelling and grammar for query by omarirfa in https://github.com/huggingface/smolagents/pull/98
* Fix Spelling Errors in Documentation by ScientistIzaak in https://github.com/huggingface/smolagents/pull/99
* Change DuckDuckGoSearchTool output_type to string by aymeric-roucher in https://github.com/huggingface/smolagents/pull/116
* Auto correct wrong assignments to final_answer by aymeric-roucher in https://github.com/huggingface/smolagents/pull/123
* Adding "complex" to local_python_executor.py 78 by joaopauloschuler in https://github.com/huggingface/smolagents/pull/79
* Remove dependency on LiteLLM by aymeric-roucher in https://github.com/huggingface/smolagents/pull/126
* Support multiple code blobs by aymeric-roucher in https://github.com/huggingface/smolagents/pull/128
* Fix several typos in docs. by Symbolk in https://github.com/huggingface/smolagents/pull/140

Great thanks for everyone who participated!

What's Changed

**New features:** 🥳
* !Breaking change: Agent initialization argument `max_iterations` changed to `max_steps` for consistency.
* Add a warning towards the user when imports are missing in CodeAgent https://github.com/huggingface/smolagents/commit/3f79baee71196905d8f1d0f65508aa3ee889a245.
* Add code of conduct and contributing guide by LysandreJik in https://github.com/huggingface/smolagents/pull/50
* feat: Add max_results kwarg to DDGS tool by Stillerman in https://github.com/huggingface/smolagents/pull/40
* Add support for additional keyword arguments in LiteLLMModel by chakib-belgaid in https://github.com/huggingface/smolagents/pull/29
* Add device parameter for TransformerModel in models.py by ScientistIzaak in https://github.com/huggingface/smolagents/pull/49

**Fixes:** 🔧
* Don't pass sanitize_inputs_outputs=True to managed agents by grrowl in https://github.com/huggingface/smolagents/pull/85
* Include missing pip install library in RAG example by DarwinAnim8or in https://github.com/huggingface/smolagents/pull/92
* Fix issue with forward signature validation in space tool wrapper by lelayf in https://github.com/huggingface/smolagents/pull/75
* fix ToolCollection usage by Brunwo in https://github.com/huggingface/smolagents/pull/53

**Typos:** 🪶
* Update building_good_agents.md by SHUBH4M-KUMAR in https://github.com/huggingface/smolagents/pull/43
* Fix example usage in HfApiModel by balikasg in https://github.com/huggingface/smolagents/pull/37
* Fixing minor spelling errors in building_good_agents.md by ScientistIzaak in https://github.com/huggingface/smolagents/pull/33
* chore: update local_python_executor.py by eltociear in https://github.com/huggingface/smolagents/pull/64
* Add missing end of sentence to building_good_agents by elroy-bot in https://github.com/huggingface/smolagents/pull/68
* Fix typos by oliveredget in https://github.com/huggingface/smolagents/pull/74
* Update README.md: add link to blog post by gary149 in https://github.com/huggingface/smolagents/pull/22
* e2b details by CakeCrusher in https://github.com/huggingface/smolagents/pull/72
* Fixed typos and grammatical errors in building_good_agents.md tutorial by alxfgh in https://github.com/huggingface/smolagents/pull/89

**Full Changelog**: https://github.com/huggingface/smolagents/compare/v1.0.0...v1.1.0