Harness Hub
All open source

smolagents

Minimal, code-first agents — the lightweight end of the stack.

huggingface/smolagents

Maintained by Hugging Face

Hugging Face's smolagents keeps the agent loop tiny and lets agents write Python code as actions (CodeAct) instead of JSON tool calls. A refreshing counterpoint to heavyweight frameworks.

View on GitHubDocs

Pros & cons

Each point cites its sources and says what kind of evidence backs it. A second reviewer tried to refute every claim before it was kept.

Pros

  • DocsIntentionally minimal (agent logic in about 1,000 lines of agents.py) and readable, often recommended for learning how agents work.[1][2]
  • User reportsPopularized code-as-action (CodeAct) tool calling, which is now widely copied.[1][2]
  • DocsModel- and modality-agnostic (transformers, Ollama, Hub providers, LiteLLM), and you can share tools and agents on the Hugging Face Hub.[1]

Cons

  • User reportsTightly coupled to its two agent types, so custom state transformations are hard.[1]
  • User reportsRunning generated code locally is never fully safe; the maintainer points users to remote sandboxes (E2B/Docker).[1]
  • User reportsAn async API has been open as a request since January 2025, and users cite thin docs and examples.[1][2]
  • MetadataNo release since v1.26.0 (2026-05-29), with about 410 open issues.[1][2]
Best for
Learning agent internals or prototyping code-writing agents with open models from the Hugging Face ecosystem.
Watch out for
Run CodeAgent in a remote sandbox, and expect to fork it for non-standard control flow.

Assessed Oct 29, 2026 · adversarially reviewedSuggest a correction

Activity

Last push
· yesterday
Latest release
v1.26.0
· 5mo ago
Last 90 days
0 releases
  1. v1.26.0

    · 5mo ago

    What's Changed Bump dev version: v1.26.0.dev0 by @albertvillanova in https://github.com/huggingface/smolagents/pull/2273 Add new possible error message to test of LiteLLM providers w/o key by @albertvillanova in https://github.com/huggingface/smolagents/pull/2275 Fix typo…

  2. v1.25.0

    · 6mo ago

    What's Changed Bump dev version: v1.25.0.dev0 by @albertvillanova in https://github.com/huggingface/smolagents/pull/1939 Fix import of TokenUsage by @albertvillanova in https://github.com/huggingface/smolagents/pull/1943 Add MLflow integration doc by @B-Step62 in…

  3. v1.24.0

    · 10mo ago

    What's Changed Bump version to 1.24 by @aymeric-roucher in https://github.com/huggingface/smolagents/pull/1871 Fix: Add backward compatibility for deprecated HfApiModel by @MohammadKassas143 in https://github.com/huggingface/smolagents/pull/1863 Fix typo in…

  4. v1.23.0

    · 1y ago

    Improvements ✨ Update final answer checks to accept the agent instance by @Zoe14 in https://github.com/huggingface/smolagents/pull/1648 Dialog mode CLI by @aymeric-roucher in https://github.com/huggingface/smolagents/pull/1540 Add Blaxel support for remote code execution by…

  5. v1.22.0

    · 1y ago

    What's Changed Bump dev version: v1.22.0.dev0 by @albertvillanova in https://github.com/huggingface/smolagents/pull/1657 refactor(PythonExecutor): inherit from ABC and declare abstract methods by @HairlessVillager in https://github.com/huggingface/smolagents/pull/1654 Fix error…

Checked against GitHub on Nov 21, 2026. Release notes are shortened to plain text.

In the news

In research (1)

Featured

openclaw/openclaw

The viral open-source personal AI assistant that really does things.

Maintained by OpenClaw Foundation

v2026.11.6released
4 pros · 4 cons
Featured

deepseek-ai/deepseek-harness

Everything is a Plugin — DeepSeek's open agent harness.

Maintained by DeepSeek

dsh-v0.2.2-rc.5 prereleased
4 pros · 4 cons

n8n

n8n-io/n8n

Fair-code workflow automation platform with native AI capabilities.

Maintained by n8n-io

n8n@1.123.100released
4 pros · 4 cons

Connections

Relations from the Harness Hub knowledge graph, as charted in the State of Harness reports.

Maintained by · 1

  • Hugging FaceOrganisation

Similar entries · 3

The Harness Hub newsletter

New harness companies, projects, releases and the monthly State of Harness report, in your inbox.