NodaroAccount
Docs do Nodaro
DocumentaçãoReferência de nósModelosTemplatesAgentes de IA (MCP)DesenvolvedoresAuto-hospedagemPesquisaComparações

Configuração

Todas as variáveis de ambiente de um Nodaro auto-hospedado, por finalidade, com o padrão, se o .env pode defini-las no Compose e o que elas mudam.

Esta página é a referência de configuração de um Nodaro auto-hospedado: todas as variáveis de ambiente que os operadores definem, agrupadas por finalidade, com o padrão de cada uma. No conjunto de serviços do Compose incluído, toda variável tem um padrão que funciona, então você só define o que quer mudar. As variáveis que só se aplicam ao Nodaro Cloud não estão listadas.

Como definir uma variável

No conjunto de serviços do Compose, você define uma variável em um destes dois lugares:

  • No .env, ao lado do docker-compose.community.yml. Isso funciona para as variáveis que o arquivo do Compose repassa ao app. Nas tabelas abaixo, a coluna .env mostra Sim para elas.
  • No arquivo do Compose, para todas as outras variáveis. Adicione a variável em environment: do serviço nodaro:
  nodaro:
    environment:
      # ...the variables already listed...
      MCP_ENABLED: "true"
      MCP_PUBLIC_URL: https://mcp.nodaro.example.com

Depois, aplique a alteração:

docker compose -f docker-compose.community.yml up -d

O Nodaro lê o ambiente na inicialização. A única exceção são as chaves de provedor que você cola em /setup, que passam a valer na hora. Fora do conjunto de serviços do Compose, defina as variáveis nas configurações de ambiente da sua plataforma.

Obrigatórias fora do conjunto de serviços do Compose: SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY e INTERNAL_ORCHESTRATOR_SECRET. Sem elas, a API se recusa a iniciar e lista as variáveis ausentes ou inválidas.

Instância

VariávelPadrão.envO que faz
EDITIONcommunityNãocommunity, business ou cloud. O arquivo do Compose a fixa em community. Veja Edições e perfis de superfície.
PUBLIC_URLhttp://localhost:3000SimA origem pública da instalação: callbacks de login e de OAuth, URLs de mídia e a verificação de CORS.
PUBLIC_URL_SAME_ORIGINnão definidaNãotrue passa ao navegador o endereço de API / em vez de PUBLIC_URL, de modo que as transmissões ficam no nome de host que o visitante abriu. Para instalações que respondem em vários nomes de host. Só o valor exato true ativa esse comportamento.
ROBOTS_NOINDEXnão definidaNãotrue mantém a instalação inteira fora dos mecanismos de busca: toda resposta leva X-Robots-Tag: noindex, seja quem for que a sirva. Use em uma instalação que nunca deve aparecer em resultados de busca, como uma cópia de homologação. Só o valor exato true ativa esse comportamento. Reinicie para aplicar.
LEGACY_UI_HOSTS, FLOW_UI_ORIGINnão definidasNãoDão às páginas do app um nome de host próprio, enquanto a API fica em PUBLIC_URL. Só com FLOW_UI_ORIGIN, as páginas ganham um host próprio e nada é redirecionado. Com LEGACY_UI_HOSTS também, elas se mudam para lá, e ela precisa de FLOW_UI_ORIGIN. Veja Mover as páginas do app para um nome de host próprio.
FLOW_PUBLIC_URLnão definidaNãoOutro nome de FLOW_UI_ORIGIN. Defina uma ou outra. Quando as duas estão definidas, precisam indicar a mesma origem.
LEGACY_UI_REDIRECT_STATUS302NãoO status do redirecionamento de uma página movida: 302, nunca guardado em cache, ou 301, guardado em cache pelo navegador por uma hora. Qualquer outro valor vale como 302.
CORS_ORIGINvaziaSimOrigens extras do navegador, separadas por vírgula. PUBLIC_URL é sempre permitida. Nesses hosts, o redirecionamento do SSO para a página de destino é relativo. Com o MCP por caminho ligado, PUBLIC_URL e esses hosts são os hosts em que o MCP responde.
DEFAULT_LOCALEvazia (o idioma do navegador)SimO idioma em que um novo visitante começa. Veja Idioma padrão.
NODARO_SURFACE_PROFILEvazia (a interface completa)SimRestringe a interface de uma instalação Business. Veja Perfis de superfície.
NODARO_TUTORIAL_PACKSvazia (só os tutoriais nativos)SimDiretórios de pacotes de tutoriais extras, separados por vírgula. Veja Pacotes de tutoriais.
RUNTIME_ENVlocalNãoDá nome à instalação quando duas instalações compartilham um banco de dados, mas não um Redis. Veja Escalonamento. No Railway, RAILWAY_ENVIRONMENT_NAME define essa variável. Um endpoint de webhook pertence à instalação que o criou, então renomear RUNTIME_ENV oculta os endpoints criados com o nome antigo.
PORT, HOST8000, 0.0.0.0NãoOnde a API escuta. Na imagem, a API escuta na porta 9000, atrás do servidor web na 3000.
NODE_ENVdevelopmentNãoproduction em todas as imagens.

