creaper

creaper

Deixe o Claude compor, mixar e analisar no REAPER.

O creaper conecta o Claude ao seu projeto REAPER aberto. Você pede em linguagem simples; o Claude lê o projeto, escreve MIDI, monta cadeias de FX, configura roteamento e mede o áudio real antes de dar feedback de mixagem.

"Faça uma progressão lo-fi de 8 compassos em Ré menor em uma nova faixa de Keys, com uma batida de bateria com swing por baixo."

"Esboce uma bossa nova em Fá: acompanhamento de violão, baixo quase walking, uma melodia que eu possa cantar."

"Reharmonize meu refrão com substituições de trítono e me diga o que cada mudança faz."

"O refrão está turvo. Meça a mixagem dos compassos 33 a 49 e me diga por quê."

"Coloque um compressor no vocal: threshold −18 dB, 4:1, e envie para um bus de reverb a −12."

"Toque os compassos 17 a 25 para eu ouvir."

Cada mudança é uma etapa de desfazer nomeada (creaper: add ReaComp to Vocal), então Ctrl+Z desfaz qualquer coisa que o Claude fez.

Funciona com Claude Desktop, Claude Code e qualquer outro aplicativo que suporte o Model Context Protocol. Cada usuário entra com sua própria conta Claude; nenhuma chave de API é necessária.

O que o Claude pode fazer

