# Claude Video Studio

Estúdio de edição e criação de vídeo **dirigido por prompt** com Claude Code —
100% local e gratuito no Windows: FFmpeg, MLT/Shotcut, faster-whisper,
DeepFilterNet, MediaPipe, Kokoro e HyperFrames — além de geração de música
(ACE-Step 1.5) e de vídeo (Wan 2.2 no ComfyUI) por IA — orquestrados por um
servidor MCP próprio.

```
"edite o vídeo de source em formato Reels, tire os silêncios e vícios,
 coloque o título 'Santidade Integral' e legenda com palavra destacada"
```

O agente normaliza a gravação do celular, transcreve na GPU, decide os cortes
lendo a transcrição, monta uma timeline que **abre no Shotcut** para ajuste
manual, confere frames visualmente e renderiza com NVENC, legenda e loudness
padrão de redes sociais.

## Estrutura

```
claude-video-studio/
├── agent/            estúdio: MCP server, CLI, skills, regras dos agentes, instalador
│   ├── bin/claude-code.bat      launcher (no PATH)
│   ├── src/videostudio/         pacote Python (MCP `video-studio` + CLI `vstudio`)
│   ├── .claude/skills/          skills do estúdio + HyperFrames
│   ├── .mcp.json                MCPs: video-studio, shotcut, kinocut
│   ├── CLAUDE.md                manual de operação dos agentes
│   └── install.ps1              instalador completo
├── projects/         um diretório por projeto de vídeo (conteúdo fora do git)
│   └── CLAUDE.md                importa agent/CLAUDE.md em todas as sessões
└── docs/             instalação, uso, arquitetura, renomear
```

## Começo rápido

```powershell
git clone https://github.com/AlexandreRL/claude-video-studio.git
cd claude-video-studio
powershell -ExecutionPolicy Bypass -File .\agent\install.ps1 -WithGenerative
# abra um novo terminal
claude-code
```

`claude-code` → **[1] Trabalhar em um projeto de vídeo** → **[N]** cria o projeto
→ copie os brutos para `source/` → converse com o Claude.

## Documentação

| Documento | Conteúdo |
|---|---|
| [docs/INSTALACAO.md](docs/INSTALACAO.md) | Requisitos, instalador, o que é instalado, solução de problemas |
| [docs/USO.md](docs/USO.md) | Launcher, fluxo de trabalho, exemplos de pedidos, CLI |
| [docs/ARQUITETURA.md](docs/ARQUITETURA.md) | Camadas, decisões técnicas, spec de timeline, ferramentas MCP |
| [docs/RENOMEAR.md](docs/RENOMEAR.md) | Renomear o repositório no GitHub e a pasta local |
| [agent/CLAUDE.md](agent/CLAUDE.md) | Regras e metodologia seguidas pelos agentes |

## Licença

MIT. Componentes de terceiros mantêm suas licenças (ver docs/ARQUITETURA.md).