Metadata-Version: 2.4
Name: 3brown1blue
Version: 0.1.0
Summary: Install Manim explainer video skills into Claude Code, Cursor, Windsurf, or GitHub Copilot
Author-email: Amit Subhasish <atsubhas@iu.edu>
License: MIT
Keywords: 3blue1brown,animation,claude,copilot,cursor,explainer,manim,math,visualization,windsurf
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Scientific/Engineering :: Visualization
Requires-Python: >=3.9
Requires-Dist: click>=8.0
Provides-Extra: all
Requires-Dist: anthropic>=0.40; extra == 'all'
Requires-Dist: openai>=1.0; extra == 'all'
Provides-Extra: anthropic
Requires-Dist: anthropic>=0.40; extra == 'anthropic'
Provides-Extra: google
Requires-Dist: openai>=1.0; extra == 'google'
Provides-Extra: groq
Requires-Dist: openai>=1.0; extra == 'groq'
Provides-Extra: mistral
Requires-Dist: openai>=1.0; extra == 'mistral'
Provides-Extra: openai
Requires-Dist: openai>=1.0; extra == 'openai'
Description-Content-Type: text/markdown

# 3brown1blue

Generate Manim animated explainer videos from any topic using an LLM, or install the Manim skill into your AI coding tool.

## Generate a video

```bash
# one-shot, no install needed
uvx '3brown1blue[anthropic]' generate "explain the attention mechanism"
uvx '3brown1blue[openai]' generate "explain backpropagation" --provider openai --render
```

```bash
# or install permanently
pip install '3brown1blue[all]'
3brown1blue generate "explain Fourier transforms" --provider google --render
```

The tool prompts for your provider if you don't pass `--provider`.

## Supported providers

| Provider | Install extra | Env var |
|----------|--------------|---------|
| Anthropic (Claude) | `[anthropic]` | `ANTHROPIC_API_KEY` |
| OpenAI (GPT) | `[openai]` | `OPENAI_API_KEY` |
| Google Gemini | `[openai]` | `GOOGLE_API_KEY` |
| Groq | `[openai]` | `GROQ_API_KEY` |
| Mistral | `[openai]` | `MISTRAL_API_KEY` |

Google, Groq, and Mistral all use the OpenAI-compatible API format.

## Generate options

```
3brown1blue generate TOPIC [OPTIONS]

  --provider  -p  anthropic | openai | google | groq | mistral
  --model     -m  model name (uses provider default if omitted)
  --api-key   -k  API key (or set the provider env var)
  --output    -o  output file  [default: scene.py]
  --render        run manim after generation
  --quality   -q  l=fast | m=medium | h=1080p | k=4K  [default: l]
```

## Install as a coding skill

The skill installs Manim knowledge (24 reference guides + templates) into your AI coding tool so it generates better animations without you prompting it.

```bash
uvx 3brown1blue install
```

Supports: **Claude Code**, **Cursor**, **Windsurf**, **GitHub Copilot**

## Prerequisites

To render animations you need Manim and LaTeX:

```bash
pip install manim
# macOS: brew install mactex
# Linux: apt install texlive-full
# Windows: install MiKTeX
```

## License

MIT