Área	Ferramentas
Ler o projeto	Visão geral (tempo, fórmula de compasso, marcadores, regiões, faixas, seleção), detalhes de faixa (itens, FX, envios), parâmetros de FX, plugins instalados
Compor	Criar faixas com instrumentos, itens MIDI e notas; partes de acordes a partir de símbolos (Am7, Cmaj7/E) ou numerais romanos (ii7-V7/V-bVII) em 11 voicings e 20 ritmos de acompanhamento; linhas de baixo em 18 estilos; melodias baseadas em motivos; grooves de bateria por gênero; um esboço de gênero inteiro em uma única chamada; sustain/mod/expression/pitch bend/aftertouch, mudanças de programa com bank select, leitura e limpeza de controladores, marcadores e regiões
Teoria musical	Escalas e modos escritos corretamente, nomenclatura de acordes, análise de numerais romanos e harmonia (de símbolos ou do seu MIDI), detecção de tonalidade, cadências, sugestões de progressão, reharmonização, condução de vozes a quatro partes e um verificador de regras, rotas de modulação, ritmos (clave, euclidianos, polirritmias)
Plugins	Navegar por plugins instalados por tipo, categoria e desenvolvedor; carregar instrumentos e efeitos por nome aproximado; ler e definir parâmetros por valor ou por rótulo, vários de uma vez; listar e carregar presets; dividir instrumentos multi-saída em faixas
Biblioteca de sons	Salvar o som atual de qualquer plugin com um nome e tags, navegar e recuperá-lo em qualquer faixa de qualquer projeto
Editar MIDI	Quantizar (grade, força, swing), humanizar, transpor, ajustar a uma escala, definir ou criar rampas de velocity, dedilhar acordes, legato e desenvolvimento de motivos (transposição diatônica, inversão, retrógrado, aumento, linhas de harmonia, sequências, harmonia negativa); em todas as notas, em um intervalo de altura/tempo ou no que estiver selecionado no editor MIDI
Automatizar	Volume, pan e qualquer parâmetro de plugin: pontos, rampas (um sweep de filtro durante o build) ou LFOs (wobbles, tremolo), em unidades reais; ler e limpar envelopes
Editar clipes	Mover, cortar, dividir, duplicar, aplicar fade, reafinar, esticar no tempo e excluir itens de áudio ou MIDI; importar arquivos de áudio
Vocais	Usa a melhor fonte disponível na sua máquina: recorta amostras vocais reais em chops rítmicos e na tonalidade; entrega melodia e letra a sintetizadores de canto (Synthesizer V, ACE Studio, VOCALOID, OpenUtau) como MIDI com as palavras nas notas; ou canta a letra ele mesmo como talk box ou vocoder usando as vozes do seu computador
Gravar	Entradas de interface de áudio e dispositivos MIDI; armar, monitorar e definir o modo de gravação (entrada, reamostrar a saída da faixa, overdub/substituição MIDI); gravar um intervalo de compassos que para sozinho; escolher, comparar ou explodir takes. O Claude avisa antes de o REAPER perguntar quais novos arquivos manter e espera enquanto você responde
Salvar e entregar	Salvar, salvar como e cópias de snapshot; exportar a mixagem (ou uma região ou intervalo de compassos) para WAV/FLAC/MP3/OGG (qualidade Vorbis de sua escolha) com loudness e pico verdadeiro verificados e sem clipping; stems para cada faixa, alinhados; uma verificação de que o final combina com o uso (sem fade ou silêncio para faixas que um jogo ou playlist faz crossfade, um final real para um finale, um stinger firme)
Temas entre músicas	Salvar um motivo (o tema característico de um jogo ou álbum) e colocá-lo em qualquer música posterior, na tonalidade e modo dessa música, mais lento, mais rápido ou em outra oitava
Arranjo	Mudanças de tempo, rampas e mudanças de fórmula de compasso ao longo da música; marcadores e regiões (adicionar, renomear, mover, redimensionar, recolorir, excluir); seleção de tempo, pontos de loop e repetição; templates de faixa; congelar e descongelar faixas pesadas
Amostras e loops	Pesquisar suas pastas de amostras por nome, função, tempo e tonalidade, com cada resultado verificado de ouvido; colocar loops esticados no tempo do projeto e transportados para a tonalidade; montar kits de bateria a partir de qualquer amostra no sampler do REAPER
Roteamento	Um mapa de pastas, envios, sidechains e saídas; pastas; envios; master-send ligado/desligado
Mixagem	Uma primeira mixagem completa em uma única chamada (auto_mix): cada faixa medida e recebendo um papel, depois níveis para o gênero, cortes de high-pass e de lama, compressão, pan, reverb, sidechain, headroom e vocais robóticos mantidos longe das partes que os cobrem. Além disso, adicionar, remover, bypassar FX; volume, pan, mute, solo, cor; envios; ducking por sidechain (calibrado a uma profundidade), buses de submix, compressão paralela, uma cadeia vocal inicial, masterização para um alvo de loudness
Gêneros	265 perfis de gênero, de house e drill a bebop, flamenco, amapiano e barroco: como cada um é composto, tocado, arranjado e mixado, e uma verificação da sua mixagem contra um deles
Lembrar	Notas que o Claude mantém entre sessões: seu gosto, peculiaridades de plugins, lições de mixagem
Verificar medindo	O Claude não pode ouvir, então ele mede o que um ouvinte notaria: quão compreensíveis são as palavras de um vocal, sozinho e na mixagem (STOI); se cada parte está afinada; e uma imagem de espectrograma da música que ele pode olhar
Analisar	Renderizar a mixagem ou uma faixa e medir loudness integrada/de curto prazo (LUFS), faixa dinâmica, pico verdadeiro, clipping, fator de crista, correlação estéreo (incluindo as frequências graves) e equilíbrio de frequência por banda e oitava, com uma linha do tempo de loudness em compassos
Controlar	Tocar um intervalo de compassos, parar, mover o cursor, desfazer, executar qualquer ação do REAPER

No Claude Desktop e no Claude Code, o creaper também adiciona cinco comandos: Compor em um gênero, Criticar a mixagem, Mixar a música, Masterizar a música e Projetar um som.

Teoria musical e gêneros

O creaper dá ao Claude um kit de ferramentas de compositor, para que ele trabalhe a partir da teoria em vez de adivinhar:

