MADA User Guide

This user guide will cover installation, configuration, and usage of MADA.

What is MADA?

MADA is a framework designed to facilitate collaboration between multiple specialized agents within a unified system. Built on top of the autogen framework, MADA orchestrates a planning agent that interprets user input and delegates tasks to relevant helper agents. These agents communicate within a group chat environment, enabling dynamic problem-solving and task execution. MADA provides an intuitive interface for users to interact with the agent group, either through the command-line interface or a Gradio-based web interface, streamlining complex workflows and enhancing automation capabilities.

How Does MADA Work?

MADA begins by reading your configuration, which specifies the model for the chat completion client and the agents to include in the group chat. If you are using the Gradio run mode, you can also provide interface settings for customizing the Gradio web application UI.

After the group chat is established, MADA waits for user input. When a prompt is received, a planning agent—added to the group chat automatically—interprets the input and selects the appropriate helper agent to handle the request using an mcp tool call. The helper agent’s response is streamed back to the user through the chosen interface. This interactive process continues until the session ends, either after 10 messages or when the user enters "TERMINATE".