Mado is a Python TUI (Terminal User Interface) built with Textual and Rich that provides a seamless conversational experience with LLMs. What sets Mado apart is its dynamic tooling system - drop Python snippets into ~/.config/mado/tools.d/ and they instantly become available to your AI assistant.
  • Python 98.4%
  • Makefile 0.7%
  • Nix 0.3%
  • Shell 0.3%
  • Ruby 0.2%
Find a file
Mike 'Fuzzy' Partin 0054433ab4 feat: enhance API key resolution with improved env var fallbacks and clearer priority logic
# Previous message:
fix: respect api_key from profile config and unify env var resolution

Co-authored-by: aider (anthropic/claude-sonnet-4-6) <aider@aider.chat>
2026-03-13 05:58:10 -07:00
.github/workflows feat: add packaging and distribution infrastructure 2026-03-11 07:43:15 -07:00
docs docs: complete documentation for user and developer guides 2026-03-11 06:27:34 -07:00
mado feat: enhance API key resolution with improved env var fallbacks and clearer priority logic 2026-03-13 05:58:10 -07:00
packaging feat: add packaging and distribution infrastructure 2026-03-11 07:43:15 -07:00
tests feat: add comprehensive integration and unit tests for conversation, MCP, and tool systems 2026-03-11 05:42:43 -07:00
.gitignore chore: add build* to gitignore pattern 2026-03-12 03:51:22 -07:00
.pre-commit-config.yaml feat: initialize project foundation and development tools 2026-03-11 02:14:56 -07:00
Dockerfile feat: add packaging and distribution infrastructure 2026-03-11 07:43:15 -07:00
LICENSE feat: add packaging and distribution infrastructure 2026-03-11 07:43:15 -07:00
Makefile feat: add help target to makefile with available targets documentation 2026-03-11 07:47:04 -07:00
MANIFEST.in feat: add package manifest and update build configuration 2026-03-11 08:03:55 -07:00
pyproject.toml feat: add package manifest and update build configuration 2026-03-11 08:03:55 -07:00
README.md feat: add packaging and distribution infrastructure 2026-03-11 07:43:15 -07:00
ROADMAP.md feat: add packaging and distribution infrastructure 2026-03-11 07:43:15 -07:00

Mado

A modern TUI for interacting with LLMs, featuring tools, MCP integration, and multi-profile support.

Installation

pip install mado

Usage

Run mado to start the terminal user interface.

Documentation

See the docs directory for detailed guides.