• Tonalidades e grafia. Cerca de 60 escalas e modos (modos eclesiásticos, modos menores melódico e harmônico, bebop, escalas pentatônicas e simétricas, e versões de 12 tons de maqam, raga e escalas japonesas), com notas escritas como um músico as escreve: Mi# em Fá# maior, Si♭♭ em um Dó dim7.
• Análise. Numerais romanos com inversões, dominantes secundárias, acordes emprestados, substitutos de trítono, a sexta napolitana e as sextas aumentadas; cadências; detecção de tonalidade; progressões famosas reconhecidas pelo nome. analyze_harmony lê um item MIDI no seu projeto e o explica, incluindo notas de passagem, suspensões e apogiaturas de uma melodia.
• Escrita. Progressões por gênero ou clima (uma biblioteca de cerca de 50 nomeadas, além de novas a partir de harmonia funcional), 15 técnicas de reharmonização, voicings de posição fechada a sem raiz e quartais, escrita a quatro partes que segue as regras de condução de vozes da prática comum, linhas de baixo (walking, 808, tumbao, one-drop...), acompanhamento (stabs, skank, bossa, montuno, dedilhado, arpejos...) e melodias construídas a partir de um motivo desenvolvido ao longo de frases.
• 265 gêneros em 20 famílias. Cada perfil tem a época e as referências do estilo, andamento, feel e swing, modos, progressões típicas e ritmo harmônico, voicing, acompanhamento, hábitos de baixo e melodia, um groove de bateria, forma de música com contagem de compassos, instrumentos, design de som, hábitos de produção e alvos de mixagem. sketch_song transforma um perfil em bateria, baixo, acordes e melodia em novas faixas em uma única chamada.

Estas são regras práticas extraídas dos discos que definem cada estilo, não leis.

Funciona com seus plugins

O creaper usa o que estiver instalado: VST, VST3, CLAP, AU e JS, instrumentos e efeitos.

• Aprende o que seus plugins fazem testando-os. scan_plugins carrega cada plugin em uma faixa temporária oculta, toca notas em instrumentos e um sinal de teste através de efeitos, e mede o resultado: sintetizador com pitch ou kit de bateria, extensão e caráter; cauda de reverb ou delay, compressão ou gating, curva de EQ, saturação, modulação, pitch shift, largura estéreo, latência. As descobertas vão para um catálogo (get_plugin_catalog, e ao lado de cada plugin em list_installed_fx), para que o Claude escolha plugins pelo que eles fazem, não pelos nomes.
• Conhece sua biblioteca. O Claude pode navegar por plugins por tipo, categoria ("quais reverbs eu tenho?") e desenvolvedor. Um plugin instalado em vários formatos aparece uma vez e carrega como CLAP ou VST3 primeiro. Nomes aproximados funcionam: "FET-76" encontra Comp FET-76. Nomes ambíguos retornam com os candidatos em vez de um palpite.
• Fala a língua de cada plugin. Os parâmetros são definidos nas unidades e rótulos do próprio plugin: -18 dB, 2500 Hz, ou texto para chaves e menus ("Saw", "Low Pass", "16'"). Várias configurações podem mudar em uma única etapa de desfazer. Os milhares de parâmetros placeholder "MIDI CC" que muitos plugins VST3 expõem ficam ocultos.
• Presets. Programas de fábrica e presets salvos no REAPER podem ser listados e carregados. Plugins que mantêm presets no próprio navegador (Arturia, por exemplo) são detectados, e o Claude se oferece para abrir a janela do plugin em vez disso.
• Sua própria biblioteca de sons. Escolha um som no navegador de qualquer plugin e diga ao Claude "salve isto como Dark Pad". O creaper captura o estado completo do plugin com tags e uma descrição, e o Claude pode recuperá-lo em qualquer faixa, em qualquer projeto ("use um pad quente da minha biblioteca"). Plugins que não compartilham seu estado são salvos como valores de parâmetros. A biblioteca fica em <REAPER resource path>/creaper/sounds/.
• Kits mapeados de ouvido. map_drum_kit toca cada tecla de um instrumento de bateria offline, identifica cada som (bumbo, caixa, clap, chimbal, pratos, tons, rim, percussão) e salva o layout. Ele compara sons dentro do kit e verifica o layout General MIDI que a maioria dos kits comerciais usa; em kits de amostras reais reservados, ele acerta cerca de 84% das pistas para layouts General MIDI e cerca de metade para os personalizados, e diz em qual caso está. audition_instrument relata o que um patch faz: extensão, rastreamento de pitch, envelope, timbre.
• Bateria em qualquer kit. Padrões de bateria seguem os nomes de notas do próprio instrumento quando ele os reporta ("Kick", "HH Closed"...). Caso contrário, o creaper usa um mapa de bateria que você salvou para aquele instrumento (que também pode colocar cada bateria em seu próprio canal MIDI) e, então, General MIDI. Cada padrão reporta qual nota cada pista usou, então um palpite errado é fácil de ver e corrigir.
• Instrumentos multi-saída. Drum machines, Elektron Overbridge, sintetizadores multitimbricos: split_instrument_outputs dá a cada saída sua própria faixa, nomeada segundo as saídas do plugin (ex.: Rytm - BD 1, Rytm - SD 2).
• Plugins de hardware. Plugins que o REAPER marca como somente em tempo real (ex.: Overbridge) não podem ser renderizados offline. A análise avisa quando eles estariam ausentes de uma medição.

