A
Aeromcp
by @mjdeiter
Native desktop AI assistant powered by Gemini, built with Dear ImGui
Created 5/19/2026
Updated about 16 hours ago
README
Repository documentation and setup instructions
AeroMCP
A native desktop AI assistant for Linux, powered by Google Gemini and built with Dear ImGui. Designed to work on any Linux system.
Features
- Fast, Thinking, and Pro model modes — switch between Gemini 2.5 Flash, Flash Thinking, and 2.5 Pro
- Integrated console — run bash commands directly from the chat interface with ▶ Run buttons on code blocks
- Image attachments — attach PNG/JPG/WebP images to your messages via file picker
- Persistent sessions — conversation history stored in SQLite, survives restarts
Requirements
- Linux (tested on CachyOS/Arch)
- Dear ImGui (included via
../fan-watch/imgui/) - GLFW3
- libcurl
- nlohmann/json
- SQLite3
- OpenGL
Build
make -j$(nproc)
Usage
- Launch
./AeroMCP - Paste your Gemini API key in the bottom-left field
- Start chatting
Note: Fast and Thinking modes work on the Gemini free tier. Pro mode requires a billing-enabled project.
Configuration
Config is stored at ~/.config/aeromcp/config.ini. The SQLite database lives at ~/.config/aeromcp/aeromcp.db.
License
MIT
Quick Setup
Installation guide for this server
Installation Command (package not published)
git clone https://github.com/mjdeiter/AeroMCP
Manual Installation: Please check the README for detailed setup instructions and any additional dependencies required.
Cursor configuration (mcp.json)
{
"mcpServers": {
"mjdeiter-aeromcp": {
"command": "git",
"args": [
"clone",
"https://github.com/mjdeiter/AeroMCP"
]
}
}
}