manimvox 0.1.0__tar.gz

manimvox-0.1.0/.claude-plugin/marketplace.json

@@ -0,0 +1,15 @@
+{
+  "name": "manimvox",
+  "owner": {
+    "name": "LaplacianAI"
+  },
+  "description": "Narrated, animated explainer videos with Manim and pluggable voices, driven by agent skills.",
+  "plugins": [
+    {
+      "name": "manimvox",
+      "source": ".",
+      "description": "Narrated, animated explainer videos with Manim and pluggable voices, driven by agent skills.",
+      "version": "0.1.0"
+    }
+  ]
+}

manimvox-0.1.0/.claude-plugin/plugin.json

@@ -0,0 +1,19 @@
+{
+  "name": "manimvox",
+  "version": "0.1.0",
+  "description": "Narrated, animated explainer videos with Manim and pluggable voices, driven by agent skills.",
+  "author": {
+    "name": "LaplacianAI"
+  },
+  "homepage": "https://github.com/LaplacianAI/manimvox",
+  "repository": "https://github.com/LaplacianAI/manimvox",
+  "license": "MIT",
+  "keywords": [
+    "manim",
+    "video",
+    "explainer",
+    "tts",
+    "animation",
+    "skills"
+  ]
+}

manimvox-0.1.0/.codex-plugin/plugin.json

@@ -0,0 +1,6 @@
+{
+  "name": "manimvox",
+  "version": "0.1.0",
+  "description": "Narrated, animated explainer videos with Manim and pluggable voices, driven by agent skills.",
+  "skills": "./skills/"
+}

manimvox-0.1.0/.cursor-plugin/plugin.json

@@ -0,0 +1,5 @@
+{
+  "name": "manimvox",
+  "version": "0.1.0",
+  "description": "Narrated, animated explainer videos with Manim and pluggable voices, driven by agent skills."
+}

manimvox-0.1.0/.gitattributes

@@ -0,0 +1 @@
+*.sh text eol=lf

manimvox-0.1.0/.github/scripts/report.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+# Run a command; if it fails, repeat the lines that say why as an annotation, which anyone can read
+# (a run's logs need a GitHub login, its annotations do not).
+set -o pipefail
+log=$(mktemp)
+"$@" 2>&1 | tee "$log"
+code=${PIPESTATUS[0]}
+if [ "$code" -ne 0 ]; then
+  why=$(grep -E "FAILED|ERROR|Error|error:|failed|No solution|not found" "$log" | tail -n 25)
+  [ -z "$why" ] && why=$(tail -n 25 "$log")
+  why=$(printf '%s\n--- last lines ---\n%s' "$why" "$(tail -n 12 "$log")")
+  # an annotation is one line: GitHub turns %0A back into newlines
+  echo "::error title=$1 failed::$(printf '%s\n' "$why" | awk 'BEGIN{ORS="%0A"} {gsub(/\r/, ""); gsub(/%/, "%25"); print}')"
+fi
+exit "$code"