Mapas de bateria são salvos em <REAPER resource path>/creaper/drum_maps.json. Alguns instrumentos são conhecidos de fábrica (atualmente SILA: cada pista em seu próprio canal MIDI); um mapa que você salvar com o mesmo nome substitui o integrado. O Claude prefere um instrumento de bateria real ao ReaSynDr básico do REAPER e pula plugins somente de hardware, a menos que você diga que o dispositivo está conectado.

Trabalhos de mixagem, medidos

Os trabalhos de uma única chamada foram verificados contra renders reais, não apenas configurados:

• Ducking lateral (side-chain ducking) mede o gatilho (ex.: o bumbo) e ajusta seu nível e o limiar do compressor para que o ducking seja aproximadamente na profundidade solicitada (leve ~2 dB, médio ~4-5 dB, pesado ~10 dB com ReaComp). As faixas de instrumentos são atenuadas em um pequeno barramento logo após elas, porque um instrumento deixa um gatilho que chega nos canais 3/4 passar para sua saída. Plugins compatíveis com sidechain (ex.: compressores com a opção "SC Source: External") são alternados automaticamente.
• Masterização constrói EQ → compressor glue → limitador no master. Um compressor glue que o creaper conhece é configurado e calibrado por medição até reduzir cerca de 1,5 dB nos momentos altos (o quanto a diferença entre momentos altos e baixos diminui, o que o ganho de compensação não consegue simular). Então o limitador e o nível do master são ajustados até que a sonoridade integrada fique dentro de 0,5 LU do alvo, o pico verdadeiro é verificado contra o teto (apertado se necessário), e ele avisa quando picos e sonoridade estão a menos de 7 dB de distância (espremido). Testado com Arturia's Bus FORCE, Comp VCA-65, FET-76 e TUBE-STA e REAPER's ReaComp.
• Perfis de plugins descrevem como plugins específicos funcionam, ex.: os caminhos paralelos dry/compressor/saturação do Bus FORCE (seu caminho de compressor é silenciado por padrão), ou que o FET-76 comprime mais conforme sua entrada aumenta. Integrado para REAPER's ReaComp e Arturia's Bus FORCE, Comp VCA-65/FET-76/TUBE-STA, EQ SITRAL-295 e Pre 1973/TridA/V76.
• Conexões de plugins são proibidas. Parâmetros que navegam ou salvam presets, controlam controladores de hardware ou desfazem dentro do plugin são ocultados e recusados.
• Os trabalhos usam seus próprios plugins (compressor=, eq=, glue_compressor=, fx=); o creaper configura os plugins padrão do REAPER e diz ao Claude o que definir nos outros.

As notas são mantidas em <REAPER resource path>/creaper/knowledge.json; você pode lê-las, editá-las ou excluí-las.

Instalação

Você precisa de REAPER 7 (aberto pelo menos uma vez) e uma conta Claude.

Windows: um comando

Abra o PowerShell (Menu Iniciar → digite powershell → Enter; não Executar como administrador, para que o creaper instale para sua própria conta), cole esta linha inteira e pressione Enter:

irm https://raw.githubusercontent.com/nickcapron/creaper/main/install.ps1 | iex

Copie em uma única peça: irm sozinho pede um Uri:, e sem | iex no final o PowerShell apenas imprime o instalador em vez de executá-lo. Quando estiver rodando, você verá creaper installer, depois Instalando creaper…, e então algumas perguntas.

Ele instala Python se necessário, coloca o creaper em sua própria pasta (%LOCALAPPDATA%\creaper), oferece instalar o Claude Code com o instalador oficial da Anthropic, e então executa creaper setup, que:

• instala ReaImGui (para o painel de chat) a partir de seu lançamento oficial no GitHub, se você não o tiver;
• instala os scripts do creaper no REAPER e os inicia com o REAPER;
• oferece conectar o creaper ao Claude Desktop e ao Claude Code.

