What do you want to do?
3 use cases
-
Run a local agent on one sandboxed folder
Point a local Ollama model at a single workspace with bounded tools and edits you preview before they write.
View prompt
Set up MuzeAnisichael/minimal-local-agent with Ollama, run `minimal-agent doctor`, then ask it to summarize the files in <workspace>. Confirm the run appears in the local SQLite audit history and no file changed.
-
Embed a read-only agent in your own Python app
Import AgentRuntime, set write_policy to deny, and run tasks that return a response plus a receipt hash.
View prompt
Using minimal_local_agent's AgentRuntime with write_policy="deny", run "List the workspace files" against <workspace> and print the response and receipt_hash. Verify the run made no writes.
-
Learn how an agent loop works from a small codebase
Read and run one model and tool loop with policy and budgets to understand agents end to end.
View prompt
Clone MuzeAnisichael/minimal-local-agent, run `python examples/web_demo.py`, and explain the loop from host to runtime to tools to SQLite state. Verify your explanation against the source files you cite.
Quick start with Minimal Local Agent
- Check you have what it needs: Python 3.11; Ollama (README example pulls qwen3.5:9b) or a Chat Completions-compatible API.
- Open MuzeAnisichael/minimal-local-agent on GitHub and read the README and license.
- Clone with
git clone https://github.com/MuzeAnisichael/minimal-local-agent.gitand create a Python 3.11 venv - Install with
python -m pip install -e .and pull a model withollama pull qwen3.5:9b - Copy the config with
cp agent.example.toml agent.tomland runminimal-agent doctor - Open the console with
minimal-agent weband give it a task
These steps come from our top use case, Run a local agent on one sandboxed folder, which also has a copy-paste agent prompt.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for MuzeAnisichael/minimal-local-agent
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeMinimal Local Agent alternatives · Best AI repos for Software and DevOps
About this repo
- Who it is forDevelopers who want to understand, embed and customize an agent loop rather than adopt a large assistant.
- Why it is hot120 stars, launched 80 days ago
- LanguagePython
- Sourcegithub.com/MuzeAnisichael/minimal-local-agent · Back to Hot repos
Requirements
- Python 3.11
- Ollama (README example pulls qwen3.5:9b) or a Chat Completions-compatible API
Add this badge to your README
Maintain Minimal Local Agent? Show readers where to find these use cases.
Markdown
[](https://dedupedai.com/use-cases/muzeanisichael-minimal-local-agent/?utm_source=github&utm_medium=badge&utm_campaign=MuzeAnisichael-minimal-local-agent)
HTML
<a href="https://dedupedai.com/use-cases/muzeanisichael-minimal-local-agent/?utm_source=github&utm_medium=badge&utm_campaign=MuzeAnisichael-minimal-local-agent"><img src="https://dedupedai.com/badge/MuzeAnisichael/minimal-local-agent.svg" alt="Use cases on Deduped" height="20"></a>
A static image, no tracking script. About the badge
Questions about Minimal Local Agent
What is Minimal Local Agent?
Minimal Local Agent is a small Python agent kernel with bounded tools, reviewable edits and a local SQLite audit log, usable from a CLI, a local web console or your own Python host with Ollama or a compatible API. It is an open-source project on GitHub: https://github.com/MuzeAnisichael/minimal-local-agent.
How do I use Minimal Local Agent?
Clone with git clone https://github.com/MuzeAnisichael/minimal-local-agent.git and create a Python 3.11 venv; then install with python -m pip install -e . and pull a model with ollama pull qwen3.5:9b; copy the config with cp agent.example.toml agent.toml and run minimal-agent doctor. The use cases on this page give the full steps and a copy-paste agent prompt for each job.
Who is Minimal Local Agent for?
Developers who want to understand, embed and customize an agent loop rather than adopt a large assistant.
What can I do with Minimal Local Agent?
3 use cases so far, for example: Run a local agent on one sandboxed folder; Embed a read-only agent in your own Python app; Learn how an agent loop works from a small codebase. Each has steps and a copy-paste agent prompt.
What do I need to run Minimal Local Agent?
Python 3.11; Ollama (README example pulls qwen3.5:9b) or a Chat Completions-compatible API.
What are alternatives to Minimal Local Agent?
Other hot AI repos in Software and DevOps: Deep Infer, Harness2, Orca, Opencode, Graphify.
Is Minimal Local Agent safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.