Segredos

VariávelPadrão.envO que faz
INTERNAL_ORCHESTRATOR_SECRETGerado na inicialização, no conjunto de serviços do ComposeSimAutentica o orquestrador na API. Pelo menos 32 caracteres. Obrigatório fora do conjunto de serviços do Compose. Ele também assina os registros de consentimento dos clones de voz de uso único: um novo valor invalida todos os registros emitidos antes, então defina-o explicitamente para que as vozes clonadas continuem funcionando quando um contêiner for substituído.
NODARO_ENCRYPTION_KEYGerada na primeira inicialização, no conjunto de serviços do Compose, e guardada no volume app-dataSimUma chave hexadecimal de 64 caracteres que criptografa as credenciais armazenadas: as chaves de provedor coladas, os tokens de login das redes sociais as credenciais HTTP salvas para o nó Saída de webhook e os segredos de assinatura dos endpoints de webhook. Sem ela, registrar um endpoint de webhook responde 503 encryption_key_missing.
SOCIAL_ENCRYPTION_KEYvaziaSimO nome antigo de NODARO_ENCRYPTION_KEY. Qualquer um dos dois funciona.

Gere um segredo com openssl rand -hex 32. Faça backup da chave de criptografia junto com o banco de dados: veja Backup e restauração.

Banco de dados e login

VariávelPadrão.envO que faz
SUPABASE_URLhttp://localhost:3000/supabase no conjunto de serviços do ComposeSimA URL do Supabase que a API usa. Obrigatória fora do conjunto de serviços do Compose.
SUPABASE_SERVICE_ROLE_KEYUma chave padrão pública, no conjunto de serviços do ComposeSimA chave service-role que a API usa. Obrigatória fora do conjunto de serviços do Compose.
SUPABASE_ANON_KEYUma chave padrão pública, no conjunto de serviços do ComposeSimA chave anon entregue ao navegador e ao serviço de login.
FRONTEND_SUPABASE_URLPUBLIC_URL/supabase no conjunto de serviços incluídoSimA URL do Supabase que o navegador usa, gravada em /config.js na inicialização. Defina-a quando usar um projeto gerenciado no Supabase.
SUPABASE_JWT_SECRETUm segredo padrão públicoSimO segredo que assina as chaves anon e service-role no conjunto de serviços incluído. Gere os três valores com node tools/generate-selfhost-keys.mjs.
POSTGRES_PASSWORDnodaro-postgres-pwSimA senha do banco de dados incluído. As senhas das roles internas só a acompanham na primeira inicialização do banco de dados.
DATABASE_URLpostgres://postgres:nodaro-postgres-pw@db:5432/postgresSimUma URL direta do Postgres, usada só para aplicar as migrações na inicialização. Mantenha a senha dela igual à de POSTGRES_PASSWORD.
RUN_MIGRATIONS_ON_BOOTfalse; true no conjunto de serviços do ComposeSimAplica supabase/migrations/ antes de a API iniciar. Defina false com um projeto gerenciado no Supabase.
SUPABASE_MANAGED_PROXYnão definidaNãotrue serve um projeto gerenciado no Supabase pela própria origem do app. Veja Banco de dados.
SUPABASE_PROXY_UPSTREAMnão definidaNãoA origem do projeto gerenciado, sem caminho, para o proxy acima.

Filas

VariávelPadrão.envO que faz
REDIS_URLredis://localhost:6379; redis://redis:6379 no conjunto de serviços do ComposeNãoO Redis das filas e dos caches compartilhados. Uma URL de cluster ou de Sentinel também funciona.

Armazenamento

