SamurAIGPT/muapi-cli

What it solves

muapi CLI provides a unified command-line interface to access a wide variety of generative AI models for images, video, and audio. It eliminates the need to switch between different platforms or write custom API integrations for various providers, allowing users to generate content directly from the terminal.

How it works

The tool acts as a CLI wrapper around the muapi.ai API, providing curated commands for common tasks (like image generate or video generate) and a generic run command that can dynamically fetch the OpenAPI schema to interact with any model in the catalog. It supports both human-readable output and machine-readable JSON for integration into scripts and AI agents.

Who it’s for

• Developers and Power Users: Those who prefer the terminal over GUIs for content generation.
• AI Agents: The CLI is designed for programmatic access, featuring JSON output, semantic exit codes, and a dedicated MCP (Model Context Protocol) server mode to integrate with agents like Claude or Cursor.
• Content Creators: Users who want to automate image, video, and audio generation pipelines.

Highlights

• Multimodal Generation: Supports text-to-image, text-to-video, image-to-video, and music generation (via Suno).
• Agent-First Design: Includes --output-json and --jq filtering for easy piping and automation.
• MCP Server Support: Can be run as a local stdio server or connected via a hosted HTTP transport to provide AI agents with 19 different generative tools.
• Schema-Driven Execution: The muapi run command allows users to introspect live API parameters for any model in the catalog.
• AI Enhancement Tools: Built-in commands for upscaling, background removal, face-swapping, and style conversion (e.g., Ghibli or Anime styles).