Metadata-Version: 2.4
Name: asimovbox
Version: 0.3.0
Summary: CLI and MCP server for the AsimovBox explainer-video studio
Author: AsimovBox
License: MIT
Project-URL: Homepage, https://asimovbox.com
Project-URL: Repository, https://github.com/cerebrixos-org/asimovbox-cli
Keywords: video,ai,explainer,mcp,cli,asimovbox
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28
Requires-Dist: mcp>=1.2

# asimovbox

Command-line tool and MCP server for the [AsimovBox](https://asimovbox.com) explainer-video studio. Generate long-form explainer videos programmatically — with the same login and credit billing as the web studio.

## Install

```bash
pip install asimovbox
```

## Authenticate

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

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

## CLI

```bash
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`):

```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`).