VariávelPadrão.envO que faz
R2_ENDPOINThttp://minio:9000 no conjunto de serviços do ComposeSimA URL da API S3 do armazenamento. No conjunto de serviços do Compose, um valor vazio volta ao MinIO.
R2_FORCE_PATH_STYLEtrue no conjunto de serviços do ComposeSimEndereçamento no estilo de caminho (path-style), que a maioria dos armazenamentos auto-hospedados exige.
R2_ACCOUNT_IDvaziaSimO ID da conta do Cloudflare. Fora do conjunto de serviços do Compose, o endpoint do R2 é derivado dele quando R2_ENDPOINT não está definida.
R2_ACCESS_KEY_ID, R2_SECRET_ACCESS_KEYAs credenciais do MinIO incluídoSimAs credenciais do armazenamento. No conjunto de serviços do Compose, elas também são as credenciais de superusuário do MinIO.
R2_BUCKET_NAMEnodaro-assets no conjunto de serviços do ComposeSimO bucket. Fora do conjunto de serviços do Compose, o padrão é scenenode-assets, então sempre defina essa variável.
R2_PUBLIC_URLhttp://localhost:3000/storage/nodaro-assets no conjunto de serviços do ComposeSimA URL pública do bucket.
R2_REGIONautoSimA região S3. Defina uma região real para a AWS, o DigitalOcean Spaces (nyc3 e outras) e um Supabase local (local).
STORAGE_OBJECT_ACLvazia (sem cabeçalho de ACL)SimUma ACL pré-configurada em cada objeto enviado, para armazenamentos que recusam uma política de bucket. Veja Instalação.
R2_PUBLIC_FALLBACK_DOMAINvaziaNãoUm segundo host público para a mídia, por exemplo o endereço r2.dev direto ao lado de um domínio de CDN.
R2_SHARED_WITH_RELAY_TARGETfalseNãotrue só quando R2_PUBLIC_URL aponta para o mesmo bucket em que o seu host do Nodaro Cloud grava. Veja Conectar ao Nodaro Cloud.
STORAGE_DELETESonSimskip faz esta instalação não apagar nada do armazenamento. Toda exclusão é ignorada com o aviso storage deletes are off on this deployment no log, e o arquivo fica. As linhas ainda são removidas, e os links e as cotas de armazenamento são atualizados como antes. Use em uma instalação que compartilha o armazenamento de mídia com outra instalação, mas tem a sua própria cópia do banco de dados, por exemplo um ambiente de staging restaurado da produção. on, sem valor ou vazio apaga como antes. Qualquer outro valor impede a API de iniciar. Reinicie para aplicar.

Vários nós medem a entrada antes de uma execução ser cobrada, por exemplo Cortar vídeo, Vídeo em loop, Combinar vídeos, Efeitos sonoros para vídeo, Dublagem e Sincronização labial. O servidor só lê um link de mídia de um endereço público. Um link para um endereço de loopback ou privado, ou um link que redireciona para um deles, é recusado. O seu próprio armazenamento é a exceção. Quando R2_PUBLIC_URL está em um endereço privado, como o MinIO incluído, o servidor baixa um arquivo armazenado, de até 2 GiB, e o mede no disco.

Envios grandes direto para o armazenamento

