huggingface/smolagents

View on GitHub

🤗 smolagents: a barebones library for agents that think in code.

Stars: 29.3k
Forks: 3k
Open beginner issues: 0
Indexed issues: 319
Avg merge: 17m
Merged PRs (30d): 2

Dominant language: Python
License: Apache-2.0
Last GitHub push: Aug 22, 2026
Latest indexed: Sep 17, 2026
Contributing guide: Contributing guide
Code of conduct: Code of conduct
Beginner labels: help wanted

Open All

319 open issues indexed

Add support for additional remote code execution environments, e.g. Riza Open

huggingface/smolagents#124 · 2 comments · 0 reactions · 0 assignees · Indexed Sep 17, 2026
Making this library async Open

huggingface/smolagents#145 · 8 comments · 64 reactions · 0 assignees · Indexed Sep 17, 2026
Does smolagents offer structured outputs (constrained decoding not implicit) Open

huggingface/smolagents#153 · 15 comments · 8 reactions · 0 assignees · Indexed Sep 17, 2026
Repeatedly getting "Error in code parsing: Your code snippet is invalid" Open

huggingface/smolagents#201 · 38 comments · 0 reactions · 0 assignees · Indexed Sep 17, 2026
Unable to run Gemma-2-2b-it model using local TransformersModel Open

huggingface/smolagents#224 · 2 comments · 0 reactions · 0 assignees · Indexed Sep 17, 2026
Show exception stack trace Open

huggingface/smolagents#231 · 4 comments · 1 reaction · 0 assignees · Indexed Sep 17, 2026
A GitHub Action for automated package release Open

huggingface/smolagents#248 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 17, 2026
Expected tool format of LiteLLM for ollama is not followed by Smollagent example Tools Open

huggingface/smolagents#264 · 8 comments · 0 reactions · 0 assignees · Indexed Sep 17, 2026
Output format? `{"answer": "insert your final answer here"}` or `"insert your final answer here"` ? Open

huggingface/smolagents#304 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 17, 2026
Feat: usage of Gradio `Tool.from_gradio` based on URL Open

huggingface/smolagents#310 · 3 comments · 0 reactions · 0 assignees · Indexed Sep 17, 2026
how to exec a bin and use the output as agent arg ? Open

huggingface/smolagents#312 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 17, 2026
How to capture CodeAgent's full thinking including the code, not just the final response into a variable Open

huggingface/smolagents#322 · 5 comments · 2 reactions · 0 assignees · Indexed Sep 17, 2026
question: Why use self.input_messages as instance variable in agent methods? Open

huggingface/smolagents#323 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 17, 2026
Ask agent to do a daily job, it stuck in a loop Open

huggingface/smolagents#326 · 4 comments · 0 reactions · 0 assignees · Indexed Sep 17, 2026
Async tool support Open

huggingface/smolagents#334 · 1 comment · 8 reactions · 0 assignees · Indexed Sep 17, 2026
[BUG] LLM generated correct code but execution returned unexpected error message Open

huggingface/smolagents#338 · 2 comments · 0 reactions · 0 assignees · Indexed Sep 17, 2026
Use linting to detect code errors Open

huggingface/smolagents#340 · 5 comments · 1 reaction · 0 assignees · Indexed Sep 17, 2026
Handling Additional Arguments for Tools in a Multi-Agent System Open

huggingface/smolagents#343 · 1 comment · 2 reactions · 0 assignees · Indexed Sep 17, 2026
[Feature Request] State Serialization & Enhanced User Interaction Support Open

huggingface/smolagents#364 · 6 comments · 8 reactions · 0 assignees · Indexed Sep 17, 2026
Need help avoiding agent calling tools with json Open

huggingface/smolagents#375 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 17, 2026
Add an R1-based submission to the GAIA benchmark Open

huggingface/smolagents#395 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 17, 2026
Make a performant WebBrowserAgent class Open

huggingface/smolagents#400 · 4 comments · 4 reactions · 0 assignees · Indexed Sep 17, 2026
We want you to check out the smolagents roadmap! Open

huggingface/smolagents#413 · 4 comments · 11 reactions · 0 assignees · Indexed Sep 17, 2026
Multi agent example not working Open

huggingface/smolagents#420 · 5 comments · 0 reactions · 0 assignees · Indexed Sep 17, 2026
[BUG] DeepSeek Reasoner rejects system messages through LiteLLM with invalid message format error Open

bug