manimvox-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,98 @@
+name: CI
+
+on:
+  push:  # every branch, so a branch is checked before its pull request exists
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  # tests that need real voice engines or downloaded models are opt-in markers; see pyproject.toml
+  FAST: "not slow and not kokoro and not piper"
+  PYTHONUTF8: "1"
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: astral-sh/setup-uv@v7
+      - run: bash .github/scripts/report.sh uv run --no-project --with "ruff>=0.6" ruff check src tests examples
+
+  test:
+    name: test (${{ matrix.os }}, py${{ matrix.python }})
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python: ["3.11", "3.13"]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v5
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: ${{ matrix.python }}
+      - name: System libraries (Linux; EGL and OSMesa let VTK render with no display)
+        if: runner.os == 'Linux'
+        run: >-
+          sudo apt-get update && sudo apt-get install -y libcairo2-dev libpango1.0-dev pkg-config python3-dev
+          libegl1 libosmesa6
+      - name: System libraries (macOS)
+        if: runner.os == 'macOS'
+        run: brew install cairo pkg-config
+      - name: Software OpenGL (Windows runners have no GPU; Windows' own OpenGL is too old for VTK)
+        if: runner.os == 'Windows'
+        uses: pyvista/setup-headless-display-action@v4
+      - run: bash .github/scripts/report.sh uv sync --extra dev --extra kokoro --extra pyvista
+        shell: bash
+      - run: bash .github/scripts/report.sh uv run pytest -m "$FAST" -q -rs
+        shell: bash
+      - name: Manifests are current
+        run: bash .github/scripts/report.sh uv run python -m manimvox.skills manifest --check
+        shell: bash
+
+  render:
+    name: render (${{ matrix.os }})
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v5
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.12"
+      - name: System libraries (Linux)
+        if: runner.os == 'Linux'
+        run: sudo apt-get update && sudo apt-get install -y libcairo2-dev libpango1.0-dev pkg-config python3-dev
+      - name: System libraries (macOS)
+        if: runner.os == 'macOS'
+        run: brew install cairo pkg-config
+      - run: bash .github/scripts/report.sh uv sync --extra dev --extra kokoro
+        shell: bash
+      - name: Render tests (include every block's demo against its preview)
+        run: bash .github/scripts/report.sh uv run pytest -m slow -q -rs
+        shell: bash
+
+  integrations:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.12"
+      - run: sudo apt-get update && sudo apt-get install -y libcairo2-dev libpango1.0-dev pkg-config python3-dev
+      - name: Framework adapters
+        run: >-
+          bash .github/scripts/report.sh uv run --extra dev --extra agno --extra langchain --extra pydantic-ai --extra openai-agents
+          --extra llamaindex --extra haystack --extra google-adk
+          pytest tests/test_integrations.py tests/test_integrations_common.py tests/test_frameworks.py -q -rs
+      - name: CrewAI (conflicts with the OpenAI Agents SDK, so in its own environment)
+        run: >-
+          bash .github/scripts/report.sh uv run --extra dev --extra crewai
+          pytest tests/test_integrations.py tests/test_frameworks.py -q -rs -k "crewai or missing or every_framework"

manimvox-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,40 @@
+name: Release
+
+# Push a tag vX.Y.Z equal to manimvox.__version__ to build and publish to PyPI.
+# PyPI trusts this workflow through trusted publishing: no token is stored in GitHub.
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: astral-sh/setup-uv@v7
+      - name: The tag matches the version
+        run: |
+          version=$(sed -n 's/^__version__ = "\(.*\)"/\1/p' src/manimvox/__init__.py)
+          test "v$version" = "$GITHUB_REF_NAME" || { echo "tag $GITHUB_REF_NAME but __version__ is $version"; exit 1; }
+      - run: uv build
+      - run: uvx twine check dist/*
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/manimvox/
+    permissions:
+      id-token: write  # trusted publishing
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

manimvox-0.1.0/.gitignore

@@ -0,0 +1,8 @@
+__pycache__/
+*.egg-info/
+.venv/
+dist/
+build/
+media/
+.pytest_cache/
+.ruff_cache/

manimvox-0.1.0/AGENTS.md

@@ -0,0 +1,78 @@
+# AGENTS.md
+
+Guide for agents working on this repository. To use manimvox, load the `manimvox` skill instead.
+
+manimvox renders narrated, animated explainer videos with Manim and a text-to-speech voice. It is a Python package (MIT) with a `manimvox` command, and it ships agent skills in `skills/`.
+
+## Layout
+
+```text
+src/manimvox/
+  cli.py            the manimvox command
+  tools.py          typed tools mirroring the CLI, for agents with no shell
+  integrations/     adapters for eight agent frameworks
+  confirm.py        when a download may go ahead without asking
+  playlist.py       index page and share packages
+  project.py        series.json loading and validation
+  scaffold.py       manimvox new
+  runner.py         runs Manim in a subprocess
+  skills.py         skill discovery, manifest generation
+  skills_admin.py   manimvox skills install, check, update, remove
+  templates/        files manimvox new writes
+  kit/              Episode, components, theme, text (what episodes import)
+  scenes/           clips from Pillow, Cairo, Matplotlib, Plotly
+  post/             music bed, captions, cards, join
+  blocks.py         block registry, manimvox add, the preview tool
+  _cairo.py         pycairo helpers shared by scenes and post
+  checks/           theme, layout, audio, contact sheets
+  voice/            the voice interface, cache, downloads, HTTP, audio conversion
+  voice/engines/    one module per text-to-speech engine
+examples/agents/   one script per framework
+blocks/<name>/      block code, demo, block.json, preview.png
+skills/<name>/      agent skills: SKILL.md plus references/
+skills-manifest.json  generated list of the skills
+tests/
+```
+
+## Commands
+
+```bash
+uv sync --extra dev --extra kokoro
+uv run pytest
+uv run ruff check src tests examples
+# framework adapters; CrewAI conflicts with the OpenAI Agents SDK, so it runs in its own environment
+uv run --extra dev --extra agno --extra langchain --extra pydantic-ai --extra openai-agents --extra llamaindex --extra haystack --extra google-adk pytest tests/test_integrations.py tests/test_integrations_common.py tests/test_frameworks.py -q -rs
+uv run --extra dev --extra crewai pytest tests/test_integrations.py tests/test_frameworks.py -q -rs -k "crewai or missing or every_framework"
+uv run python -m manimvox.skills manifest --write   # after any skill edit
+uv run manimvox skills install|check|update|remove  # skills in your coding agents
+uv run python -m manimvox.blocks preview --write|--check [NAME]   # after any block edit
+```
+
+Tests that render with Manim are marked `slow`; tests needing real engines are opt-in markers.
+
+## Rules
+
+- Never commit `docs/specs` or `docs/plans`. They stay local.
+- Skills stay harness-neutral: shell commands and reading files only, no harness tool names, no private or competitor names. `tests/test_skills_lint.py` enforces this with its BANNED list.
+- Where a capability may be missing, a skill gives the plain fallback: helpers one after another; no way to ask means state the choice and continue; no image viewing means `manimvox check layout`.
+- Consent rules live in the skills: ask before installing, downloading a model, fetching from the web or using an online voice; with no way to ask, the answer is no.
+- A new CLI command gets a tool in `manimvox.tools` with the same behaviour, an entry in `COMMANDS`, and a row in the manimvox-cli Tool column; `tests/test_skills_lint.py` and `tests/test_tools.py` enforce this.
+- Every version in the manifests equals `manimvox.__version__`.
+- `npx` installs run the pinned `SKILLS_CLI` in `skills_admin.py`; bump it deliberately.
+- Use Conventional Commits. Run the tests and ruff before committing.
+
+## Skills
+
+| Skill | Kind | For |
+|---|---|---|
+| `manimvox` | router | picks the workflow, checks the setup |
+| `manimvox-paper` | workflow | one document into one video |
+| `manimvox-playlist` | workflow | a codebase or spec into a beginner-to-advanced series |
+| `manimvox-concept` | workflow | a concept with no source into one video |
+| `manimvox-pr` | workflow | a pull request into a short walkthrough |
+| `manimvox-core` | domain | the authoring contract for episode files |
+| `manimvox-creative` | domain | theme, story, narration, facts |
+| `manimvox-animation` | domain | motion patterns |
+| `manimvox-voice` | domain | engines, voices, pronunciation, cloning consent |
+| `manimvox-cli` | domain | commands and their output |
+| `manimvox-blocks` | domain | finding, copying and writing blocks |

manimvox-0.1.0/CLAUDE.md

@@ -0,0 +1 @@
+See [AGENTS.md](AGENTS.md).

manimvox-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LaplacianAI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.