Ele também adiciona um comando creaper (creaper doctor, creaper install-bridge …) para novos terminais. Então faça login no Claude Code uma vez (execute claude em um novo terminal) e reinicie o REAPER: o painel do creaper abre sozinho. Execute o mesmo comando novamente para atualizar.

O instalador nunca pede senha ou chave do Claude; o login acontece nos próprios aplicativos do Claude. Para ver o que ele faz primeiro, leia install.ps1.

macOS, Linux, ou manualmente

Você precisa de Python 3.10 ou mais recente.

pip install https://github.com/nickcapron/creaper/archive/refs/heads/main.zip
creaper setup

creaper setup --dry-run mostra o que ele faria sem mudar nada. Os passos individuais estão abaixo se você preferir fazê-los você mesmo.

1. Instale o creaper (passos manuais)

pip install https://github.com/nickcapron/creaper/archive/refs/heads/main.zip

2. Instale o script de ponte no REAPER

creaper install-bridge

Isso copia os scripts do creaper para a pasta Scripts/creaper do REAPER e define o REAPER para iniciar o creaper sempre que ele abrir: a ponte roda silenciosamente em segundo plano, e o painel de chat abre (uma vez que o ReaImGui esteja instalado; veja Chat dentro do REAPER). Ele faz isso com um bloco claramente marcado em Scripts/__startup.lua, deixando qualquer outra coisa nesse arquivo intacta. Opções:

• --no-chat: iniciar apenas a ponte, não o painel.
• --no-autostart: não iniciar nada na inicialização (e remover o bloco do creaper se estiver lá). Então execute Scripts/creaper/creaper_bridge.lua você mesmo na lista de ações (Nova ação → Carregar ReaScript); executá-lo novamente o interrompe.

3. Reinicie o REAPER.

4. Verifique a conexão

creaper doctor

5. Conecte o Claude

Claude Desktop: abra Configurações → Desenvolvedor → Editar Config e adicione o creaper ao claude_desktop_config.json, então reinicie o Claude Desktop:

{
  "mcpServers": {
    "creaper": {
      "command": "python",
      "args": ["-m", "creaper"]
    }
  }
}

Se python não estiver no seu PATH, use o caminho completo para o Python com o qual você instalou o creaper (no Windows, algo como C:\\Users\\you\\AppData\\Local\\Programs\\Python\\Python312\\python.exe).

Claude Code:

claude mcp add creaper -- python -m creaper

Então pergunte ao Claude algo como "O que há no meu projeto REAPER?"

Chat dentro do REAPER

Prefere não trocar de janela? O creaper inclui um painel de chat que você pode encaixar dentro do REAPER, como o mixer. Ele executa seu próprio Claude Code instalado, conectado com sua própria conta, e esse Claude só pode usar as ferramentas do creaper: ele pode trabalhar no seu projeto REAPER e nada mais no seu computador.

Qual conta paga: o painel nunca lida com logins ou chaves. Ele usa o que o Claude Code estiver conectado. Normalmente é seu plano Claude, e o painel mostra quanto dos limites do seu plano você usou. Se ANTHROPIC_API_KEY estiver definido, o Claude Code usa essa chave e cobra por uso. Você é responsável por usar sua conta dentro dos termos da Anthropic; a rota de chave de API é a que a Anthropic documenta para ferramentas de terceiros.

Você precisa: Claude Code, conectado uma vez (execute claude em um terminal), e a extensão gratuita ReaImGui: instale ReaPack, então no REAPER Extensões → ReaPack → Procurar pacotes, procure por ReaImGui, instale-o e reinicie o REAPER.

Então:

1. Execute creaper install-bridge novamente, para que o painel saiba onde estão Python e Claude Code.
2. Reinicie o REAPER: o painel abre sozinho. (Fechou? Execute Script: creaper_chat.lua na lista de ações, ou coloque-o em uma barra de ferramentas ou atalho.)
3. Clique em Encaixar para encaixá-lo. Digite uma mensagem e pressione Enter (Ctrl+Enter adiciona uma linha).

O painel mostra o que o Claude está fazendo enquanto trabalha (cada ferramenta que ele executa) e quanto do limite de 5 horas do seu plano você usou. Parar interrompe uma rodada, e Novo chat recomeça. As conversas continuam entre reinicializações do REAPER.

