Skip to content

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.txtPROBE llms.txt: HTTP 404 at https://huggingface.co/llms.txt
  • [probe] https://huggingface.co/docs/smolagents/guided_tour.mdPROBE 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/indexagent = 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/indexCLI Tools: Comes with command-line utilities (smolagent, webagent) for quickly running agents without writing boilerplate code.
  • [claimed-docs] https://huggingface.co/docs/smolagents/indexTo make it secure, we support executing in sandboxed environment via Modal, Blaxel, E2B, or Docker.
  • [github] https://github.com/huggingface/smolagentsTo 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/smolagentsYou 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/smolagentsYou 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/indexCLI 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_tourCodeAgent generates tool calls as Python code snippets.
  • [claimed-docs] https://huggingface.co/docs/smolagents/guided_tourToolCallingAgent writes tool calls as structured JSON.
  • [claimed-docs] https://huggingface.co/docs/smolagents/tutorials/toolsThe 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/agentsfinal_answer_checks (list[Callable], optional) — List of validation functions to run before accepting a final answer.
  • [claimed-docs] https://huggingface.co/docs/smolagents/reference/agentsplanning_interval (int, optional) — Interval at which the agent will run a planning step.
  • [claimed-docs] https://huggingface.co/docs/smolagents/indexCLI Tools: Comes with command-line utilities (smolagent, webagent) for quickly running agents without writing boilerplate code.
  • [probe] https://huggingface.co/docs/smolagents/guided_tour.mdPROBE 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_tourCodeAgent generates tool calls as Python code snippets.
  • [claimed-docs] https://huggingface.co/docs/smolagents/guided_tourToolCallingAgent writes tool calls as structured JSON.
  • [claimed-docs] https://huggingface.co/docs/smolagents/tutorials/toolsThe 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/indexCLI Tools: Comes with command-line utilities (smolagent, webagent) for quickly running agents without writing boilerplate code.
  • [github] https://github.com/huggingface/smolagentssmolagents 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/multiagentsThen 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/agentsfinal_answer_checks (list[Callable], optional) — List of validation functions to run before accepting a final answer.
  • [claimed-docs] https://huggingface.co/docs/smolagents/reference/agentsplanning_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/agentsfinal_answer_checks (list[Callable], optional) — List of validation functions to run before accepting a final answer.
  • [claimed-docs] https://huggingface.co/docs/smolagents/reference/agentsplanning_interval (int, optional) — Interval at which the agent will run a planning step.
  • [probe] https://huggingface.co/docs/smolagents/guided_tour.mdPROBE 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.jsonPROBE 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/indexTo make it secure, we support executing in sandboxed environment via Modal, Blaxel, E2B, or Docker.
  • [github] https://github.com/huggingface/smolagentsTo 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_executionwe 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/indexCLI Tools: Comes with command-line utilities (smolagent, webagent) for quickly running agents without writing boilerplate code.
  • [claimed-docs] https://huggingface.co/docs/smolagents/indexagent = 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/memoryYou can access the agent’s memory using:
  • [claimed-docs] https://huggingface.co/docs/smolagents/tutorials/memoryYou can also use `agent.replay()`, as follows
  • [github] https://github.com/huggingface/smolagentsagent.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/smolagentsYou can even share your agent to the Hub, as a Space repository:
  • [claimed-docs] https://huggingface.co/docs/smolagents/tutorials/inspect_runsWe’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/smolagentssmolagents 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/smolagentsagent.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/smolagentsYou can even share your agent to the Hub, as a Space repository:
  • [github] https://github.com/huggingface/smolagentsTo 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/smolagentssmolagents 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/smolagentssmolagents 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/indexTo make it secure, we support executing in sandboxed environment via Modal, Blaxel, E2B, or Docker.
  • [github] https://github.com/huggingface/smolagentsTo make it secure, we support executing in sandboxed environments via Blaxel, E2B, Modal, or Docker.
  • [claimed-docs] https://huggingface.co/docs/smolagents/indexCLI 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_executionwe 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/indexagent = 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/indexNow the agent can search the web!
  • [community] https://hn.algolia.com/api/v1/items/42578242In 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/indexCodeAgent 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/memoryThis 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/memoryRun one step. final_answer = agent.step(memory_step)
  • [claimed-docs] https://huggingface.co/docs/smolagents/indexagent = 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/indexagent = 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/indexCLI Tools: Comes with command-line utilities (smolagent, webagent) for quickly running agents without writing boilerplate code.
  • [claimed-docs] https://huggingface.co/docs/smolagents/indexCodeAgent 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_tourCodeAgent generates tool calls as Python code snippets.
  • [claimed-docs] https://huggingface.co/docs/smolagents/guided_tourYou 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/42578242In 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/memoryYou can also use `agent.replay()`, as follows
  • [claimed-docs] https://huggingface.co/docs/smolagents/tutorials/memoryYou can also use agent.replay(), as follows
  • [claimed-docs] https://huggingface.co/docs/smolagents/tutorials/memoryYou can also use `agent.replay()`
  • [github] https://github.com/huggingface/smolagentsagent.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/smolagentsYou can even share your agent to the Hub, as a Space repository:
  • [claimed-docs] https://huggingface.co/docs/smolagents/tutorials/inspect_runsWe’ve adopted the OpenTelemetry standard for instrumenting agent runs.

Automation = 7.2 ÷ 50 × 100 = 14.4