muapi-cli 0.2.5__tar.gz

muapi_cli-0.2.5/.claude/settings.local.json

@@ -0,0 +1,24 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(gh issue *)",
+      "Bash(curl -sI \"https://github.com/Anil-matcha/muapiapp/releases/download/v0.2.3/muapi-linux-x86_64\")",
+      "Bash(curl -sI \"https://github.com/SamurAIGPT/muapi-cli/releases/download/v0.2.3/muapi-linux-x86_64\")",
+      "Bash(gh release *)",
+      "Bash(npm view *)",
+      "Bash(git -C /Users/anilchandranaidumatcha/Downloads/mu_workflow/muapi-cli status)",
+      "Bash(git -C /Users/anilchandranaidumatcha/Downloads/mu_workflow/muapi-cli remote -v)",
+      "Bash(gh auth *)",
+      "Bash(npm whoami *)",
+      "Bash(git *)",
+      "Bash(tar -xzf muapi-cli-0.2.5.tgz)",
+      "Bash(tar -xzf muapi-cli-0.2.3.tgz)",
+      "Bash(tar -xzf muapi-cli-0.2.4.tgz)",
+      "Bash(rm -rf /tmp/muapi-022-check)",
+      "Bash(mkdir /tmp/muapi-022-check)",
+      "Read(//tmp/**)",
+      "Bash(npm pack *)",
+      "Bash(tar -xzf muapi-cli-0.2.2.tgz)"
+    ]
+  }
+}

muapi_cli-0.2.5/.github/workflows/publish-langchain.yml