O Claude não pergunta antes de edições rotineiras no painel (todas são desfazíveis), mas mostra Permitir / Negar antes de qualquer coisa mais arriscada: executar uma ação arbitrária do REAPER (algumas não podem ser desfeitas, como salvar ou excluir mídia) ou excluir uma faixa.

Notas de segurança

• O creaper não abre portas de rede. O servidor MCP fala com seu aplicativo via stdio, e a ponte troca arquivos na sua própria pasta de recursos do REAPER.
• Ele nunca lida com logins ou chaves de API.
• A ponte executa apenas seus próprios comandos fixos, nunca código enviado a ela.
• O Claude do painel de chat não tem ferramentas de shell, arquivo ou web, apenas as do creaper.
• Projetos podem vir de outras pessoas, e nomes dentro deles (faixas, marcadores, presets) chegam ao Claude como texto. O Claude é instruído a tratá-los como dados, nunca como instruções, e as ferramentas mais arriscadas precisam da sua confirmação no painel. No Claude Desktop, mantenha a aprovação por ferramenta ativada para run_action e delete_track.

Convenções que o Claude usa

• Faixas são nomeadas por número (1 = topo), por nome, ou master.
• Compassos e batidas são baseados em 1, como a régua do REAPER.
• Dentro de um item MIDI, posições e durações são em semínimas: 1 = semínima, 0.5 = colcheia, 0.25 = semicolcheia, 4 = um compasso de 4/4.
• Dó central é C4 = 60.
• Pistas de bateria são strings de passos: x batida, X acento, o fantasma, 1–9 velocidade, . pausa. Nomes de pistas são bateria General MIDI (kick, snare, closed hat…) ou números de notas para outros kits.

Como funciona

Claude app  ⇄  creaper MCP server (Python)  ⇄  files  ⇄  creaper_bridge.lua (inside REAPER)

O Lua do REAPER não tem rede, então as duas metades falam através de pequenos arquivos JSON na pasta de recursos do REAPER (<resource path>/creaper/). A ponte verifica se há uma solicitação cerca de 30 vezes por segundo, executa-a com a API ReaScript e escreve a resposta de volta. Uma ida e volta leva cerca de 40 ms.

Para análise, a ponte renderiza o intervalo solicitado para um WAV temporário de float de 32 bits (para que overs acima de 0 dBFS não sejam ocultados). Ela salva suas configurações de renderização primeiro e as restaura depois. O servidor mede o arquivo em Python e então o exclui.

Melhores vozes de robô com Piper (opcional)

Vocais de robô usam as vozes de fala do seu próprio computador. Para vozes mais claras e naturais, instale Piper, um mecanismo de voz offline gratuito (GPL-3.0, então é uma instalação separada), no ambiente Python do creaper:

python -m pip install piper-tts

Então coloque vozes (um arquivo .onnx e seu .onnx.json, de rhasspy/piper-voices) em <REAPER resource folder>/creaper/voices/piper/. O creaper as lista primeiro e mostra a licença de cada voz: para música que você vai lançar, escolha vozes de domínio público ou CC0 como Norman, John, Bryce, Joe, Kristin, LJSpeech ou Cori. Algumas vozes populares (Lessac, Ryan, HFC) são apenas para uso não comercial.

Bom saber

• Desfazer. Cada chamada de ferramenta é um passo de desfazer. O Claude também pode chamar undo ele mesmo.
• Suas configurações de renderização são salvas e restauradas em torno de cada renderização de análise, e os arquivos renderizados são excluídos depois (defina CREAPER_KEEP_RENDERS=1 para mantê-los em <resource path>/creaper/renders).
• Instalações portáteis do REAPER: defina CREAPER_REAPER_RESOURCE_PATH para a pasta portátil tanto para creaper install-bridge --reaper-resource-path ... quanto para o ambiente do servidor MCP.
• Atualização: no Windows, execute o comando do instalador novamente. Caso contrário, pip install --upgrade https://github.com/nickcapron/creaper/archive/refs/heads/main.zip, então creaper install-bridge novamente e reinicie a ponte. Uma ponte recém-iniciada assume o controle de uma em execução, então você não precisa reiniciar o REAPER.

Solução de problemas

