# 🎬 Auto Director
> **The Agentic Video Generation Framework.**
> A hybrid engine designed for AI Agents to autonomously direct, edit, and render high-quality promotional videos for any software project.
[](https://github.com/naki0227/auto_CM_director)
[](https://www.remotion.dev/)
**🎥 Watch the Demo:** [YouTube](https://youtu.be/Mn3K0VySiSc)
---
## ⚡️ Quick Start
### For Humans 🧑💻
Instantly initialize Auto Director in your repository.
```bash
npx auto-director init
```
This will:
1. Ask for your project name & theme (Cyberpunk / Minimal / Playful).
2. Scaffold a `video/` directory with the engine.
3. Generate a starter `director.json`.
Then, render your video:
```bash
cd my-video-project
npm install
npm run build -- --props=./director.json
```
---
### For Agents 🤖
If you are an AI (Claude, ChatGPT, etc.) using this tool via MCP (Model Context Protocol):
**1. Install the MCP Server**
Add this to your client configuration:
```json
{
"mcpServers": {
"auto-director": {
"command": "node",
"args": ["/path/to/auto-director/packages/mcp-server/dist/index.js"]
}
}
}
```
**2. Use the Tool**
Call `generate_commercial` with the repository context.
---
## 🧠 The Hybrid Architecture
Unlike traditional "Text-to-Video" tools that hallucinate random clips, Auto Director uses a **Hybrid Template Engine**:
1. **AI (The Creative Director):** Analyzes the repository, extracts the "Vibe" (Cyberpunk, Minimal, Playful), and generates a structured `director.json` configuration.
2. **Engine (The Renderer):** A robust Remotion-based Universal Template renders the video with high-end animations, guaranteeing a perfect compile every time.
## 🎨 Themes
| Theme | Vibe | Best For |
| :--- | :--- | :--- |
| **Cyberpunk** | Glitch, Neon, Dark Mode | Crypto, DevTools, CLI |
| **Minimal** | Clean, Helvetica, Fade | SaaS, Notion Templates |
| **Playful** | Bouncy, Pastel, Rounded | Consumer Apps, Games |
## 🛠 Project Structure
```bash
.
├── bin/ # CLI Entry Point
├── packages/ #
│ └── mcp-server/ # Model Context Protocol Server
├── src/
│ ├── templates/ # UniversalCommercial.tsx (The Core)
│ ├── components/ # Reusable UI (KineticText, MacWindow)
│ └── Scenes/ # Feature implementations
└── director.json # The "Script" (AI generates this)
```
## 🤖 Agent Registration (Advanced)
To make this repository discoverable by other AI agents (Claude, Windsurf, etc.), we recommend registering it on **Glama** or **Smithery**.
### **Recommended: Glama**
1. Go to [Glama MCP Servers](https://glama.ai/mcp/servers).
2. Log in with GitHub.
3. Click **"Add Server"** and select the `auto_CM_director` repository.
4. The system will automatically detect the capabilities via the included configuration file.
### **Alternative: Smithery**
1. Go to [Smithery](https://smithery.ai/server/register).
2. Submit the repository URL: `https://github.com/naki0227/auto_CM_director`.
## 🤝 Contributing
We welcome Pull Requests from both biological and artificial intelligence.
See [CONTRIBUTING.md](./CONTRIBUTING.md) for the Agentic Guide.
---
**License:** MIT
**Created by:** You & Your Agents.
