ClaudeMap

smolagents

Hugging Face's minimal agent library — agents that think in Python code.

Plugins & Agentsagent-frameworkhugging-faceminimalcode-agent

Hugging Face's smolagents is a deliberately small agent library (~1k lines of core logic) built around the CodeAgent paradigm: instead of emitting JSON tool calls, the agent writes its actions as Python code that runs in a secure interpreter. Supports Claude and other models via provider integrations. The reference implementation to read when you want to understand agent loops.

What it does

  • Hugging Face's minimal agent library — the core fits in a small codebase you can actually read
  • CodeAgent: agents that write Python code as their actions instead of JSON tool calls
  • Works with HF Inference API, OpenAI-compatible endpoints, and local models
  • Toolkit extra bundles common tools: pip install "smolagents[toolkit]"

When to use it

Good entry point for learning how agents actually work, and for prototyping tool-using agents where you want code-as-action rather than rigid JSON schemas.

Getting started

pip install "smolagents[toolkit]"

Then instantiate a CodeAgent with a model class such as InferenceClientModel and your tools.

Things to know

Minimalism is the point — production hardening (retries, sandboxing, observability) is on you.

Repository

huggingface/smolagents

Charted

Related on the map

  • clawd-conduit

    Plugin / Agent

    Wire all 15 Claude Code hook events into the Clawd on Desk desktop pet — and turn permission requests into a blocking desktop card.

    • hooks
    • desktop
    • notifications
    • claude-code
  • CometixCode

    Plugin / Agent

    An unofficial Rust 1:1 reimplementation of the Claude Code terminal UI, ported file-for-file onto an iocraft TUI framework.

    • terminal-ui
    • rust
    • reimplementation
    • unofficial
  • Abide

    Plugin / Agent

    Hook-level enforcement for the natural-language rules in AGENTS.md and CLAUDE.md — every edit is judged and violations are repaired in the same turn.

    • hooks
    • code-review
    • rules
    • agents-md