@@ -0,0 +1,50 @@
+name: Publish muapi-langchain to PyPI
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "Version to publish (e.g. 0.1.0)"
+        required: true
+
+jobs:
+  publish-langchain:
+    name: Publish muapi-langchain
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: integrations/langchain
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Set version
+        run: |
+          sed -i "s/^version = .*/version = \"${{ github.event.inputs.version }}\"/" pyproject.toml
+          echo "Publishing muapi-langchain ${{ github.event.inputs.version }}"
+
+      - name: Refresh registry data from schema_data.json
+        run: |
+          pip install hatch
+          # schema_data.json is checked in under server/data in this same repo snapshot
+          # fall back to fetching from the live OpenAPI if not present
+          SCHEMA="../../server/data/schema_data.json"
+          SKILLS="../../skills/library"
+          if [ -f "$SCHEMA" ]; then
+            python3 scripts/refresh_registry.py --schema "$SCHEMA" --skills "$SKILLS" 2>/dev/null || true
+          fi
+
+      - name: Build
+        run: hatch build
+
+      - name: Publish
+        run: |
+          pip install twine
+          twine upload dist/* --non-interactive
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_TOKEN }}

muapi_cli-0.2.5/.github/workflows/publish-npm.yml

@@ -0,0 +1,32 @@
+name: Publish to npm
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "Version to publish (e.g. 0.2.4)"
+        required: true
+
+jobs:
+  publish-npm:
+    name: Publish to npm
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          registry-url: "https://registry.npmjs.org"
+
+      - name: Set version
+        run: |
+          jq --arg v "${{ github.event.inputs.version }}" '.version = $v' npm/package.json > /tmp/pkg.json
+          mv /tmp/pkg.json npm/package.json
+          echo "Publishing npm version ${{ github.event.inputs.version }}"
+
+      - name: Publish
+        run: npm publish --access public
+        working-directory: npm
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

muapi_cli-0.2.5/.github/workflows/publish-pypi.yml

@@ -0,0 +1,37 @@
+name: Publish to PyPI
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "Version to publish (e.g. 0.2.5)"
+        required: true
+
+jobs:
+  publish-pypi:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Set version
+        run: |
+          sed -i "s/^version = .*/version = \"${{ github.event.inputs.version }}\"/" pyproject.toml
+          echo "Publishing PyPI version ${{ github.event.inputs.version }}"
+
+      - name: Build
+        run: |
+          pip install hatch
+          hatch build
+
+      - name: Publish
+        run: |
+          pip install twine
+          twine upload dist/* --non-interactive
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_TOKEN }}

muapi_cli-0.2.5/.github/workflows/release.yml

@@ -0,0 +1,180 @@
+name: Release CLI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    name: Build ${{ matrix.artifact }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: macos-latest        # Apple Silicon (arm64)
+            artifact: muapi-darwin-arm64
+
+          - os: ubuntu-22.04        # Linux x86_64
+            artifact: muapi-linux-x86_64
+
+          - os: ubuntu-24.04-arm    # Linux arm64
+            artifact: muapi-linux-arm64
+
+          - os: windows-latest      # Windows x86_64
+            artifact: muapi-windows-x86_64.exe
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install CLI + PyInstaller
+        run: |
+          pip install --upgrade pip
+          pip install .
+          pip install pyinstaller
+
+      - name: Build binary (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          pyinstaller \
+            --onefile \
+            --name muapi \
+            --distpath ./dist \
+            cli_entry.py
+
+      - name: Build binary (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          pyinstaller `
+            --onefile `
+            --name muapi `
+            --distpath ./dist `
+            cli_entry.py
+
+      - name: Rename artifact (Unix)
+        if: runner.os != 'Windows'
+        run: mv dist/muapi dist/${{ matrix.artifact }}
+
+      - name: Rename artifact (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: Move-Item dist\muapi.exe dist\${{ matrix.artifact }}
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ matrix.artifact }}
+          path: dist/${{ matrix.artifact }}
+          retention-days: 1
+
+  release:
+    name: Create GitHub Release
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+
+      - name: Flatten artifact directories
+        run: |
+          mkdir -p release_assets
+          find artifacts -type f -exec cp {} release_assets/ \;
+          chmod +x release_assets/muapi-darwin-* release_assets/muapi-linux-* 2>/dev/null || true
+          ls -lh release_assets/
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.ref_name }}
+          name: muapi-cli ${{ github.ref_name }}
+          body: |
+            ## muapi-cli ${{ github.ref_name }}
+
+            ### Install via npm
+            ```bash
+            npm install -g muapi-cli
+            ```
+
+            ### Install via pip
+            ```bash
+            pip install muapi-cli
+            ```
+
+            ### Manual binary download
+            | Platform | Binary |
+            |---|---|
+            | macOS Apple Silicon | `muapi-darwin-arm64` |
+            | Linux x86_64 | `muapi-linux-x86_64` |
+            | Linux ARM64 | `muapi-linux-arm64` |
+            | Windows x86_64 | `muapi-windows-x86_64.exe` |
+          draft: false
+          prerelease: false
+          files: release_assets/*
+
+  publish-npm:
+    name: Publish to npm
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          registry-url: "https://registry.npmjs.org"
+
+      - name: Set version from tag
+        run: |
+          VERSION="${GITHUB_REF_NAME#v}"
+          jq --arg v "$VERSION" '.version = $v' npm/package.json > /tmp/pkg.json
+          mv /tmp/pkg.json npm/package.json
+          echo "Publishing npm version $VERSION"
+
+      - name: Publish
+        run: npm publish --access public
+        working-directory: npm
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+  publish-pypi:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Set version from tag
+        run: |
+          VERSION="${GITHUB_REF_NAME#v}"
+          sed -i "s/^version = .*/version = \"$VERSION\"/" pyproject.toml
+          echo "Publishing PyPI version $VERSION"
+
+      - name: Build
+        run: |
+          pip install hatch
+          hatch build
+
+      - name: Publish
+        run: |
+          pip install twine
+          twine upload dist/* --non-interactive
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_TOKEN }}

muapi_cli-0.2.5/.gitignore

@@ -0,0 +1,15 @@
+dist/
+build/
+__pycache__/
+*.spec
+*.pyc
+*.pyo
+*.egg-info/
+.eggs/
+*.tgz
+npm/bin/muapi-darwin-arm64
+npm/bin/muapi-darwin-x86_64
+npm/bin/muapi-linux-x86_64
+npm/bin/muapi-linux-arm64
+npm/bin/muapi-windows-x86_64.exe
+.DS_Store

muapi_cli-0.2.5/PKG-INFO

@@ -0,0 +1,337 @@
+Metadata-Version: 2.4
+Name: muapi-cli
+Version: 0.2.5
+Summary: Official CLI for muapi.ai — generative media at your fingertips
+License: MIT
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: keyring>=24.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.12.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-asyncio; extra == 'dev'
+Requires-Dist: respx; extra == 'dev'
+Provides-Extra: release
+Requires-Dist: pyinstaller>=6.0; extra == 'release'
+Description-Content-Type: text/markdown
+
+# muapi CLI
+
+Official command-line interface for [muapi.ai](https://muapi.ai) — generate images, videos, and audio directly from your terminal.
+
+**Agent-first design** — every command works for both humans (colored output, tables) and AI agents (`--output-json`, `--jq` filtering, semantic exit codes, MCP server mode).
+
+## Install
+
+```bash
+# npm (recommended — no Python required)
+npm install -g muapi-cli
+
+# pip
+pip install muapi-cli
+
+# or run without installing
+npx muapi-cli --help
+```
+
+## Quick Start
+
+```bash
+# New user? Create an account
+muapi auth register --email you@example.com --password "..."
+muapi auth verify --email you@example.com --otp 123456
+muapi auth login --email you@example.com --password "..."
+
+# Or paste an existing API key
+muapi auth configure --api-key "YOUR_KEY"
+
+# Generate — pick a curated verb…
+muapi image generate "a cyberpunk city at night" --model flux-dev
+muapi video generate "a dog running on a beach" --model kling-master
+muapi audio create "upbeat lo-fi hip hop for studying"
+
+# …or run any model by endpoint name (schema-driven, covers the whole catalog)
+muapi run flux-dev-image -p "a cyberpunk city at night"
+muapi run seedance-2-text-to-video -p "drone shot over snowy peaks" -i duration=5
+muapi run <model> -h          # introspects the live OpenAPI schema
+
+# Check balance
+muapi account balance
+
+# Wait for an existing job
+muapi predict wait <request_id>
+```
+
+## Commands
+
+### `muapi auth`
+| Command | Description |
+|---------|-------------|
+| `muapi auth register --email x --password y` | Create a new account (sends OTP) |
+| `muapi auth verify --email x --otp 123456` | Verify email after registration |
+| `muapi auth login --email x --password y` | Log in and save API key automatically |
+| `muapi auth forgot-password --email x` | Send password reset OTP |
+| `muapi auth reset-password --email x --otp y --password z` | Reset password |
+| `muapi auth configure` | Manually save an API key |
+| `muapi auth whoami` | Show current API key (masked) |
+| `muapi auth logout` | Remove stored API key |
+
+### `muapi account`
+| Command | Description |
+|---------|-------------|
+| `muapi account balance` | Show current credit balance |
+| `muapi account topup --amount 20` | Add credits via Stripe checkout |
+
+### `muapi keys`
+| Command | Description |
+|---------|-------------|
+| `muapi keys list` | List all API keys on your account |
+| `muapi keys create --name label` | Create a new API key (shown once) |
+| `muapi keys delete <id>` | Delete an API key by ID |
+
+### `muapi image`
+| Command | Description |
+|---------|-------------|
+| `muapi image generate <prompt>` | Text-to-image generation |
+| `muapi image edit <prompt> --image <url>` | Image-to-image editing |
+| `muapi image models` | List available models |
+
+**Models:** `flux-dev`, `flux-schnell`, `flux-kontext-dev/pro/max`, `hidream-fast/dev/full`, `wan2.1`, `reve`, `gpt4o`, `midjourney`, `seedream`, `qwen`
+
+### `muapi video`
+| Command | Description |
+|---------|-------------|
+| `muapi video generate <prompt>` | Text-to-video generation |
+| `muapi video from-image <prompt> --image <url>` | Image-to-video animation |
+| `muapi video models` | List available models |
+
+**Models:** `veo3`, `veo3-fast`, `kling-master`, `kling-std`, `kling-pro`, `wan2.1/2.2`, `seedance-pro/lite`, `hunyuan`, `runway`, `pixverse`, `vidu`, `minimax-std/pro`
+
+### `muapi audio`
+| Command | Description |
+|---------|-------------|
+| `muapi audio create <prompt>` | Create music with Suno |
+| `muapi audio remix <song-id>` | Remix an existing Suno song |
+| `muapi audio extend <song-id>` | Extend a Suno song |
+| `muapi audio from-text <prompt>` | Generate audio with MMAudio |
+| `muapi audio from-video <video-url>` | Add AI audio to a video |
+
+### `muapi enhance`
+| Command | Description |
+|---------|-------------|
+| `muapi enhance upscale <url>` | AI image upscaling |
+| `muapi enhance bg-remove <url>` | Remove background |
+| `muapi enhance face-swap --source <url> --target <url>` | Face swap image/video |
+| `muapi enhance skin <url>` | Skin enhancement |
+| `muapi enhance colorize <url>` | Colorize B&W photo |
+| `muapi enhance ghibli <url>` | Ghibli anime style |
+| `muapi enhance anime <url>` | Anime style conversion |
+| `muapi enhance extend <url>` | Outpaint/extend image |
+| `muapi enhance product-shot <url>` | Professional product photo |
+| `muapi enhance erase <url> --mask <url>` | Object removal |
+
+### `muapi edit`
+| Command | Description |
+|---------|-------------|
+| `muapi edit effects --video <url> --effect <name>` | AI video/image effects |
+| `muapi edit lipsync --video <url> --audio <url>` | Lip sync to audio |
+| `muapi edit dance --image <url> --video <url>` | Make person dance |
+| `muapi edit dress --image <url>` | Change clothing |
+| `muapi edit clipping <video-url>` | AI highlight extraction |
+
+### `muapi run` — generic, schema-driven runner
+
+Reaches **any** model in the muapi.ai catalog by endpoint name, even ones not covered by the curated `image / video / audio / enhance / edit` verbs. The input schema is fetched from the live OpenAPI spec, so `muapi run <model> -h` always reflects the real, current parameters.
+
+| Command | Description |
+|---------|-------------|
+| `muapi run <model> -h` | Print model-specific inputs from the live OpenAPI schema |
+| `muapi run <model> -p "..."` | Run with a prompt |
+| `muapi run <model> -p "..." -i k=v -i k=v` | Pass arbitrary inputs (JSON-parsed when valid) |
+| `muapi run <model> --input-file inputs.json` | Inputs from a JSON file |
+| `muapi run <model> ... --dry-run` | Show the request body without sending |
+
+`<model>` accepts either a real endpoint slug (`flux-dev-image`, `nano-banana-2`, `seedance-2-text-to-video`) or a short alias from the curated tables (`flux-dev`, `seedream`, `kling-master`).
+
+**Merge order for inputs** (later wins): `--input-file` → `-i k=v` → `-p prompt`.
+
+```bash
+# Discover a model's real inputs
+muapi run nano-banana-2 -h
+
+# Run it
+muapi run nano-banana-2 -p "a logo for a coffee shop" -i num_images=2 --download ./out
+
+# Pipe-safe JSON
+muapi run flux-dev-image -p "..." --output-json --jq '.outputs[0]'
+```
+
+### `muapi predict`
+| Command | Description |
+|---------|-------------|
+| `muapi predict result <id>` | Fetch current status (no polling) |
+| `muapi predict wait <id>` | Wait until complete |
+
+### `muapi upload`
+| Command | Description |
+|---------|-------------|
+| `muapi upload file <path>` | Upload a local file → get hosted URL |
+
+### `muapi models`
+| Command | Description |
+|---------|-------------|
+| `muapi models list` | List all models |
+| `muapi models list --category video` | Filter by category |
+
+### `muapi config`
+| Command | Description |
+|---------|-------------|
+| `muapi config set <key> <value>` | Set a persistent default |
+| `muapi config get <key>` | Read a config value |
+| `muapi config list` | Show all config |
+
+**Useful keys:** `output` (json/human), `model.image`, `model.video`, `no_color` (true/false)
+
+### `muapi docs`
+| Command | Description |
+|---------|-------------|
+| `muapi docs openapi` | Fetch the full OpenAPI spec |
+| `muapi docs open` | Open Swagger UI in browser |
+
+### `muapi mcp`
+| Command | Description |
+|---------|-------------|
+| `muapi mcp serve` | Start MCP server (stdio) for AI agents |
+
+## Global Options
+
+| Flag | Description |
+|------|-------------|
+| `--wait / --no-wait` | Poll until done (default: `--wait`) |
+| `--output-json` / `-j` | Print raw JSON response |
+| `--jq <expr>` | Filter JSON output (e.g. `'.outputs[0]'`) |
+| `--download <dir>` / `-d` | Auto-download outputs to directory |
+| `--no-color` | Disable colored output |
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `MUAPI_API_KEY` | API key (overrides keychain/config) |
+| `MUAPI_BASE_URL` | Override API base URL |
+| `NO_COLOR` | Disable colored output |
+
+## Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| `0` | Success |
+| `1` | General error |
+| `3` | Authentication error |
+| `4` | Rate limited |
+| `5` | Not found |
+| `6` | Billing error |
+| `7` | Timeout |
+| `8` | Validation error |
+
+## MCP Server
+
+muapi supports two MCP transport modes. Both expose the same **19 tools**: image generate/edit, video generate/from-image, audio create/from-text, enhance (upscale/bg-remove/face-swap/ghibli), edit lipsync/clipping, predict result, upload file, keys list/create/delete, account balance/topup.
+
+### Option 1 — Hosted (Recommended, no CLI required)
+
+The hosted MCP server at `https://api.muapi.ai/mcp` uses the standard Streamable HTTP transport. Any MCP client can connect with just your API key — no CLI install needed.
+
+**Claude Code:**
+```bash
+claude mcp add --transport http muapi \
+  https://api.muapi.ai/mcp \
+  --header "Authorization: Bearer YOUR_MUAPI_KEY"
+```
+
+**Cursor** — add to `mcp.json` (`Cmd+Shift+P` → Open MCP settings):
+```json
+{
+  "mcpServers": {
+    "muapi": {
+      "url": "https://api.muapi.ai/mcp",
+      "headers": { "Authorization": "Bearer YOUR_MUAPI_KEY" }
+    }
+  }
+}
+```
+
+**Windsurf** — open **Settings → MCP**:
+```json
+{
+  "mcpServers": {
+    "muapi": {
+      "serverUrl": "https://api.muapi.ai/mcp",
+      "headers": { "Authorization": "Bearer YOUR_MUAPI_KEY" }
+    }
+  }
+}
+```
+
+### Option 2 — stdio via CLI (Claude Desktop)
+
+Run the CLI as a local stdio MCP server. Requires the CLI to be installed.
+
+```bash
+muapi mcp serve
+```
+
+**Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+```json
+{
+  "mcpServers": {
+    "muapi": {
+      "command": "muapi",
+      "args": ["mcp", "serve"],
+      "env": { "MUAPI_API_KEY": "your-key-here" }
+    }
+  }
+}
+```
+
+**Any stdio-compatible client** — use the `command` + `args` pattern above, substituting your client's config format.
+
+> For more details on the self-hosted MCP server see [muapi-mcp-server](https://github.com/SamurAIGPT/muapi-mcp-server).
+
+## Agentic Pipeline Examples
+
+```bash
+# Full onboarding without human intervention
+muapi auth register --email agent@example.com --password "secret"
+muapi auth verify --email agent@example.com --otp 123456
+muapi auth login --email agent@example.com --password "secret"
+muapi account balance --output-json
+muapi account topup --amount 10 --output-json --no-open
+
+# Submit async, capture request_id, poll when ready
+REQUEST_ID=$(muapi video generate "a dog on a beach" \
+  --model kling-master --no-wait --output-json --jq '.request_id' | tr -d '"')
+muapi predict wait "$REQUEST_ID" --download ./outputs
+
+# Chain: upload → edit → download
+URL=$(muapi upload file ./photo.jpg --output-json --jq '.url' | tr -d '"')
+muapi image edit "make it look like a painting" --image "$URL" \
+  --model flux-kontext-pro --download ./outputs
+
+# Rotate API keys programmatically
+NEW_KEY=$(muapi keys create --name "ci-$(date +%Y%m%d)" --output-json --jq '.api_key' | tr -d '"')
+OLD_ID=$(muapi keys list --output-json --jq '.[0].id')
+muapi keys delete "$OLD_ID" --yes
+
+# Discover available endpoints
+muapi docs openapi --jq '.paths | keys[]'
+```
+
+## Shell Completions
+
+```bash
+muapi --install-completion bash
+muapi --install-completion zsh
+muapi --install-completion fish
+```