asimovbox 0.1.0

CLI and MCP server for the AsimovBox explainer-video studio

asimovbox

Command-line tool and MCP server for the AsimovBox explainer-video studio. Generate long-form explainer videos programmatically — with the same login and credit billing as the web studio.

Install

pip install asimovbox

Authenticate

Generate a personal API key at asimovbox.com → Account → API access, then:

asimovbox login --token asb_xxxxxxxx
# or set ASIMOVBOX_API_TOKEN / ASIMOVBOX_API_URL in your environment

CLI

asimovbox styles                       # list visual style templates
asimovbox voices                       # list narration voices

# one-shot: create → storyline → render → wait → download
asimovbox make "How DNS works, for beginners" \
  --duration 120 --pacing MEDIUM --style clean_isometric --wait -o dns.mp4

# or step by step
asimovbox create "How TLS works" --style technical_explainer   # -> {id}
asimovbox storyline <id>               # draft script + scenes
asimovbox render <id>                  # charges credits, starts render
asimovbox status <id>                  # poll status; download_url when ready
asimovbox download <id> -o out.mp4

Rendering charges credits against your account, exactly like the web studio.

MCP server

The package installs an asimovbox-mcp stdio server. Add it to an MCP client (e.g. Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "asimovbox": {
      "command": "asimovbox-mcp",
      "env": {
        "ASIMOVBOX_API_URL": "https://asimovbox.com",
        "ASIMOVBOX_API_TOKEN": "asb_xxxxxxxx"
      }
    }
  }
}

Tools: list_style_templates, list_voices, create_video, generate_storyline, update_video, render_video, get_video.

Configuration precedence

explicit flags → environment (ASIMOVBOX_API_URL, ASIMOVBOX_API_TOKEN) → ~/.config/asimovbox/config.json → defaults (https://asimovbox.com).