huggingface/smolagents#430 · 8 comments · 2 reactions · 0 assignees · Indexed Sep 17, 2026
Feature Request: Add `LlamaCppModel` Support to smolagents Open

enhancement

huggingface/smolagents#449 · 2 comments · 17 reactions · 0 assignees · Indexed Sep 17, 2026
Separate small package for the local python interpreter code? Open

huggingface/smolagents#472 · 1 comment · 1 reaction · 0 assignees · Indexed Sep 17, 2026
[BUG] OTEL tracing not grouping traces when using GradioUI Open

bug

huggingface/smolagents#477 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 17, 2026
Strongly enforce types in tools Open

enhancement

huggingface/smolagents#483 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 17, 2026
LLM-ready documentation Open

enhancement

huggingface/smolagents#485 · 0 comments · 4 reactions · 0 assignees · Indexed Sep 17, 2026
Different agent frameworks integration Open

enhancement

huggingface/smolagents#500 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 17, 2026
authenticated sessions with smolagents (how to be logged in during browser use) Open

enhancement

huggingface/smolagents#521 · 0 comments · 2 reactions · 0 assignees · Indexed Sep 17, 2026
[BUG] SmolAgents CodeAgent Truncates Input Before Tool Execution Open

bug

huggingface/smolagents#524 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 17, 2026
[BUG] AzureOpenAIServerModel Sends Unsupported 'stop' Parameter for o1-mini Open

bug

huggingface/smolagents#554 · 5 comments · 0 reactions · 0 assignees · Indexed Sep 17, 2026
Couple of suggestions in deep research Open

huggingface/smolagents#565 · 1 comment · 5 reactions · 0 assignees · Indexed Sep 17, 2026
[BUG] GradioUI’s uploadfile Function Incorrectly Modifies File Extensions Open

bug

huggingface/smolagents#566 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 17, 2026
Allow for introspection and type hints over class attributes when defining tool classes Open

enhancement

huggingface/smolagents#574 · 2 comments · 0 reactions · 0 assignees · Indexed Sep 17, 2026
Agent will get stuck after a few iterations if used in a loop Open

bug

huggingface/smolagents#582 · 5 comments · 0 reactions · 0 assignees · Indexed Sep 17, 2026
[BUG] invalid message format when using `OpenAIServerModel` Open

bug

huggingface/smolagents#583 · 3 comments · 0 reactions · 0 assignees · Indexed Sep 17, 2026
[Docs] Add Authentication Note and Link to Guided Tour in Quick Demo Section Open

huggingface/smolagents#596 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 17, 2026
Support OpenAI (or similar) Batch API like functionality Open

enhancement

huggingface/smolagents#622 · 1 comment · 3 reactions · 0 assignees · Indexed Sep 17, 2026
[BUG] Open researcher get 400 error from litellm after planning step when using deepseek-r1 (CodeAgent) Open

bug

huggingface/smolagents#646 · 5 comments · 0 reactions · 0 assignees · Indexed Sep 17, 2026
[BUG] Sambanova, Groq and Cerebras models not found after update to 1.9.1 Open

bug

huggingface/smolagents#655 · 11 comments · 0 reactions · 0 assignees · Indexed Sep 17, 2026
Using Open-Deep-Research with Inference Endpoints Open

huggingface/smolagents#656 · 2 comments · 0 reactions · 0 assignees · Indexed Sep 17, 2026
[BUG] Images not displaying with GradioUI even when passed as the final answer Open

bug

huggingface/smolagents#662 · 2 comments · 0 reactions · 0 assignees · Indexed Sep 17, 2026
[BUG] Tool defined in class triggers TypeHintParsingException Open

bug

huggingface/smolagents#681 · 4 comments · 0 reactions · 0 assignees · Indexed Sep 17, 2026
DAG Agents Open

enhancement

huggingface/smolagents#683 · 1 comment · 3 reactions · 0 assignees · Indexed Sep 17, 2026
Python logging missing console output (solved: workaround with Rich) Open

huggingface/smolagents#685 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 17, 2026
Real Memory summary for on-going conversations (avoid LLM size limits) Open

enhancement

huggingface/smolagents#694 · 4 comments · 10 reactions · 0 assignees · Indexed Sep 17, 2026
[Feature request] Enable Tool arguments to process pydantic schemas properly Open

enhancement

huggingface/smolagents#699 · 3 comments · 2 reactions · 0 assignees · Indexed Sep 17, 2026

huggingface/smolagents

Get new issues in your inbox