main

Multi-agent Gradio interface using the improved interface architecture.

This provides a configurable web interface that supports MCP server connections and multi-agent interactions with a better UI design.

create_gradio_app(config_path)

Create a Gradio application from a configuration file.

Parameters:

Name	Type	Description	Default
config_path	str	Path to the configuration file	required

Returns:

Type	Description
Blocks	Gradio Blocks interface

Source code in src/mada/interfaces/gradio/main.py

def create_gradio_app(config_path: str) -> gr.Blocks:
    """
    Create a Gradio application from a configuration file.

    Args:
        config_path: Path to the configuration file

    Returns:
        Gradio Blocks interface
    """
    config = load_config_from_json(config_path)
    client = MCPGradioClientSession(
        model_config=config.model,
        agents=config.agents,
        database_config=config.database,
        mcp_servers=config.mcp_servers,
    )
    gradio_interface = MADAMultiAgentGradioInterface(
        config.interface, config.agents, client
    )
    return gradio_interface.create_interface()

gradio_entrypoint(port, share, config_file)

Entrypoint for the Gradio mode in MADA.

This function loads in a configuration from the user, overrides settings given via the CLI, and starts MADA using Gradio.

Parameters:

Name	Type	Description	Default
port	int | None	Port for Gradio server. Overrides 'interface.port' setting in the configuration file.	required
share	bool	If True, enable Gradio sharing. Overrides 'interface.share' setting in the configuration file.	required
config_file	str	Path to MADA configuration file.	required

Source code in src/mada/interfaces/gradio/main.py

def gradio_entrypoint(port: int | None, share: bool, config_file: str):
    """
    Entrypoint for the Gradio mode in MADA.

    This function loads in a configuration from the user, overrides
    settings given via the CLI, and starts MADA using Gradio.

    Args:
        port: Port for Gradio server. Overrides 'interface.port' setting
            in the configuration file.
        share: If True, enable Gradio sharing. Overrides 'interface.share'
            setting in the configuration file.
        config_file: Path to MADA configuration file.
    """
    # Set up logging first
    setup_logging()

    try:
        print(f"Loading configuration from {config_file}")
        config = load_config_from_json(config_file)

        if not config.interface:
            print(
                "No Gradio interface settings provided. Make sure your configuration file has an 'interface' section."
            )
            sys.exit(2)

        if port is not None:
            config.interface.port = port
        if share:
            config.interface.share = True

        print(f"Launching on port {config.interface.port}")
        run_gradio(config)
    except Exception as e:
        print(f"Error launching Gradio interface: {e}")
        sys.exit(1)

main(port, share, config_file)

Run MADA in Gradio mode.

CONFIG_FILE is the path to the MADA configuration file.

Source code in src/mada/interfaces/gradio/main.py

@click.command(
    name="mada-gradio",
    context_settings={
        "help_option_names": ["-h", "--help"],
    },
)
@click.option(
    "-p",
    "--port",
    type=int,
    help="Port for Gradio server. Overrides 'interface.port' setting in the configuration file.",
)
@click.option(
    "-s",
    "--share",
    is_flag=True,
    help="Enable Gradio sharing. Overrides 'interface.share' setting in the configuration file.",
)
@click.argument(
    "config_file",
    type=str,
)
def main(port: int | None, share: bool, config_file: str) -> None:
    """
    Run MADA in Gradio mode.

    CONFIG_FILE is the path to the MADA configuration file.
    """
    gradio_entrypoint(port, share, config_file)

run_gradio(config)

Launch the Gradio web interface using the provided configuration.

Parameters:

Name	Type	Description	Default
config	AppConfig	The full application configuration object	required

Source code in src/mada/interfaces/gradio/main.py

def run_gradio(config: AppConfig):
    """
    Launch the Gradio web interface using the provided configuration.

    Args:
        config: The full application configuration object
    """
    loop = asyncio.new_event_loop()
    asyncio.set_event_loop(loop)

    # Initialize MCP client session with model and agents configuration
    client = MCPGradioClientSession(
        model_config=config.model,
        agents=config.agents,
        database_config=config.database,
        mcp_servers=config.mcp_servers,
    )
    gradio_interface = MADAMultiAgentGradioInterface(
        config.interface, config.agents, client
    )
    interface = gradio_interface.create_interface()
    interface.queue(max_size=20)

    # Get port and share settings from interface config if available
    port = 7860
    share = False

    if config.interface:
        port = getattr(config.interface, "port", 7860)
        share = getattr(config.interface, "share", False)

    interface.launch(
        server_name="0.0.0.0",
        server_port=port,
        share=share,
        debug=True,
        css=_GRADIO_CSS,
        js=_GRADIO_JS,
    )

setup_logging()

Configure logging for the Gradio interface.

Source code in src/mada/interfaces/gradio/main.py

def setup_logging():
    """Configure logging for the Gradio interface."""
    # Get log level from environment variable, default to INFO
    log_level = os.environ.get("LOG_LEVEL", "INFO").upper()

    # Configure root logger
    logging.basicConfig(
        level=getattr(logging, log_level, logging.INFO),
        format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
        stream=sys.stdout,
        force=True,  # Force reconfiguration
    )

    # Set specific loggers
    logging.getLogger("mada").setLevel(logging.INFO)
    logging.getLogger("mada-gradio").setLevel(logging.INFO)

    # Reduce noise from other libraries
    logging.getLogger("httpx").setLevel(logging.WARNING)
    logging.getLogger("httpcore").setLevel(logging.WARNING)
    logging.getLogger("gradio").setLevel(logging.WARNING)

    print(f"Logging configured at {log_level} level")