Debuly
Mini Coding Agent logo

Mini Coding Agent

Compact open-source Python coding agent by Sebastian Raschka that shows how an agent harness works, running on local models.

Open source

What is Mini Coding Agent?

Mini Coding Agent is a small, standalone coding agent written in Python by Sebastian Raschka and published on GitHub as rasbt/mini-coding-agent. It accompanies his article Components of A Coding Agent, which explains how tools, memory and repository context turn a language model into something that can work on code, the way harnesses such as Claude Code and Codex CLI do. The project implements a minimal agent loop: it collects a snapshot of your workspace, builds a stable prompt with turn state, exposes structured tools, asks for approval before risky ones, saves a transcript and memory, and supports bounded delegation to sub-agents. The model backend is currently based on Ollama, so it runs against local models on your own machine. It is meant as a readable teaching reference rather than a production tool, and it is free and open source under the Apache-2.0 license. There is no pricing, and model costs are limited to your own hardware and electricity.

Use cases

  • Learn how a coding agent harness works
  • Read a minimal agent loop in Python
  • Run a coding agent on local models
  • Experiment with tools and approvals
  • Prototype your own agent harness
  • Study memory and transcript handling

Who it's for

  • Developers learning about agents
  • AI and machine learning students
  • Researchers and educators
  • Hobbyists running local models

Why use Mini Coding Agent

  • The code is small enough to read end to end, which makes agent internals easier to understand.
  • It pairs with a detailed article that explains each building block of a coding agent.
  • Running against local models through Ollama means no per-token API fees and no code leaving your machine.
  • Because it is Apache-2.0 licensed, you can fork it and change the harness however you like.
  • Risky tools require approval, so you can see how permission handling fits into the loop.

Mini Coding Agent features

  • Minimal local agent loop written in Python
  • Workspace snapshot collection for repo context
  • Stable prompt with turn state
  • Structured tools for reading and editing
  • Approval step before risky tools run
  • Saved transcript and memory
  • Bounded delegation to sub-agents
  • Ollama model backend for local models
  • Apache-2.0 license

Mini Coding Agent integrations

  • Ollama

How to get started with Mini Coding Agent

  1. Clone the rasbt/mini-coding-agent repository from GitHub and read the accompanying article.
  2. Install and run Ollama with a local model of your choice.
  3. Start the agent in a project folder so it can collect a snapshot of the workspace.
  4. Give it a coding task; it calls structured tools and asks approval before risky ones.
  5. Review the saved transcript and memory, and modify the Python code to experiment.

Mini Coding Agent limitations

  • Educational scale rather than a full production agent
  • Model backend is currently based on Ollama
  • Not a replacement for full tools such as Claude Code or Codex CLI
  • Small local models can limit quality

Mini Coding Agent pricing

Mini Coding Agent is open source, so you can use and self-host it for free.

Prices can change and may vary by country or exclude tax. Check the official pricing page.

Mini Coding Agent alternatives

The main Mini Coding Agent alternatives listed on Debuly are Aider, OpenHands, goose, Pi, smolagents and Claude Code. The table compares pricing and platforms; order is A–Z.

Mini Coding Agent compared with its alternatives
ToolPricingStarting pricePlatforms
Mini Coding AgentOpen source—CLI, Self-hosted
AiderOpen source—CLI, Self-hosted, Web
Claude CodePaid—macOS, Linux, Windows, Web
gooseOpen source—macOS, Linux, Windows, CLI
OpenHandsFreemium$499/moWeb, API, Self-hosted, Kubernetes
PiOpen source—CLI, macOS, Linux, Windows
smolagentsOpen source—CLI, Self-hosted
  1. Aider

    Open-source AI pair programming tool that runs in your terminal and edits code in your local git repository using the LLM you choose.

  2. Claude Code

    Anthropic's coding agent that fixes bugs, writes tests and runs migrations from your terminal, IDE, desktop app, web or Slack.

  3. goose

    Open source AI agent that runs on your machine as a desktop app, CLI or API and connects to tools through MCP extensions.

  4. OpenHands

    Open-source AI coding agent platform with a free Agent Canvas, a Teams plan, and self-hosted Enterprise control

  5. Pi

    Open-source, MIT-licensed terminal coding agent and TypeScript toolkit you extend with skills, extensions, prompt templates and themes.

  6. smolagents

    Hugging Face's minimal open-source Python library for building agents that write their actions as code.

Mini Coding Agent FAQ

Is Mini Coding Agent open source?

Yes. It is published on GitHub as rasbt/mini-coding-agent under the Apache-2.0 license.

How much does Mini Coding Agent cost?

It is free. There is no pricing or paid plan, and because it uses local models through Ollama, your costs are only hardware and electricity.

Does Mini Coding Agent have an API?

No separate API is described. It is a Python program that talks to a local model backend based on Ollama.

Which models does it work with?

The model backend is currently based on Ollama, so it runs against models you host locally. The author tried a small reasoning model first and added Ollama for experimentation.

Is it ready for production use?

It is built at educational scale. People who want a production-grade coding agent will likely prefer larger projects such as Claude Code, Codex CLI or Aider.

What are alternatives to Mini Coding Agent?

Alternatives include Aider, OpenHands, Goose, Pi, smolagents, Claude Code and Codex CLI, which are fuller coding agents.

Sources & verification

Facts on this page come from the official sources below, each with the date we read it. Written by Debuly; the vendor did not review this page.

Image credits

  • Logo: from substackcdn.com · fetched · Vendor trademark, used only to identify the product; removed on request
  • Cover: none collected yet, so a generated tile is shown.

Spot an error? Report an issue with this listing. We also remove a logo or image on the owner's request.