Mint

An advanced AI Assistant built for the modern workflow — now on Desktop & Terminal.

---

Mint is a powerful AI Assistant built with Electron, Node.js, and Google Gemini. It bridges the gap between your Desktop and Terminal, featuring real-time screen vision, web automation, local knowledge search, and a professional CLI for developers who love the command line.

Highlights

• Dual-Mode AI: Switch between a beautiful Desktop GUI and a professional CLI.
• Persona-Driven: Features Mint, a smart and highly helpful assistant.
• Natural Replies: Longer AI responses are split into multiple chat bubbles/lines with human-like pacing.
• Vision-Ready (Desktop): Capture and translate any part of your screen in real-time.
• Automation First: Control your system and browser via natural language from both App and Terminal.
• Professional CLI: Onboarding wizard, subcommands, and background daemon support.
• Background Agent: Install Mint as a systemd user service to run tasks in the background.

---

Screenshots

Desktop Interface and Personalized Settings window

---

Getting Started

Prerequisites

• Node.js (LTS recommended)
• npm
• A Google Gemini API Key (Get one at Google AI Studio)

1. Installation

1. Clone and Install Dependencies

   git clone https://github.com/Pheem49/Mint.git
   cd Mint
   npm install

2. Setup CLI Globally (Recommended)

   sudo env "PATH=$PATH" npm link

2. Configuration

Mint will guide you through the setup automatically when you first run it, or you can manually create a .env file:

GEMINI_API_KEY=your_google_gemini_api_key

---

Desktop Usage

Launch the full Electron experience with a floating character widget and screen vision:

npm start

Pro Tip: Use Ctrl+Shift+Space as the default global shortcut to summon Mint Desktop instantly!

---

CLI Usage

Mint CLI is built for power users. Use the mint command from anywhere in your terminal.

First-Time Setup

Run the onboarding wizard to configure your API key and model:

mint onboard

Install Background Daemon (Linux Only)

Keep Mint running in the background to handle proactive features:

mint onboard --install-daemon

Direct Commands

Ask Mint something directly without entering interactive mode:

mint "What are my upcoming calendar events?"
mint "Open YouTube and search for Lo-fi music"

Interactive Chat & Features

Start a conversation or see all available abilities:

mint        # Start chat
mint list   # Show all features and plugins

---

Key Features

Intelligent Core

• AI Persona: A professional and friendly assistant with a distinct helpful personality.
• Multi-Bubble Responses: AI replies appear in multiple lines for better readability.
• Extended Local Knowledge (RAG): Index and search .pdf, .docx, .md, and live Website URLs.

Screen Vision & Automation

• Live Translate (Desktop): Drag a box over any window to translate text dynamically.
• System Control: Open apps, create folders, and control system volume/brightness via chat.
• Web Automation: Puppeteer-driven browser control for searching or extracting data.

Plugin System

Mint is highly modular. Manage these integrations from the Settings panel or CLI:

• Spotify, Docker, Obsidian, Google Calendar, DevTools (Git), and more.

---

Project Structure

Mint/
├── src/
│   ├── AI_Brain/        # Gemini integration & Headless Agent
│   ├── Automation/      # Puppeteer and browser scripts
│   ├── CLI/             # CLI Onboarding and Command logic
│   ├── Plugins/         # Spotify, Docker, etc.
│   ├── System/          # Config, Daemon Management, and State
│   └── UI/              # Electron renderer and styles
├── mint-cli.js          # CLI Entry point
├── main.js              # Electron Main process
└── package.json         # Project metadata & Binaries

---

License

Distributed under the GNU Affero General Public License v3.0. See LICENSE for more information.