Mia Agent is a personal AI assistant designed to serve as an unobtrusive and configurable tool for users seeking a coding and productivity companion. Built with principles of user agency and minimalism, Mia grows alongside its users, offering support without replacing existing workflows.
Key Features:
Minimal Terminal UI: A clean interface that prioritizes simplicity and ease of use.
Multi-turn Agent Loop: Enables ongoing conversations and task continuity.
Agent Memory & History: Maintains context and records interactions for better assistance over time.
Markdown Rendering: Supports rich content display directly in the terminal.
OpenAI Compatible API Access: Integrates with OpenRouter for language model functionality.
Web Search & Extraction: Leverages Tavily for real-time information gathering.
Toolset Integration: Includes capabilities like file system interaction, Python execution, and shell commands.
Audience & Benefit:
Ideal for developers, researchers, and individuals seeking to enhance their workflows with AI-driven assistance. Mia provides a customizable platform that streamlines tasks, supports decision-making, and integrates seamlessly into existing tools and processes. Its design emphasizes user control and adaptability, making it a versatile addition to any productivity setup.
Mia Agent can be installed via winget on Windows, ensuring quick and straightforward setup for users.
README
Mia Agent
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.
Local LLMs - Ollama, LMStudio, llama.cpp, and other OpenAI-compatible local servers
Run mia setup to configure your agent interactively.
For advanced configuration, you can manually edit the ~/.mia/.env file on Linux or C:\Users\\.mia\.env on Windows to add your API key:
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/.env to enable the web_search and web_extract tools.
TAVILY_API_KEY=
(Optional) Run mia tools to see if all the tools are usable and find which components are missing if any.