Problema	Correção
"REAPER não está respondendo"	O REAPER está aberto e a ponte rodando? Execute creaper doctor.
doctor não encontra heartbeat com um REAPER portátil	Defina CREAPER_REAPER_RESOURCE_PATH (veja acima).
"REAPER não respondeu dentro de N segundos"	Feche qualquer diálogo aberto no REAPER; janelas modais podem pausar scripts.
Um parâmetro de plugin não aceita um display_value	Ele pode mostrar texto em vez disso; use display_text, ou o value bruto de 0–1.
Bateria cai em sons errados	O kit não segue General MIDI ou não reporta nomes de notas. Diga ao Claude em qual nota cada bateria está; ele salva um mapa de bateria para esse instrumento.
O painel de chat diz que precisa de ReaImGui	Instale ReaImGui através do ReaPack (veja Chat dentro do REAPER) e reinicie o REAPER.
claude ou creaper "não é reconhecido"	Abra uma nova janela do PowerShell (mudanças de PATH só alcançam novas). Ainda não encontrado? Execute o instalador novamente: ele adiciona ambos ao seu PATH.
O painel de chat diz que o Claude Code não foi encontrado	Instale o Claude Code, execute claude uma vez para entrar, então creaper install-bridge novamente.
Uma análise de uma faixa de hardware/Overbridge está silenciosa	Plugins apenas em tempo real não podem renderizar offline. Grave sua saída em uma faixa de áudio primeiro.

Desenvolvimento

git clone https://github.com/nickcapron/creaper
cd creaper
python -m venv .venv
.venv/bin/pip install -e ".[dev]"     # Windows: .venv\Scripts\pip install -e ".[dev]"
.venv/bin/pytest

• src/creaper/reaper/creaper_bridge.lua: o lado REAPER (mais creaper_json.lua)
• src/creaper/reaper/creaper_chat.lua: o painel de chat encaixável (ReaImGui)
• src/creaper/chat.py: executa uma rodada do painel no Claude Code, limitado às ferramentas do creaper
• src/creaper/server.py: as ferramentas MCP
• src/creaper/bridge.py: o cliente baseado em arquivos
• src/creaper/theory.py: nomes de notas, símbolos de acordes, padrões de bateria e edições MIDI
• src/creaper/scales.py, harmony.py: escalas e modos, grafia, numerais romanos, nomenclatura de acordes, detecção de tonalidade, cadências, modulação
• src/creaper/composer.py: progressões, rearmonização, voicings e condução de vozes, baixo, comping, melodia, ritmo, análise harmônica MIDI
• src/creaper/genres/: a biblioteca de gêneros, um módulo por família (genres/__init__.py tem o esquema e o validador)
• src/creaper/music_tools.py: as ferramentas de teoria, gênero, composição e escuta
• src/creaper/listen.py: características de áudio por nota, classificação de bateria e mapeamento de kits
• src/creaper/pluginscan.py, scan_tools.py: testando plugins e o catálogo de plugins
• src/creaper/project_tools.py: mapa de tempo, mudanças de programa e controladores, roteamento
• src/creaper/samplelib.py, sample_tools.py: a biblioteca de samples, análise de tempo/tom de loops, kits de sampler
• src/creaper/export_tools.py: salvando o projeto, exportando a mixagem e os stems
• src/creaper/record_tools.py: gravação e takes, seleção de tempo, marcadores, modelos de faixa, congelamento
• src/creaper/vocal_tools.py, speech.py, talkbox.py: vocais (chops, MIDI de sintetizador de canto, texto para fala, talk box e vocoder)
• src/creaper/perception.py, ear_tools.py: medindo o que um ouvinte notaria (clareza, afinação, espectrogramas)
• src/creaper/mix_tools.py: auto_mix
• src/creaper/motif_tools.py: motivos reutilizados entre músicas
• src/creaper/installer.py, install.ps1: creaper setup e o instalador do Windows em um comando
• assets/make_brand.py: regenera o logotipo, banner e miniatura em assets/brand/
• src/creaper/drums.py: mapas de bateria salvos
• src/creaper/analysis.py: loudness (ITU-R BS.1770-4 / EBU R128), pico verdadeiro, espectro, estéreo

Issues e pull requests são bem-vindos.

Licença

MIT