MADAgent

MADAgent is a lightweight Python launcher for Aider that:

• sets GEMINI_API_KEY
• checks whether aider is available
• installs aider-chat automatically if needed
• launches Aider with:

aider --model gemini/gemini-2.5-flash

It is designed to work from a regular terminal as well as the Android Studio integrated terminal on Windows, Linux, and macOS.

Warning

This tool is intended for temporary educational use only.

Project Structure

madagent/
├── setup.py
├── README.md
├── requirements.txt
├── madagent/
│   ├── __init__.py
│   └── cli.py

Installation

From PyPI:

pip install madagent

From the project root:

pip install .

If your environment uses python -m pip, this also works:

python -m pip install .

Usage

After installation, start the launcher with:

madagent

On startup, the launcher will:

1. print a startup banner
2. export GEMINI_API_KEY
3. verify internet connectivity and confirm the configured Gemini key can generate with the target model
4. check whether aider is installed
5. install aider-chat automatically if aider is missing
6. launch Aider with Gemini Flash

Replace the API Key

Edit the API_KEY constant in madagent/cli.py:

API_KEY = "your-new-gemini-api-key"

Then reinstall the package:

pip install .

If you want to force a reinstall:

pip install --force-reinstall .

If startup says the project is denied access, the current key is not usable for Gemini generation and must be replaced with a working Google AI Studio Gemini API key.

Uninstall

To remove the launcher:

pip uninstall madagent

If you also want to remove Aider installed by the launcher:

pip uninstall aider-chat

Notes

• Authentication uses only the GEMINI_API_KEY environment variable.
• No browser OAuth flow is implemented.
• The launcher uses the current Python interpreter to install aider-chat, which is more reliable than shelling out to a bare pip executable across platforms.
• Before publishing to PyPI, update the placeholder metadata in setup.py, especially author_email and the project_urls values.