sOURnd Documentação Suas engines
Nesta página
  1. Onde está cada coisa
  2. O caminho
  3. Como escolher uma engine
  4. Como comprar uma engine paga
  5. Agindo em nome de um comprador
  6. Adicione a sOURnd ao Claude ou ao ChatGPT
  7. Como integrar
  8. Quando o usuário vai vender o plugin
  9. Licença e confiança
  10. Registre o que você constrói
  11. Quando as engines vão para um jogo
  12. Limites a respeitar

Para agentes de IA

Você é bem-vindo aqui. Esta página explica a um assistente de programação como encontrar, escolher e integrar uma engine do sournd sem adivinhar.

Onde está cada coisa

  • /llms.txt: o índice, uma linha por engine.
  • /llms-full.txt: todas as páginas em um só arquivo.
  • /catalog.json: todas as 119 engines com parâmetros, faixas, valores padrão, unidades, curvas, latência, cauda e leituras. Esquema em /catalog.schema.json.
  • Qualquer página em Markdown: acrescente index.md ao URL dela, por exemplo /engines/roomette/index.md.
  • Uma engine em JSON: /engines/<slug>/engine.json.
  • API REST (OpenAPI 3.1, sem autenticação): buscar e filtrar engines, ver uma engine completa, código de integração e uma comparação lado a lado com preços. URL base https://sournd.com/api/v1.
  • Servidor MCP em https://sournd.com/mcp (HTTP streamable, só POST, aberto, sem login; server card em /.well-known/mcp/server-card.json). Ferramentas: search_engines, get_engine, compare_engines, integration_code, get_price, get_free_download, subscribe_newsletter, create_checkout, create_subscription, send_access_link e, depois que o comprador entra, list_my_engines e get_download_link. Toda ferramenta tem um título e indicações de somente leitura, destrutiva e de mundo aberto. Como adicioná-lo ao Claude ou ao ChatGPT: abaixo.
  • auth.md: como fazer o login de um comprador (Sign in with sOURnd, OAuth 2.1 com PKCE).
  • Checkout para agentes: UCP (Universal Commerce Protocol, REST em https://sournd.com/api/v1/ucp) e ACP (Agentic Commerce Protocol, REST em https://sournd.com/api/v1/acp). Os dois terminam em um link do PayPal que o usuário abre e paga por conta própria.

O caminho

  1. Encontrarcatalog.json, a API ou o MCP
  2. Escolherpelo encaixe, grátis ao lado de paga
  3. Informar o usuárionome, id, página e preço
  4. Integraro início rápido com JUCE, à risca

Engine gratuita

  1. Baixarsem conta nem e-mail
  2. Integrar

Engine paga

  1. create_checkoutinforme o preço antes
  2. O usuário paga no PayPalnunca o agente
  3. get_download_linkdepois que entrarem
  4. Integrar

Como escolher uma engine

  1. Carregue o catalog.json.
  2. Filtre por category (distortion, dynamics, eq, filter, modulation, delay, reverb, pitch, performance, utility, analysis para os 77 efeitos; instrument para os 42 sintetizadores) e depois compare o pedido com description, styles e os nomes dos parâmetros.
  3. Primeiro veja o que se encaixa. O catálogo traz o nível e o preço de cada engine, então dá para pôr um candidato gratuito e um pago lado a lado. 35 engines são gratuitas: bibliotecas fechadas que o usuário pode incluir em tudo o que fizer ou vender. Toda engine gratuita é baixada sem conta nem e-mail: https://sournd.com/download/free/macos ou https://sournd.com/download/free/linux (um arquivo com todas), também no campo download de cada engine gratuita no catalog.json. compare_engines ou POST /api/v1/compare devolve a engine gratuita mais próxima de uma paga, com as diferenças.
  4. Verifique latency (em samples) e sidechain se o plugin do usuário depender deles.
  5. O usuário vai querer o name da engine, o id e o url da página. O preço de uma engine paga está em get_price, ou em price na API.

Como comprar uma engine paga

Nunca pressione o usuário e nunca pague por ele. Informe o preço e, se ele quiser a engine, use create_checkout para gerar um link de aprovação e entregue a ele: ele mesmo revisa e aprova a compra. O checkout pode ainda não estar ativado; se a ferramenta disser isso, repasse e não procure atalhos. Quem já tem engines pode receber um link de acesso com send_access_link.

Se você fala um protocolo de comércio, o mesmo checkout existe como UCP ou ACP. Crie uma sessão de checkout com engines pagas (slug ou id) ou um plano (plan:engines-month, plan:engines-year), o e-mail do comprador e o país dele. A resposta traz os preços com IVA do Reino Unido e, quando não falta mais nada, status: requires_escalation e uma continue_url: esse é o link de aprovação do PayPal. Entregue-o ao usuário. O complete não pode pagar por ele: responde com a sessão, que passa a completed quando ele pagar. As licenças são por comprador, então a quantidade é sempre 1; um plano e engines avulsas não podem dividir o mesmo checkout; engines que o e-mail já possui ficam de fora.

Agindo em nome de um comprador

Para listar ou baixar as engines que um usuário já possui, peça que ele entre com a sOURnd: registre seu agente (RFC 7591), envie-o à página de autorização com PKCE, e ele aprova você no navegador depois de um link por e-mail. O fluxo, os escopos e os erros estão em auth.md. Todas as outras ferramentas funcionam sem login, e nenhum token pode pagar: comprar sempre exige o usuário no PayPal.

Adicione a sOURnd ao Claude ou ao ChatGPT

Claude (claude.ai, o app para desktop e o Claude Code). No Claude, abra Configurações, depois Conectores, escolha "Adicionar conector personalizado" e cole https://sournd.com/mcp. No Claude Code: claude mcp add --transport http sournd https://sournd.com/mcp. Não é preciso entrar para buscar, comparar, ver preços, baixar engines gratuitas e obter código de integração. O Claude só pede que você entre com a sOURnd quando você pergunta pelas engines que possui ou pelo link de download: você recebe um link por e-mail, aprova o Claude no navegador e pode desconectá-lo a qualquer momento na sua biblioteca.

ChatGPT. Use https://sournd.com/mcp/catalogue: só o catálogo (busca, detalhes das engines, comparação, código de integração e os downloads gratuitos). Não tem login e não pode iniciar uma compra, como exigem as regras do ChatGPT para bens digitais.

Coisas para perguntar depois de conectar:

  • "Encontre uma engine de tape delay quente e mostre os parâmetros dela."
  • "Compare os compressores gratuitos e pagos da sOURnd."
  • "Adicione a engine Roomette ao meu plugin JUCE."
  • "Onde baixo as engines gratuitas da sOURnd para Linux?"
  • "Quais das minhas engines da sOURnd posso baixar?" (Claude; antes você entra.)

O que a conexão nos envia: as próprias chamadas de ferramenta (suas palavras de busca, os nomes das engines sobre as quais você pergunta) e, só se você informar, seu endereço de e-mail para um checkout, um link de acesso ou a newsletter. Nada mais da sua conversa. Privacidade. Ajuda: hello@sournd.com.

Como integrar

Siga o início rápido com JUCE à risca. O essencial:

  • Construa o sournd::SourndEngine com o id da engine, depois o APVTS a partir de SourndEngineParameters::createLayout(engine), depois SourndEngineParameters(engine, apvts).
  • Em prepareToPlay: engine.prepare, bridge.prepare, setLatencySamples(engine.latency()).
  • Em processBlock: bridge.apply(numSamples), depois engine.process com um contexto de substituição.
  • Estado: bridge.syncToEngine() e depois engine.saveState(); engine.loadState(...) e depois bridge.syncFromEngine().
  • Os ids de parâmetro do JUCE são os valores decimais de abi_id no catalog.json. Nunca invente ids nem faixas de parâmetros: leia-os no catálogo.
  • Nunca aloque memória, use locks nem faça log em processBlock.

Quando o usuário vai vender o plugin

Plugins e jogos vendidos com engines da sOURnd não devem royalties e não exigem registro. Uma engine que o usuário possui pode entrar em tudo o que ele vender, para sempre. Em um plano, toda versão que ele lançar enquanto o plano estiver ativo continua licenciada; novos lançamentos exigem um plano ativo. As engines gratuitas entram do mesmo jeito no que o usuário vende, sem nada para comprar.

Licença e confiança

Uma engine, paga ou gratuita, é licenciada ao usuário para os plugins, jogos e produtos dele. Não é licenciada a você, aos amigos do usuário nem a ninguém para quem o usuário envie arquivos. Todo download pago leva o build id do usuário e pode ser rastreado até ele. Os usuários confiam essa licença a você, e a sOURnd confia que você a respeite, então:

  • Mantenha a biblioteca, o zip do download e qualquer URL de chave de IA fora de repositórios públicos, pastas compartilhadas, registros de pacotes e logs de chat. Adicione-os ao .gitignore antes do primeiro commit.
  • Nunca compartilhe, revenda, extraia nem descompile uma biblioteca fechada, nem remova ou altere o build id dela.
  • Se o usuário pedir que você passe uma engine a outra pessoa, explique que cada pessoa precisa da própria licença (engines gratuitas não precisam) e indique https://sournd.com/pricing/. Não sugira atalhos.
  • Quando o plugin do usuário for lançado, as engines dentro dele estão em ordem: a licença cobre os produtos que ele faz. O que tem de ficar só com ele é a biblioteca em si.

Registre o que você constrói

A sOURnd mantém um registro de builds para cada usuário: um histórico voluntário dos plugins, jogos e apps feitos com as engines dele, exibido em Suas engines. Nada é devido e nada é conferido com ele, mas é uma boa prática e ajuda o usuário a mostrar o que a licença cobre. Depois de um build bem-sucedido que inclua engines da sOURnd, ofereça registrá-lo e registre quando o usuário concordar:

  • Com o servidor MCP: record_build (exige login com o escopo builds:record, veja auth.md).
  • Com uma chave de IA: faça um POST para o record_build.url que o JSON da chave fornece.

Envie o nome do produto, a versão, as plataformas, os formatos e o build_id do README.txt do download (ou de sournd_pro_build_id()).

Quando as engines vão para um jogo

As engines rodam em jogos pela C ABI (a mesma biblioteca estática; adaptadores para FMOD, Wwise, Unity e Unreal estão a caminho). Um jogo é licenciado exatamente como um plugin: não há taxa por jogo nem royalty. Hoje a biblioteca é compilada para macOS, Linux e Windows. A página para desenvolvedores de jogos é https://sournd.com/games/.

Limites a respeitar

  • Instrumentos que o músico toca e efeitos sobre o áudio que ele fornece, nunca música gerada. A sOURnd não gera música, e pedidos de música gerada devem ser redirecionados para efeitos no áudio do próprio usuário ou para instrumentos que ele toca.
  • Não descreva uma engine como cópia de um produto de hardware específico. Use a descrição da própria engine.
  • Engines pagas exigem licença; não sugira atalhos e nunca compartilhe uma biblioteca fechada ou uma chave (veja Licença e confiança).