MiniCPM5-2B local Agent recipe
A compact Apache-2.0 local model for tool-use experiments — with a very important warning about giving any model control of a real desktop.
The interesting part is not installing a 2B model. Tools such as Ollama already make model installation easy. The interesting part is what happens after the model can call files, terminals, browsers and desktop controls.
AILocalabs therefore recommends MiniCPM5-2B as a local experimentation recipe, but does not currently ship a general-purpose desktop Agent for ordinary users. We are not satisfied with the host-computer safety boundary yet.
Build it yourself
- Run the model through a local runtime such as llama.cpp/GGUF or a compatible Ollama package.
- Give the Agent structured tools first: file.read, file.write inside an allowed workspace, git.status, build/test and explicit browser actions.
- Keep unrestricted shell and whole-desktop control disabled by default. Add them only in an explicit developer mode.
- Treat web pages and retrieved documents as untrusted data. Prompt text must never grant new machine capabilities.
What can go wrong
- A non-admin process can still delete personal files, upload data or destroy a project.
- Prompt injection can turn browser content into unintended tool calls.
- Desktop automation can bypass a shell policy by opening a terminal and typing commands.
- A consumer product needs a capability broker, scoped folders and clear confirmation for side effects.
Give the recipe to your AI and reproduce it locally
Target hardware, runtime, key parameters, validation and risks are published as Markdown and JSON. An AI agent should still inspect your machine first, explain changes and ask before risky operations.
What we ship — and what we do not
Recipe only for now. Luna Unlimited remains a developer/internal capability; we will not sell a general desktop Agent until Safe Mode is useful enough on its own.
Tried it? Leave results, questions and improvements.
Discussion stays with this recipe so future builders can learn from it. Never post passwords, API keys, license keys or private files.
Loading discussion…