Arquivos com mais de 500 MB podem ser enviados em partes, direto do navegador para o bucket, com POST /v1/uploads/large/* (o uploads.uploadLarge do SDK). O navegador envia cada parte com um PUT para uma URL pré-assinada no endpoint S3 do armazenamento, o R2_ENDPOINT ou o endpoint R2 do R2_ACCOUNT_ID. As partes nunca passam pelo app. Arquivos menores continuam passando pelo POST /v1/upload, que não precisa de nada disso. Configure duas coisas no bucket, fora do app:

  1. CORS para PUT. Permita o método PUT de toda origem web que envia arquivos assim: o PUBLIC_URL, cada entrada do CORS_ORIGIN e qualquer outro site seu que use o SDK em um navegador. Permita o cabeçalho de requisição content-type. Nenhum cabeçalho de resposta precisa ser exposto. Sem essa regra, as partes do navegador falham na verificação prévia (preflight). Servidores, e o SDK fora de um navegador, não precisam de nada.
  2. Uma regra de ciclo de vida que cancela envios multipart incompletos depois de 1 dia. Essa regra é obrigatória. Um navegador que sai no meio de um envio deixa partes no bucket, e nada no app as remove. As partes nunca contam no armazenamento de ninguém, mas ocupam espaço: no máximo 3 envios abertos de até 10 GiB por conta ao mesmo tempo. No Cloudflare R2, a regra fica em Settings › Object lifecycle rules › Abort incomplete multipart uploads, no bucket. O MinIO remove sozinho os envios incompletos antigos, depois de 24 horas por padrão (a configuração stale_uploads_expiry); confira se são no máximo 1 dia. Em qualquer outro armazenamento, defina a regra equivalente.

No Cloudflare R2, a regra de CORS fica em Settings › CORS policy, no bucket, por exemplo:

[{ "AllowedOrigins": ["https://app.example.com"], "AllowedMethods": ["PUT"],
   "AllowedHeaders": ["content-type"], "MaxAgeSeconds": 3600 }]

No MinIO, defina o CORS do bucket, ou o MINIO_API_CORS_ALLOW_ORIGIN do servidor. O navegador também precisa alcançar o próprio endpoint S3. No MinIO incluído no conjunto de serviços do Compose, esse endpoint é interno (http://minio:9000), então um navegador não consegue enviar arquivos assim, a menos que você o exponha. Em uma instalação assim, deixe os arquivos com mais de 500 MB para clientes fora do navegador. Uma instalação que registra uma política de upload tem esse caminho fechado, e o início responde 409 large_upload_unavailable, porque a política não conseguiria ler bytes que nunca passam pelo app.

Provedores de modelos

Cada uma destas chaves também pode ser colada em /setup. Uma chave definida no ambiente tem prioridade. Veja Chaves de provedor.

VariávelPadrão.envO que habilita
NODARO_API_KEYvaziaSimO Nodaro Cloud como provedor, com um token de API pessoal.
KIE_API_KEYvaziaSimA maior cobertura de modelos de mídia e de texto.
KIE_API_BASE_URLO host de API do próprio provedorSimEnvia o tráfego desse provedor pelo seu próprio proxy. Também redireciona o tráfego de texto do Claude e do Gemini que roda com a KIE_API_KEY.
REPLICATE_API_TOKENvaziaSimUm catálogo alternativo, incluindo os modelos Flux 2.
ANTHROPIC_API_KEYvaziaSimO Claude, diretamente, para os nós de texto.
GEMINI_API_KEYvaziaSimO Gemini, diretamente. Veja Modelos Gemini.
ELEVENLABS_API_KEYvaziaSimFala, vozes e dublagem.
ELEVENLABS_BASE_URLhttps://api.elevenlabs.ioSimEnvia o tráfego da ElevenLabs pelo seu próprio proxy.
FAL_KEYvaziaSimModelos como o Sync Lipsync v3 e o motor Gemini Omni Flash 1.2 do Estender vídeo.
HEYGEN_API_KEYvaziaSimAvatar de IA e Avatar cinematográfico.
BEEBLE_API_KEYvaziaSimReiluminar e trocar.
APIFY_API_TOKENvaziaSimExtrair da web e Captura de site.
SITE_CAPTURE_ENABLEDativadaNãofalse desativa o nó Captura de site, POST /v1/site-capture e a ferramenta capture_site do MCP nesta instalação.
HEYGEN_CATALOG_REFRESH_HOURS24NãoA frequência com que a lista compartilhada de avatares e vozes da HeyGen é atualizada.
VOICE_LIBRARY_REFRESH_HOURS6NãoA frequência com que a instalação lê de novo a biblioteca compartilhada de vozes da ElevenLabs, para as contagens dos filtros da biblioteca. Precisa de ELEVENLABS_API_KEY.
VOICE_PREVIEW_PROXYnão definidaNãotrue serve as prévias de voz pelo seu próprio host. Veja Prévias de voz pelo seu próprio host.

Conexão com o Nodaro Cloud

VariávelPadrão.envO que faz
NODARO_CLOUD_URLhttps://app.nodaro.aiSimO host do Nodaro Cloud em que o botão Conectar o nodaro.ai faz o registro, e para onde vão as chamadas feitas com a NODARO_API_KEY. Mude essa variável só quando a sua instalação pertencer a uma implantação dedicada do Nodaro. Ela é lida na inicialização.

NODARO_API_KEY e R2_SHARED_WITH_RELAY_TARGET também fazem parte da conexão. Veja Conectar ao Nodaro Cloud.

Workers e desempenho

VariávelPadrão.envO que faz
MAX_CONCURRENT_NODES_PER_EXECUTION6, no máximo 20NãoQuantos nós uma execução de workflow pode executar ao mesmo tempo.
VIDEO_WORKER_CONCURRENCY50NãoTarefas em paralelo no worker de mídia, que passa a maior parte do tempo esperando os provedores.
ORCHESTRATOR_CONCURRENCY20NãoTarefas em paralelo no orquestrador.
RENDER_WORKER_CONCURRENCY2, no máximo 10NãoRenderizações em paralelo. Cada renderização roda um Chrome sem interface.
REMOTION_CONCURRENCY2 para cenas 3D; metade dos núcleos da CPU para as outras renderizaçõesNãoAbas do navegador por renderização. Um valor que você define vale para os dois casos. Mantenha-o baixo quando várias tarefas 3D são executadas ao mesmo tempo: cada aba WebGL acrescenta threads e conta para o limite de processos do contêiner.
FFMPEG_CONCURRENCY4, no máximo 32NãoProcessos do ffmpeg ao mesmo tempo, somando todos os nós de edição de vídeo e de áudio.
UV_THREADPOOL_SIZE16 em todas as imagensNãoO tamanho do pool de threads de worker do Node, que também executa toda consulta de DNS. O padrão do próprio Node é 4, então defina-a quando você roda o backend fora da imagem. Lida quando um processo inicia.
RAILWAY_DEPLOYMENT_DRAINING_SECONDSnão definidaNãoSó no Railway: o tempo entre o sinal de parada e a parada forçada de um contêiner substituído. O worker de mídia drena durante esse tempo menos 5 segundos. Sem a variável, ele drena por 25 segundos.

Leia Escalonamento antes de aumentar esses valores.

Editores

VariávelPadrão.envO que faz
FREECUT_URLvazia (o editor hospedado)SimO editor de vídeo por trás de Editar no NodarCut, no canvas, e de Editar, em um resultado de vídeo de um app. off, none, false ou disabled remove a ação de todos os lugares: nenhum resultado de vídeo no canvas, em uma apresentação ou em um app publicado a oferece.
AUDIOMASS_URLvazia (sem editor de áudio)SimO editor de áudio por trás de Editar, em um resultado de áudio. Vazia, mantém a ação, que abre um painel que explica o que definir. off remove a ação de todos os lugares.

Veja Editores de vídeo e de áudio.

Atualizações

VariávelPadrão.envO que faz
NODARO_IMAGEghcr.io/nodaroai/nodaro-community:latestSimA imagem do app que o arquivo do Compose roda. Fixe aqui uma tag de versão.
NODARO_UPDATE_CHECKativadaNãooff desliga a verificação diária de atualizações: nenhuma requisição sai da instalação. Para instalações isoladas da internet (air-gapped).
NODARO_UPDATE_CHECK_TOKENvazia (anônima)NãoUm token do GitHub para a verificação de atualizações, sem escopos.

Veja Atualização.

MCP

VariávelPadrão.envO que faz
MCP_ENABLEDdesativadoNãotrue ou 1 serve o endpoint MCP.
MCP_PUBLIC_URLvazia (o host MCP do Nodaro Cloud)NãoO endereço público do seu host MCP. Não é necessário com o MCP por caminho.
MCP_DYNAMIC_REGISTRATIONallowlistNãoO registro dinâmico de clientes MCP: allowlist, open ou off.
MCP_DCR_ALLOWLIST14 clientes conhecidosNãoOs nomes de cliente que podem se registrar no modo allowlist.
MCP_ALLOWED_CLIENT_IDSvazia (sem lista)NãoOs client_ids de apps de desenvolvedor, separados por vírgula, que podem usar o endpoint do MCP. Quando ela está definida, nenhum outro cliente pode usar o MCP, e o registro dinâmico fica desligado. Uma entrada malformada impede a inicialização. Veja MCP só pelo seu próprio cliente.
MCP_ASSERTION_EXCHANGE_CLIENT_IDSvazia (desligada)NãoO cliente ou os clientes da lista que podem trocar uma asserção assinada pelo seu provedor de identidade por um token do MCP, sem tela de consentimento. Veja A troca de asserção.
MCP_ASSERTION_EXCHANGE_TOKEN_TTL_SECONDS3600NãoQuanto tempo vale um token da troca de asserção, de 300 a 86400 segundos. Qualquer outro valor impede a inicialização.
MCP_TOOLS_BUILT_ONCEdesligadaNãoExperimental. true monta as ferramentas do endpoint MCP uma vez para cada tipo de requisição e as mantém, em vez de montá-las a cada requisição. As respostas são as mesmas; uma requisição gasta menos memória e tempo. Lida na inicialização, então reinicie depois de uma mudança.

Veja MCP.

Login e funções

VariávelPadrão.envO que faz
EXTERNAL_SSO_PROVIDERSvazia (SSO desativado)NãoProvedores de identidade confiáveis, como JSON inline ou @/path/to/file.json. Um valor malformado interrompe a inicialização.
EXTERNAL_SSO_LINK_EXISTINGfalseNãoSe o login único (SSO) pode ser vinculado a uma conta local existente.
PLATFORM_OWNER_EMAILvaziaNãoBusiness: a conta do proprietário, cuja função nenhum outro administrador pode alterar.

Veja Login único (SSO) e Primeiro usuário e administrador.

Integrações

VariávelPadrão.envO que faz
FIGMA_PLUGIN_OAUTH_CLIENT_IDvazia (conexão do plugin desativada)NãoO ID do cliente do app de desenvolvedor pelo qual o plugin do Figma se conecta.
Variáveis das redes sociaisvaziasNãoVeja Apps das redes sociais.

Para o plugin do Figma, registre um app de desenvolvedor na sua instalação com <PUBLIC_URL>/v1/oauth/plugin/callback como URI de redirecionamento e os escopos jobs:read, assets:read, assets:write e credits:read. Depois, defina aqui o ID do cliente dele. Quando a variável está vazia, as rotas de conexão do plugin respondem 503, e nada mais muda. Veja Apps OAuth.

Configurações fixadas na compilação

Estas configurações são fixadas quando a imagem é compilada. Altere-as em build: args: do arquivo do Compose e recompile.

Argumento de compilaçãoPadrãoO que faz
VITE_EDITIONcommunity no arquivo do ComposeA edição que o editor mostra. A compilação recusa um valor vazio ou desconhecido.
VITE_STUDIO_URLhttps://studio.nodaro.aiO endereço dos links Abrir no Studio.
VITE_PERSON_URLhttps://person.nodaro.aiO endereço do cartão Abrir Person da tela inicial.

Editores de vídeo e de áudio

Editar no NodarCut, em um resultado de vídeo no canvas, e Editar, em um resultado de vídeo de um app, abrem o editor de vídeo NodarCut. Editar, em um resultado de áudio de um app, abre o editor AudioMass. A sua mídia não vai para o servidor do editor: o app lê o arquivo do seu próprio armazenamento e o entrega ao editor dentro do navegador. A edição e a exportação acontecem ali.

  • Vídeo. Com FREECUT_URL vazia, o editor é carregado de freecut.nodaro.ai, que só permite ser incorporado a partir de http://localhost:3000. Em outra origem, como um endereço da LAN ou um domínio, o navegador o recusa, e o painel explica o motivo. Abra um chamado no GitHub com a URL que você serve para que ela seja permitida, ou rode o seu próprio FreeCut. O FreeCut é público, tem licença MIT e inclui um Dockerfile. Depois, defina FREECUT_URL=https://freecut.example.internal. Para remover a ação do editor de vídeo de todos os lugares, defina FREECUT_URL=off.
  • Áudio. Não existe um AudioMass público hospedado, então, até você configurá-lo, Editar, em um resultado de áudio, não abre nenhum editor. Ele abre um painel que explica o que definir, na aba Apresentar do editor, em uma apresentação compartilhada e em um app publicado, da mesma forma. Para remover a ação do editor de áudio de todos os lugares, defina AUDIOMASS_URL=off (none, false e disabled também funcionam). Rode a versão derivada mantida pelo Nodaro, o AudioMass, que aceita a transferência dentro do navegador que falta no AudioMass original. Depois, defina AUDIOMASS_URL=https://audiomass.example.internal.

Reinicie o conjunto de serviços depois de uma alteração. Não é preciso recompilar.

Prévias de voz pelo seu próprio host

As listas de vozes, GET /v1/voices e GET /v1/voices/library, dão o preview_url de cada voz como um endereço no armazenamento do próprio provedor de fala. Numa rede que filtra toda requisição do navegador pelo nome do host, o navegador não alcança esses endereços, e nenhum seletor de voz consegue tocar uma prévia. Defina VOICE_PREVIEW_PROXY=true, e as listas passam a dar cada prévia como um endereço no seu próprio host: /v1/voices/<voiceId>/preview?src=…&sig=…. A API busca o arquivo do provedor e o transmite ao navegador.

  • O endereço é assinado. A chave da assinatura vem de INTERNAL_ORCHESTRATOR_SECRET. A rota só busca um arquivo que as listas entregaram, para a voz com que o entregaram, e responde 404 para qualquer outra coisa, antes de buscar algo.
  • A restrição de vozes vale. Quando o perfil de superfície restringe os gêneros de voz, a rota recusa uma voz de outro gênero com 400 voice_not_available, antes de buscar algo. Veja Gêneros de voz.
  • Tamanho e cache. A rota só serve um arquivo audio/* de até 4 MB. Ela guarda cada arquivo na memória por um dia, até 32 MB no total, e por isso pede cada arquivo ao provedor uma vez só. Ela responde a intervalos de bytes com 206. Os navegadores guardam uma prévia por um dia.
  • O MCP não muda. Uma ferramenta MCP que lê as listas de vozes continua recebendo os endereços do provedor.
  • Só numa origem. O endereço da prévia é um caminho, então só toca onde a API responde na mesma origem das páginas, como no contêiner padrão. Não defina a variável quando a sua API roda em outro host.
  • Vozes salvas. Um personagem ou uma criatura salvos com uma voz dessas listas guardam o endereço no seu host como voice.previewUrl. A prévia continua tocando enquanto a variável continuar true e INTERNAL_ORCHESTRATOR_SECRET não mudar.

Só o valor exato true ativa o recurso. Sem ela, as listas respondem como antes, e /v1/voices/<voiceId>/preview responde 404. Adicione a variável em environment: do serviço nodaro e reinicie.

Logotipos dos desenvolvedores de modelos

GET /v1/models indica o desenvolvedor de cada modelo e pode trazer o logotipo dele como logoUrl, para apps que desenham um seletor de modelos. O logotipo de uma empresa é uma marca registrada dela, por isso nenhum logotipo acompanha o Nodaro. Uma instalação publica só os logotipos que tem o direito de exibir. O logoUrl de qualquer outro desenvolvedor é null, e os apps mostram então o nome do desenvolvedor. Uma instalação que não publica nenhum logotipo não precisa de configuração.

Para publicar o logotipo de um desenvolvedor:

  1. Envie o arquivo para o bucket por trás de R2_PUBLIC_URL, em brand/makers/<maker id>.svg, com o tipo de conteúdo image/svg+xml. Use o logotipo oficial da empresa como um SVG sem scripts. Os IDs dos desenvolvedores são os valores de maker.id que GET /v1/models retorna.
  2. Declare os IDs dos desenvolvedores na configuração da instância model_maker_logos, uma lista como ["google", "openai"]. Numa instalação Business, o operador da plataforma a define com PUT /v1/admin/settings/model_maker_logos e o corpo {"value": ["google", "openai"]}. Na Community Edition, que não tem painel de administração, grave a mesma configuração da instância diretamente no banco de dados.
  • O servidor verifica o arquivo primeiro. Um desenvolvedor declarado só recebe um logoUrl quando o arquivo dele está no bucket como SVG, então as duas etapas podem vir em qualquer ordem. Um arquivo ausente ou com o tipo errado gera null, nunca um endereço quebrado.
  • Nunca abra o endereço num navegador para testar um envio. A CDN, e o Caddy no conjunto de serviços incluído, guardam uma resposta “não encontrado” por um ano. Verifique o arquivo no console do armazenamento ou com uma requisição HEAD, como curl -I.
  • Prazo. Um logotipo novo aparece em cerca de dez minutos. Para substituir um logotipo, envie o arquivo novo por cima do antigo: o endereço muda com o arquivo. Para retirar um, remova o ID dele da configuração ou exclua o arquivo.
  • O Nodaro nunca exclui esses arquivos. Remova um logotipo pelo console do armazenamento quando quiser.

Idioma padrão

DEFAULT_LOCALE define o idioma em que um novo visitante começa. Os valores são he, ar, de, fr, es, hi, ja, ko, pt-BR, ru, zh-CN e en. A escolha que o próprio usuário salvou sempre prevalece. Um valor vazio, em branco ou desconhecido volta ao idioma do navegador do visitante. Reinicie para aplicar. Veja Idiomas.

Pacotes de tutoriais

Uma instalação auto-hospedada pode adicionar os próprios tutoriais ao conjunto nativo, sem recompilar. Cada pacote é um diretório:

  • manifest.json — o name do pacote e as categories que os tutoriais dele usam, cada uma com um slug, um name e, opcionalmente, um sortOrder e uma description. Chaves opcionais: locale, version, forbiddenPromptTerms e creatorDisplayName, o nome do autor mostrado em todos os cartões do pacote.
  • Um arquivo *.json por tutorial — um instantâneo de workflow com os nós, as conexões e os resultados já prontos, para que um clone abra mostrando a execução concluída. Dados opcionais do cartão: estimatedCredits, os créditos de uma execução, e estimatedPerMinuteCredits, para um tutorial cujo preço acompanha a duração da gravação que ele recebe. Esse tutorial define estimatedCredits como a parte fixa e estimatedPerMinuteCredits como os créditos por minuto da gravação. Também opcionais: nodeTypesUsed e providersUsed, para os chips do cartão, um creatorDisplayName por tutorial e listedIn. listedIn é ["tutorial"] para a aba Tutoriais, o padrão, ou ["marketplace"] para o marketplace de templates. Ele só vale no primeiro seed.

Toda mídia que um tutorial usa precisa ser uma URL https:// pública. A categoria de cada tutorial precisa ser declarada no manifesto, e ela é criada na primeira inicialização.

Monte os diretórios dos pacotes no contêiner como somente leitura e liste os caminhos deles dentro do contêiner:

  nodaro:
    volumes:
      - ./tutorials/acme:/data/tutorials/acme:ro
NODARO_TUTORIAL_PACKS=/data/tutorials/acme

Os pacotes só adicionam tutoriais; eles nunca mudam os nativos. Um pacote que falha na validação é ignorado por inteiro e anotado no registro. A validação falha com um JSON inválido, uma categoria não declarada, uma URL de mídia que não é pública ou um slug que colide com um tutorial existente. Reinicie o contêiner para carregar um pacote alterado.

Apps das redes sociais

A publicação em redes sociais funciona por rede. Uma rede fica disponível assim que as credenciais do app OAuth dela são definidas. Sem elas, a rede continua aparecendo em Configurações › Integrações como indisponível, com os nomes das variáveis que faltam.

RedeVariáveis
InstagramMETA_APP_ID, META_APP_SECRET. Opcional: META_INSTAGRAM_CONFIG_ID, para o Facebook Login for Business.
Instagram, sem uma Página do FacebookINSTAGRAM_APP_ID, INSTAGRAM_APP_SECRET. A Meta emite essas credenciais separadamente do app do Facebook. Os tokens se renovam sozinhos, a cada cerca de 60 dias.
FacebookMETA_APP_ID, META_APP_SECRET. Opcional: META_FACEBOOK_CONFIG_ID.
TikTokTIKTOK_CLIENT_KEY, TIKTOK_CLIENT_SECRET
YouTubeGOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET
LinkedInLINKEDIN_CLIENT_ID, LINKEDIN_CLIENT_SECRET
XX_CLIENT_ID, X_CLIENT_SECRET
RedditREDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET
PinterestPINTEREST_CLIENT_ID, PINTEREST_CLIENT_SECRET
DiscordDISCORD_CLIENT_ID, DISCORD_CLIENT_SECRET, DISCORD_BOT_TOKEN
TwitchTWITCH_CLIENT_ID, TWITCH_CLIENT_SECRET
ThreadsTHREADS_APP_ID, THREADS_APP_SECRET
MastodonMASTODON_CLIENT_ID, MASTODON_CLIENT_SECRET. Opcional: MASTODON_URL, com o padrão mastodon.social.
TelegramNenhuma: os usuários colam o próprio token de bot.
BlueskyNenhuma: os usuários se conectam com um handle e uma senha de app.
Dev.to, Hashnode, MediumNenhuma: os usuários se conectam com a própria chave de API ou o próprio token.
WordPressNenhuma: os usuários se conectam com a URL do site e uma senha de aplicativo.
LemmyNenhuma: os usuários se conectam com uma instância, um login e uma comunidade.

Todo app OAuth precisa permitir a URI de redirecionamento https://<your-domain>/v1/social/callback/<network>. Quando um login do Facebook ou do Instagram gerencia mais de uma Página ou conta, a janela de conexão pergunta ao usuário qual delas conectar. Veja Publicar nas redes sociais.

Perguntas frequentes

Por que uma variável no meu arquivo .env não tem efeito?

O arquivo do Compose só repassa ao app as variáveis listadas no bloco environment do serviço nodaro. Adicione qualquer outra variável a esse bloco no docker-compose.community.yml e depois rode docker compose up -d.

Quais variáveis de ambiente são obrigatórias?

Nenhuma no conjunto de serviços do Compose incluído, que as define ou as gera. Fora dele, a API se recusa a iniciar sem SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY e um INTERNAL_ORCHESTRATOR_SECRET de pelo menos 32 caracteres.

Preciso reiniciar depois de alterar uma variável?

Sim. O Nodaro lê o ambiente na inicialização, então rode docker compose up -d para recriar o contêiner com os novos valores. As chaves de provedor coladas em /setup são a exceção e passam a valer sem reinicialização.

Como mudo o idioma padrão da minha instalação?

Defina DEFAULT_LOCALE, por exemplo DEFAULT_LOCALE=de, e reinicie. Um novo visitante começa nesse idioma. A escolha que o próprio usuário salvou sempre prevalece, e um valor desconhecido volta ao idioma do navegador.

Como adiciono os meus próprios tutoriais a uma instalação auto-hospedada?

Coloque cada pacote de tutoriais em um diretório com um manifest.json e um arquivo JSON por tutorial, monte-o no contêiner e liste os diretórios em NODARO_TUTORIAL_PACKS. Reinicie para carregá-los.

Última atualização

Nesta página