Mia is a coding and personal assistant AI agent designed to be unobtrusive, configurable and easy to use. Mia grows with you.
This project was inspired by Hermes Agent. Although it borrows ideas from it, this is not a direct derivation or modification of the project.
- The agent should never write to the system without getting permission from the user.
- Guardrails should be implemented in code, not in prompts.
- The agent should act as an additional tool to the user not as a replacement for everything they already use.
- Minimal terminal UI powered by ratatui
- Multi turn agent loop
- Agent memory (persistent across sessions)
- Session and prompt history
- Full markdown rendering in terminal (thanks to termimad)
- OpenAI Compatible API access with support for multiple providers:
- OpenRouter (default, recommended)
- Google AI Studio
- Groq
- Cerebras
- Local LLMs (Ollama, LMStudio, llama.cpp, etc.)
- Web search and extract using Tavily
- Document conversion using pandoc (
doc_converttool) - Experimental streaming support
- Legacy reedline-based TUI available via
mia old-tui
Currently Mia has the following tools:
| Tool | Description | Gated |
|---|---|---|
| 📅 | datetime |
Get the current date and time |
| 📁 | fs_list_dir |
List files in a directory |
| 📖 | fs_read_file |
Read a file from the filesystem |
| 🔍 | fs_grep_files |
Search file contents |
| 🧭 | fs_search_dirs |
Search for files in a directory |
| ✍️ | fs_write_file |
Write content to a file |
| 🐍 | exec_python |
Execute Python 3 code |
| 🐚 | exec_shell |
Run shell commands |
| 🧠 | memory |
Manage memory about the user and the agent |
| | web_extract |
Extract content from a URL |
| 🌐 | web_search |
Search the web |
| 📄 | doc_create |
Create pdf, docx and other documents |
| 📃 | doc_convert |
Convert any document to another using pandoc |
winget install Mach50.MiaAgent
Open a new terminal and run
mia setup
to configure your agent and start using it.
Mia requires rust nightly
rustup toolchain install nightly
rustup default nightly
Cargo can fetch, build and install mia.
cargo +nightly install --git https://github.com/mastermach50/mia-agent
Run
mia setup
to configure your agent and start using it.
Run the given command to test out mia on your system.
nix run github:mastermach50/mia-agent
To install it, add to your system packages using the same flake.
Mia supports multiple LLM providers:
- OpenRouter (default, recommended) - can be obtained for free, there are also free models
- Google AI Studio - free tier available
- Groq - fast inference API
- Cerebras - large model inference
- Local LLMs - Ollama, LMStudio, llama.cpp, and other OpenAI-compatible local servers
-
Run
mia setupto configure your agent interactively. -
For advanced configuration, you can manually edit the
~/.mia/.envfile on Linux orC:\Users\<username>\.mia\.envon Windows to add your API key:
OPENROUTER_API_KEY=<your-openrouter-api-key>
Or for other providers, set the appropriate environment variable.
- (Optional) Add your Tavily API key (can be obtained for free and has a reasonable number of free searches per month) to
.mia/.envto enable theweb_searchandweb_extracttools.
TAVILY_API_KEY=<your-tavily-api-key>
- (Optional) Run
mia toolsto see if all the tools are usable and find which components are missing if any.
Currently the external tools required by mia are
Use mia --help to access the full cli help menu.
The TUI supports certain commands. Use /help while in the TUI to see them.
mia tui- Start the main terminal UI (ratatui-based)mia old-tui- Start the legacy reedline-based TUI (hidden command)mia setup- Interactive setup wizardmia tools- Check tool availabilitymia model list- List available modelsmia model list --free- List only free models (price filter)mia model list --min-context <number>- Filter by minimum context lengthmia model list --max-price <price>- Filter by maximum price per million tokensmia model show- Show current model infomia sessions list- List all sessionsmia session clear- Clear all sessions (prompts for confirmation)
Mia uses rust nightly as it is required for whatsapp-rust and certain necessary features.
We DO NOT accept vibe coded contributions or contributions from agents.
However AI assisted code is fine as long as you the human are the one contributing.
Human contributions are always welcome.