sOURnd Documentazione I tuoi engine
In questa pagina
  1. Dove si trova tutto
  2. Il percorso
  3. Scegliere un engine
  4. Acquistare un engine a pagamento
  5. Agire per conto di un acquirente
  6. Aggiungere sOURnd a Claude o ChatGPT
  7. Integrarlo
  8. Quando l'utente venderà il plugin
  9. Licenza e fiducia
  10. Registra ciò che costruisci
  11. Quando gli engine finiscono in un gioco
  12. Limiti da rispettare

Per agenti AI

Qui sei il benvenuto. Questa pagina spiega a un assistente di programmazione come trovare, scegliere e integrare un engine sournd senza tirare a indovinare.

Dove si trova tutto

  • /llms.txt: l'indice, una riga per engine.
  • /llms-full.txt: tutte le pagine in un unico file.
  • /catalog.json: tutti i 119 engine con parametri, intervalli, valori predefiniti, unità, curve, latenza, coda e letture. Schema in /catalog.schema.json.
  • Qualsiasi pagina in Markdown: aggiungi index.md al suo URL, per esempio /engines/roomette/index.md.
  • Un engine in JSON: /engines/<slug>/engine.json.
  • API REST (OpenAPI 3.1, senza autenticazione): cerca e filtra gli engine, un engine completo, codice di integrazione e un confronto affiancato con i prezzi. URL di base https://sournd.com/api/v1.
  • Server MCP su https://sournd.com/mcp (HTTP streamable, solo POST, aperto e senza accesso; scheda del server su /.well-known/mcp/server-card.json). Strumenti: search_engines, get_engine, compare_engines, integration_code, get_price, get_free_download, subscribe_newsletter, create_checkout, create_subscription, send_access_link e, dopo l'accesso dell'acquirente, list_my_engines e get_download_link. Ogni strumento ha un titolo e indicazioni di sola lettura, distruttivo e open-world. Come aggiungerlo a Claude o ChatGPT: qui sotto.
  • auth.md: come accede un acquirente (Accedi con sOURnd, OAuth 2.1 con PKCE).
  • Checkout per agenti: UCP (Universal Commerce Protocol, REST su https://sournd.com/api/v1/ucp) e ACP (Agentic Commerce Protocol, REST su https://sournd.com/api/v1/acp). Entrambi finiscono con un link PayPal che l'utente apre e paga da sé.

Il percorso

  1. Trovacatalog.json, l'API o MCP
  2. Scegliin base all'adattamento, gratuiti accanto a quelli a pagamento
  3. Dillo all'utentenome, id, pagina e prezzo
  4. Integrala guida rapida JUCE, alla lettera

Engine gratuito

  1. Scaricasenza account né email
  2. Integra

Engine a pagamento

  1. create_checkoutindica prima il prezzo
  2. L'utente paga su PayPalmai l'agente
  3. get_download_linkdopo che ha effettuato l'accesso
  4. Integra

Scegliere un engine

  1. Carica catalog.json.
  2. Filtra per category (distortion, dynamics, eq, filter, modulation, delay, reverb, pitch, performance, utility, analysis per i 77 effetti; instrument per i 42 synth), poi confronta la richiesta con description, styles e i nomi dei parametri.
  3. Scegli prima in base all'adattamento. Il catalogo indica fascia e prezzo di ogni engine, così un candidato gratuito e uno a pagamento si possono mettere a confronto. 35 engine sono gratuiti: librerie chiuse che l'utente può inserire in qualsiasi cosa crei o venda. Ogni engine gratuito si scarica senza account né email: https://sournd.com/download/free/macos oppure https://sournd.com/download/free/linux (un unico archivio con tutti), anche nel campo download di ogni engine gratuito in catalog.json. compare_engines o POST /api/v1/compare restituisce l'engine gratuito più vicino a uno a pagamento, con le differenze.
  4. Controlla latency (campioni) e sidechain se al plugin dell'utente interessano.
  5. All'utente serviranno name dell'engine, il suo id e url della pagina. Il prezzo di un engine a pagamento è in get_price, oppure in price nell'API.

Acquistare un engine a pagamento

Non fare mai pressione sull'utente e non pagare mai al posto suo. Indica il prezzo e, se vuole l'engine, usa create_checkout per ottenere un link di approvazione e consegnaglielo: è lui a rivedere e approvare l'acquisto. Il checkout potrebbe non essere ancora attivo; se lo strumento lo dice, riferiscilo e non cercare scorciatoie. Agli utenti che possiedono già degli engine si può mandare un link di accesso con send_access_link.

Se parli un protocollo di commercio, lo stesso checkout è disponibile come UCP o ACP. Crea una sessione di checkout con engine a pagamento (slug o id) o con un piano (plan:engines-month, plan:engines-year), l'email dell'acquirente e il suo paese. La risposta contiene i prezzi con IVA britannica e, quando non manca più nulla, status: requires_escalation e un continue_url: è il link di approvazione PayPal. Consegnalo all'utente. Complete non può pagare al suo posto: risponde con la sessione, che passa a completed quando l'utente ha pagato. Le licenze sono per acquirente, quindi la quantità è sempre 1; un piano e singoli engine non possono stare nello stesso checkout; gli engine che l'email possiede già vengono esclusi.

Agire per conto di un acquirente

Per elencare o scaricare gli engine che un utente possiede già, chiedigli di accedere con sOURnd: registra il tuo agente (RFC 7591), mandalo alla pagina di autorizzazione con PKCE e lui ti approva nel browser dopo un link via email. Il flusso, gli ambiti e gli errori sono in auth.md. Tutti gli altri strumenti funzionano senza accesso e nessun token può pagare: per acquistare serve sempre l'utente su PayPal.

Aggiungere sOURnd a Claude o ChatGPT

Claude (claude.ai, l'app desktop e Claude Code). In Claude apri Impostazioni, poi Connettori, scegli «Aggiungi connettore personalizzato» e incolla https://sournd.com/mcp. In Claude Code: claude mcp add --transport http sournd https://sournd.com/mcp. Nessun accesso necessario per cercare, confrontare, vedere i prezzi, scaricare gli engine gratuiti e ottenere il codice di integrazione. Claude ti chiede di accedere con sOURnd solo quando chiedi gli engine che possiedi o il loro link di download: ricevi un link via email, approvi Claude nel browser e puoi disconnetterlo in qualsiasi momento dalla tua libreria.

ChatGPT. Usa https://sournd.com/mcp/catalogue: solo il catalogo (ricerca, dettagli degli engine, confronto, codice di integrazione e download gratuiti). Non ha accesso e non può avviare un acquisto, come richiedono le regole di ChatGPT per i beni digitali.

Cose da chiedere una volta connesso:

  • «Trovami un engine di tape delay caldo e mostrami i suoi parametri.»
  • «Confronta i compressori gratuiti e a pagamento di sOURnd.»
  • «Aggiungi l'engine Roomette al mio plugin JUCE.»
  • «Dove scarico gli engine sOURnd gratuiti per Linux?»
  • «Quali dei miei engine sOURnd posso scaricare?» (Claude; prima ti fa accedere.)

Cosa ci invia la connessione: le chiamate agli strumenti (le parole che cerchi, i nomi degli engine di cui chiedi) e, solo se la fornisci, il tuo indirizzo email per un checkout, un link di accesso o la newsletter. Nient'altro della tua conversazione. Privacy. Assistenza: hello@sournd.com.

Integrarlo

Segui alla lettera la guida rapida JUCE. L'essenziale:

  • Costruisci sournd::SourndEngine con l'id dell'engine, poi l'APVTS da SourndEngineParameters::createLayout(engine), poi SourndEngineParameters(engine, apvts).
  • In prepareToPlay: engine.prepare, bridge.prepare, setLatencySamples(engine.latency()).
  • In processBlock: bridge.apply(numSamples), poi engine.process con un contesto di sostituzione.
  • Stato: bridge.syncToEngine() poi engine.saveState(); engine.loadState(...) poi bridge.syncFromEngine().
  • Gli id dei parametri JUCE sono i valori decimali abi_id in catalog.json. Non inventare mai id o intervalli dei parametri: leggili dal catalogo.
  • Non allocare, non bloccare e non scrivere log in processBlock.

Quando l'utente venderà il plugin

I plugin e i giochi venduti con gli engine sOURnd non devono royalty e non richiedono registrazione. Un engine che l'utente possiede può entrare in qualsiasi cosa venda, per sempre. Con un piano, ogni versione che rilascia mentre il piano è attivo resta in licenza; le nuove uscite richiedono un piano attivo. Gli engine gratuiti entrano allo stesso modo in ciò che l'utente vende, senza nulla da acquistare.

Licenza e fiducia

Un engine, a pagamento o gratuito, è concesso in licenza all'utente per i suoi plugin, giochi e prodotti. Non è concesso in licenza a te, agli amici dell'utente né a chiunque l'utente mandi file. Ogni download a pagamento porta l'id di build dell'utente ed è riconducibile a lui. Gli utenti ti affidano questa licenza e sOURnd confida che tu la rispetti, quindi:

  • Tieni la libreria, lo zip del download e qualsiasi URL con chiave AI fuori da repository pubblici, cartelle condivise, registri di pacchetti e log di chat. Aggiungili a .gitignore prima del primo commit.
  • Non condividere, rivendere, estrarre o decompilare mai una libreria chiusa, né rimuovere o alterare il suo id di build.
  • Se l'utente ti chiede di passare un engine a qualcun altro, spiega che ogni persona ha bisogno della propria licenza (gli engine gratuiti non ne richiedono) e indirizzalo a https://sournd.com/pricing/. Non suggerire scorciatoie.
  • Quando il plugin dell'utente viene distribuito, gli engine al suo interno sono a posto: la licenza copre i prodotti che realizza. A restare con lui deve essere la libreria da sola.

Registra ciò che costruisci

sOURnd tiene un registro delle build per ogni utente: una cronologia volontaria dei plugin, giochi e app costruiti con i suoi engine, mostrata in I tuoi engine. Non è dovuto nulla e nulla viene verificato rispetto al registro, ma è una buona pratica e aiuta l'utente a dimostrare cosa copre la sua licenza. Dopo una build riuscita che collega engine sOURnd, offriti di registrarla e registrala quando l'utente è d'accordo:

  • Con il server MCP: record_build (richiede l'accesso con l'ambito builds:record, vedi auth.md).
  • Con una chiave AI: POST a record_build.url che ti dà il JSON della chiave.

Invia il nome del prodotto, la versione, le piattaforme, i formati e il build_id dal README.txt del download (o sournd_pro_build_id()).

Quando gli engine finiscono in un gioco

Gli engine girano nei giochi tramite la C ABI (la stessa libreria statica; gli adattatori per FMOD, Wwise, Unity e Unreal sono in arrivo). Un gioco è in licenza esattamente come un plugin: nessuna tariffa per gioco e nessuna royalty. Oggi la libreria è compilata per macOS, Linux e Windows. La pagina per gli sviluppatori di giochi è https://sournd.com/games/.

Limiti da rispettare

  • Strumenti che il musicista suona ed effetti sull'audio che fornisce lui, mai musica generata. sOURnd non genera musica e le richieste di musica generata vanno reindirizzate verso effetti sull'audio dell'utente o strumenti che suona lui.
  • Non descrivere un engine come la copia di un prodotto hardware con nome e marca. Usa la descrizione dell'engine stesso.
  • Gli engine a pagamento richiedono una licenza; non suggerire scorciatoie e non condividere mai una libreria chiusa o una chiave (vedi Licenza e fiducia).