How smolagents’s scores are calculated
The full audit trail, recomputed from the verdict data at build time through the same code that produced the leaderboard: verdict × quality × story weight per cell, cells sum to dimension scores, dimensions blend into the PA Score. Every number on the product page is reproducible from this page alone; for why the formula looks like this, see the methodology.
verdict factors: full ×1.0 · partial ×0.6 · disputed ×0.3 · none ×0.0 · n/a excluded from both sides · cell points = weight × quality × factor · cell max = weight × 10
PA Score33/100
Agent-ready 51.6 × 0.30 = 15.48
API quality 7.2 × 0.20 = 1.44
Openness 46.5 × 0.20 = 9.30
Built-in AI 33.3 × 0.15 = 4.99
Automation 14.4 × 0.15 = 2.16
(15.48 + 1.44 + 9.30 + 4.99 + 2.16) ÷ (0.30 + 0.20 + 0.20 + 0.15 + 0.15) = 33.38 ÷ 1.00 = 33.4
Scores are stored to 1 decimal; the product page’s pills round to whole numbers for display. Each dimension below shows the stories, verdicts, and cited evidence behind its number.
Agent-ready51.6/100×0.30 of the PA blend
Outside-in: can YOUR agent reach and drive this product — API, MCP, CLI, headless runs, agent docs.
Point an agent at llms.txt or agent-oriented docsweight 2
2 (weight) × 4 (quality) × 0.6 (partial) = 4.8 of 20 max
- [probe] https://huggingface.co/llms.txt“PROBE llms.txt: HTTP 404 at https://huggingface.co/llms.txt”
- [probe] https://huggingface.co/docs/smolagents/guided_tour.md“PROBE docs-md: HTTP 200 at https://huggingface.co/docs/smolagents/guided_tour.md # Agents - Guided tour In this guided visit, you will learn how to build an agent, how to run it, and how to customize”
Run the product headlessly / in CI for automationweight 2
2 (weight) × 7 (quality) × 1.0 (full) = 14.0 of 20 max
- [claimed-docs] https://huggingface.co/docs/smolagents/index“agent = CodeAgent(tools=[], model=model) # Run the agent with a task result = agent.run("Calculate the sum of numbers from 1 to 10")”
- [claimed-docs] https://huggingface.co/docs/smolagents/index“CLI Tools: Comes with command-line utilities (smolagent, webagent) for quickly running agents without writing boilerplate code.”
- [claimed-docs] https://huggingface.co/docs/smolagents/index“To make it secure, we support executing in sandboxed environment via Modal, Blaxel, E2B, or Docker.”
- [github] https://github.com/huggingface/smolagents“To make it secure, we support executing in sandboxed environments via Blaxel, E2B, Modal, or Docker.”
Plug MCP servers into this product so it can use their toolsweight 3
3 (weight) × 6 (quality) × 0.6 (partial) = 10.8 of 30 max
- [github] https://github.com/huggingface/smolagents“You can use tools from any MCP server, from LangChain, you can even use a Hub Space as a tool.”
Connect an agent via an official MCP serverweight 3
n/a — not applicable to this product: excluded from numerator and denominator
- [github] https://github.com/huggingface/smolagents“You can use tools from any MCP server, from LangChain, you can even use a Hub Space as a tool.”
Use an official CLIweight 2
2 (weight) × 8 (quality) × 1.0 (full) = 16.0 of 20 max
- [claimed-docs] https://huggingface.co/docs/smolagents/index“CLI Tools: Comes with command-line utilities (smolagent, webagent) for quickly running agents without writing boilerplate code.”
Drive the product through a documented public APIweight 3
3 (weight) × 7 (quality) × 1.0 (full) = 21.0 of 30 max
- [claimed-docs] https://huggingface.co/docs/smolagents/guided_tour“CodeAgent generates tool calls as Python code snippets.”
- [claimed-docs] https://huggingface.co/docs/smolagents/guided_tour“ToolCallingAgent writes tool calls as structured JSON.”
- [claimed-docs] https://huggingface.co/docs/smolagents/tutorials/tools“The custom tool subclasses Tool to inherit useful methods... A `forward` method which contains the inference code to be executed.”
- [claimed-docs] https://huggingface.co/docs/smolagents/reference/agents“final_answer_checks (list[Callable], optional) — List of validation functions to run before accepting a final answer.”
- [claimed-docs] https://huggingface.co/docs/smolagents/reference/agents“planning_interval (int, optional) — Interval at which the agent will run a planning step.”
- [claimed-docs] https://huggingface.co/docs/smolagents/index“CLI Tools: Comes with command-line utilities (smolagent, webagent) for quickly running agents without writing boilerplate code.”
- [probe] https://huggingface.co/docs/smolagents/guided_tour.md“PROBE docs-md: HTTP 200 at https://huggingface.co/docs/smolagents/guided_tour.md # Agents - Guided tour In this guided visit, you will learn how to build an agent, how to run it, and how to customize”
Issue scoped/least-privilege API credentials for an agentweight 2
2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max
no evidence cited — the verdict rests on absence of evidence, re-checked on refresh
Build against official SDKsweight 2
2 (weight) × 8 (quality) × 1.0 (full) = 16.0 of 20 max
- [claimed-docs] https://huggingface.co/docs/smolagents/guided_tour“CodeAgent generates tool calls as Python code snippets.”
- [claimed-docs] https://huggingface.co/docs/smolagents/guided_tour“ToolCallingAgent writes tool calls as structured JSON.”
- [claimed-docs] https://huggingface.co/docs/smolagents/tutorials/tools“The custom tool subclasses Tool to inherit useful methods... A `forward` method which contains the inference code to be executed.”
- [claimed-docs] https://huggingface.co/docs/smolagents/index“CLI Tools: Comes with command-line utilities (smolagent, webagent) for quickly running agents without writing boilerplate code.”
- [github] https://github.com/huggingface/smolagents“smolagents supports any LLM. It can be a local `transformers` or `ollama` model, one of many providers on the Hub, or any model from OpenAI, Anthropic and many others via our LiteLLM integration.”
- [claimed-docs] https://huggingface.co/docs/smolagents/examples/multiagents“Then we create a manager agent, and upon initialization we pass our managed agent to it in its `managed_agents` argument.”
- [claimed-docs] https://huggingface.co/docs/smolagents/reference/agents“final_answer_checks (list[Callable], optional) — List of validation functions to run before accepting a final answer.”
- [claimed-docs] https://huggingface.co/docs/smolagents/reference/agents“planning_interval (int, optional) — Interval at which the agent will run a planning step.”
Subscribe to events via webhooksweight 2
n/a — not applicable to this product: excluded from numerator and denominator
no evidence cited — the verdict rests on absence of evidence, re-checked on refresh
Agent-ready = 82.6 ÷ 160 × 100 = 51.6
API quality7.2/100×0.20 of the PA blend
The programmable surface once an agent is there — machine-readable spec, interactive docs, sandbox, versioning discipline.
Explore an interactive API reference with runnable examplesweight 2
2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max
- [claimed-docs] https://huggingface.co/docs/smolagents/reference/agents“final_answer_checks (list[Callable], optional) — List of validation functions to run before accepting a final answer.”
- [claimed-docs] https://huggingface.co/docs/smolagents/reference/agents“planning_interval (int, optional) — Interval at which the agent will run a planning step.”
- [probe] https://huggingface.co/docs/smolagents/guided_tour.md“PROBE docs-md: HTTP 200 at https://huggingface.co/docs/smolagents/guided_tour.md # Agents - Guided tour In this guided visit, you will learn how to build an agent, how to run it, and how to customize”
- [probe] https://huggingface.co/.well-known/openapi.json“PROBE openapi: HTTP 200 at https://huggingface.co/.well-known/openapi.json — contains "openapi" key”
Download a machine-readable API spec (OpenAPI or equivalent)weight 2
n/a — not applicable to this product: excluded from numerator and denominator
no evidence cited — the verdict rests on absence of evidence, re-checked on refresh
Test against a sandbox environment without touching production dataweight 1
1 (weight) × 6 (quality) × 0.6 (partial) = 3.6 of 10 max
- [claimed-docs] https://huggingface.co/docs/smolagents/index“To make it secure, we support executing in sandboxed environment via Modal, Blaxel, E2B, or Docker.”
- [github] https://github.com/huggingface/smolagents“To make it secure, we support executing in sandboxed environments via Blaxel, E2B, Modal, or Docker.”
- [claimed-docs] https://huggingface.co/docs/smolagents/tutorials/secure_code_execution“we have re-built a more secure `LocalPythonExecutor` from the ground up.”
Rely on versioned APIs with a documented deprecation policyweight 2
2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max
no evidence cited — the verdict rests on absence of evidence, re-checked on refresh
API quality = 3.6 ÷ 50 × 100 = 7.2
Openness46.5/100×0.20 of the PA blend
Can you leave, inspect, or self-host — data export, open source, portability.
Do everything through the API that I can do in the UIweight 2
n/a — not applicable to this product: excluded from numerator and denominator
- [claimed-docs] https://huggingface.co/docs/smolagents/index“CLI Tools: Comes with command-line utilities (smolagent, webagent) for quickly running agents without writing boilerplate code.”
- [claimed-docs] https://huggingface.co/docs/smolagents/index“agent = CodeAgent(tools=[], model=model) # Run the agent with a task result = agent.run("Calculate the sum of numbers from 1 to 10")”
Export all of my data in open formats and leaveweight 3
3 (weight) × 4 (quality) × 0.6 (partial) = 7.2 of 30 max
- [claimed-docs] https://huggingface.co/docs/smolagents/tutorials/memory“You can access the agent’s memory using:”
- [claimed-docs] https://huggingface.co/docs/smolagents/tutorials/memory“You can also use `agent.replay()`, as follows”
- [github] https://github.com/huggingface/smolagents“agent.push_to_hub("m-ric/my_agent") # agent.from_hub("m-ric/my_agent") to load an agent from Hub”
- [github] https://github.com/huggingface/smolagents“You can even share your agent to the Hub, as a Space repository:”
- [claimed-docs] https://huggingface.co/docs/smolagents/tutorials/inspect_runs“We’ve adopted the OpenTelemetry standard for instrumenting agent runs.”
Read the product's source under an open licenseweight 2
2 (weight) × 5 (quality) × 0.6 (partial) = 6.0 of 20 max
- [github] https://github.com/huggingface/smolagents“smolagents supports any LLM. It can be a local `transformers` or `ollama` model, one of many providers on the Hub, or any model from OpenAI, Anthropic and many others via our LiteLLM integration.”
- [github] https://github.com/huggingface/smolagents“agent.push_to_hub("m-ric/my_agent") # agent.from_hub("m-ric/my_agent") to load an agent from Hub”
- [github] https://github.com/huggingface/smolagents“You can even share your agent to the Hub, as a Space repository:”
- [github] https://github.com/huggingface/smolagents“To make it secure, we support executing in sandboxed environments via Blaxel, E2B, Modal, or Docker.”
Self-host the core productweight 3
3 (weight) × 8 (quality) × 1.0 (full) = 24.0 of 30 max
- [github] https://github.com/huggingface/smolagents“smolagents supports any LLM. It can be a local `transformers` or `ollama` model, one of many providers on the Hub, or any model from OpenAI, Anthropic and many others via our LiteLLM integration.”
- [github] https://github.com/huggingface/smolagents“smolagents supports any LLM. It can be a local transformers or ollama model, one of many providers on the Hub, or any model from OpenAI, Anthropic and many others via our LiteLLM integration.”
- [claimed-docs] https://huggingface.co/docs/smolagents/index“To make it secure, we support executing in sandboxed environment via Modal, Blaxel, E2B, or Docker.”
- [github] https://github.com/huggingface/smolagents“To make it secure, we support executing in sandboxed environments via Blaxel, E2B, Modal, or Docker.”
- [claimed-docs] https://huggingface.co/docs/smolagents/index“CLI Tools: Comes with command-line utilities (smolagent, webagent) for quickly running agents without writing boilerplate code.”
- [claimed-docs] https://huggingface.co/docs/smolagents/tutorials/secure_code_execution“we have re-built a more secure `LocalPythonExecutor` from the ground up.”
Openness = 37.2 ÷ 80 × 100 = 46.5
Built-in AI33.3/100×0.15 of the PA blend
Inside-out: how agentic the product itself is for its users — built-in assistants, autonomous features.
Get AI-generated insights and suggestions from my data inside the productweight 2
2 (weight) × 5 (quality) × 0.6 (partial) = 6.0 of 20 max
- [claimed-docs] https://huggingface.co/docs/smolagents/index“agent = CodeAgent(tools=[], model=model) # Run the agent with a task result = agent.run("Calculate the sum of numbers from 1 to 10")”
- [claimed-docs] https://huggingface.co/docs/smolagents/index“Now the agent can search the web!”
- [community] https://hn.algolia.com/api/v1/items/42578242“In the text_to_sql example, python code with matplotlib failed because matplotlib was not in the allowed imports; the system pivoted to printing a bar plot with ## characters instead, but still reached a correct final answer.”
- [claimed-docs] https://huggingface.co/docs/smolagents/index“CodeAgent writes its actions in code (as opposed to “agents being used to write code”) to invoke tools or perform computations”
Set up automations that run autonomously in the backgroundweight 2
2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max
- [claimed-docs] https://huggingface.co/docs/smolagents/tutorials/memory“This can be useful in case you have tool calls that take days: you can just run your agents step by step.”
- [claimed-docs] https://huggingface.co/docs/smolagents/tutorials/memory“Run one step. final_answer = agent.step(memory_step)”
- [claimed-docs] https://huggingface.co/docs/smolagents/index“agent = CodeAgent(tools=[], model=model) # Run the agent with a task result = agent.run("Calculate the sum of numbers from 1 to 10")”
Delegate tasks to a built-in AI assistant inside the productweight 3
n/a — not applicable to this product: excluded from numerator and denominator
no evidence cited — the verdict rests on absence of evidence, re-checked on refresh
Operate the product with natural-language commandsweight 2
2 (weight) × 7 (quality) × 1.0 (full) = 14.0 of 20 max
- [claimed-docs] https://huggingface.co/docs/smolagents/index“agent = CodeAgent(tools=[], model=model) # Run the agent with a task result = agent.run("Calculate the sum of numbers from 1 to 10")”
- [claimed-docs] https://huggingface.co/docs/smolagents/index“CLI Tools: Comes with command-line utilities (smolagent, webagent) for quickly running agents without writing boilerplate code.”
- [claimed-docs] https://huggingface.co/docs/smolagents/index“CodeAgent writes its actions in code (as opposed to “agents being used to write code”) to invoke tools or perform computations”
Built-in AI = 20.0 ÷ 60 × 100 = 33.3
Automation14.4/100×0.15 of the PA blend
Depth of automation primitives — rules, scheduling, bulk operations, webhooks.
Perform bulk operations across many items at onceweight 2
2 (weight) × 4 (quality) × 0.6 (partial) = 4.8 of 20 max
- [claimed-docs] https://huggingface.co/docs/smolagents/guided_tour“CodeAgent generates tool calls as Python code snippets.”
- [claimed-docs] https://huggingface.co/docs/smolagents/guided_tour“You can authorize additional imports by passing the authorized modules as a list of strings in argument `additional_authorized_imports`”
- [community] https://hn.algolia.com/api/v1/items/42578242“In the text_to_sql example, python code with matplotlib failed because matplotlib was not in the allowed imports; the system pivoted to printing a bar plot with ## characters instead, but still reached a correct final answer.”
Define rules that trigger actions automatically on eventsweight 3
n/a — not applicable to this product: excluded from numerator and denominator
no evidence cited — the verdict rests on absence of evidence, re-checked on refresh
Schedule recurring jobs or workflowsweight 2
2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max
no evidence cited — the verdict rests on absence of evidence, re-checked on refresh
Version, review, and roll back my automationsweight 1
1 (weight) × 4 (quality) × 0.6 (partial) = 2.4 of 10 max
- [claimed-docs] https://huggingface.co/docs/smolagents/tutorials/memory“You can also use `agent.replay()`, as follows”
- [claimed-docs] https://huggingface.co/docs/smolagents/tutorials/memory“You can also use agent.replay(), as follows”
- [claimed-docs] https://huggingface.co/docs/smolagents/tutorials/memory“You can also use `agent.replay()`”
- [github] https://github.com/huggingface/smolagents“agent.push_to_hub("m-ric/my_agent") # agent.from_hub("m-ric/my_agent") to load an agent from Hub”
- [github] https://github.com/huggingface/smolagents“You can even share your agent to the Hub, as a Space repository:”
- [claimed-docs] https://huggingface.co/docs/smolagents/tutorials/inspect_runs“We’ve adopted the OpenTelemetry standard for instrumenting agent runs.”
Automation = 7.2 ÷ 50 × 100 = 14.4