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.mdao 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_linke, depois que o comprador entra,list_my_engineseget_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 emhttps://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
- Encontrar
catalog.json, a API ou o MCP - Escolherpelo encaixe, grátis ao lado de paga
- Informar o usuárionome, id, página e preço
- Integraro início rápido com JUCE, à risca
Engine gratuita
- Baixarsem conta nem e-mail
- Integrar
Engine paga
create_checkoutinforme o preço antes- O usuário paga no PayPalnunca o agente
get_download_linkdepois que entrarem- Integrar
Como escolher uma engine
- Carregue o
catalog.json. - 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 comdescription,stylese os nomes dos parâmetros. - 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/macosouhttps://sournd.com/download/free/linux(um arquivo com todas), também no campodownloadde cada engine gratuita no catalog.json.compare_enginesouPOST /api/v1/comparedevolve a engine gratuita mais próxima de uma paga, com as diferenças. - Verifique
latency(em samples) esidechainse o plugin do usuário depender deles. - O usuário vai querer o
nameda engine, oide ourlda página. O preço de uma engine paga está emget_price, ou empricena 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::SourndEnginecom o id da engine, depois o APVTS a partir deSourndEngineParameters::createLayout(engine), depoisSourndEngineParameters(engine, apvts). - Em
prepareToPlay:engine.prepare,bridge.prepare,setLatencySamples(engine.latency()). - Em
processBlock:bridge.apply(numSamples), depoisengine.processcom um contexto de substituição. - Estado:
bridge.syncToEngine()e depoisengine.saveState();engine.loadState(...)e depoisbridge.syncFromEngine(). - Os ids de parâmetro do JUCE são os valores decimais de
abi_idnocatalog.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
.gitignoreantes 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 escopobuilds:record, veja auth.md). - Com uma chave de IA: faça um
POSTpara orecord_build.urlque 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).