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

Início rápido

Inicie a Community Edition auto-hospedada do Nodaro com dois comandos, verifique-a em /setup e adicione uma chave de provedor ou o Nodaro Cloud para gerar.

O início rápido da Community Edition leva você do zero a um Nodaro auto-hospedado em funcionamento com dois comandos. O conjunto de serviços do Docker Compose traz o próprio banco de dados, login, armazenamento e filas, então não há contas de nuvem para criar, chaves de API para encontrar nem nada para configurar. Você precisa do Docker 24 ou mais recente, com o Docker Compose v2.

Iniciar o Nodaro

Clonar o repositório e iniciar o conjunto de serviços

git clone https://github.com/nodaroai/app.nodaro.ai.git nodaro
cd nodaro
docker compose -f docker-compose.community.yml up

A primeira inicialização baixa a imagem pré-compilada do app, de cerca de 2,4 GB, e os serviços incluídos. É um download, não uma compilação, então não sobrecarrega a sua CPU. As inicializações seguintes levam segundos.

Abrir o app e criar a sua conta

Abra http://localhost:3000 e crie uma conta com qualquer endereço de e-mail e senha. A conta funciona na hora, porque um conjunto de serviços local não envia e-mail de confirmação.

Na sua primeira visita, a tela inicial adiciona um workflow Welcome Demo. Ele é uma execução já concluída de roteiro, imagem, vídeo, voz e corte final, com todos os resultados prontos. Você pode abrir os nós dele e reproduzir o clipe final antes de configurar qualquer coisa.

Verificar a instalação em /setup

Abra http://localhost:3000/setup. A página mostra o status em tempo real do banco de dados, do Redis, do armazenamento, da chave de criptografia e das suas chaves de provedor, e não exige login. Em um conjunto de serviços novo, todos os cartões ficam verdes, exceto o das chaves de provedor.

Adicionar um provedor de modelos

Escolha uma das três formas abaixo. Quando houver um provedor, clique em Executar no nó Imagem da cena da demonstração. Ele usa o Z-Image, o modelo de imagem mais barato, e responde em segundos.

O que é iniciado

ServiçoO que fazOnde ficam os dados
Postgres (imagem do Supabase)O banco de dados. As migrações são aplicadas sozinhas na primeira inicialização.Volume db-data
GoTrueLogin com e-mail e senha. Não é preciso um servidor de e-mail.—
PostgRESTA API de dados com que o editor se comunica—
MinIOArmazenamento de mídia. As imagens, os vídeos e os áudios gerados ficam no seu disco.Volume minio-data
RedisFilas de tarefasVolume redis-data
NodaroO app: editor, API e workers, na porta 3000Volume app-data

O conjunto de serviços publica duas portas na sua máquina: a 3000, para o app, e a 9001, para o console do MinIO, esta só na interface de loopback.

Adicionar um provedor de modelos

Ver a demonstração é gratuito e funciona offline. Para você mesmo executar nós, a instalação precisa de um provedor de modelos. Até ter um, a tela inicial mostra o aviso Esta instalação ainda não consegue gerar, que pode ser dispensado, com um botão para cada opção.

As três formas podem funcionar lado a lado, com uma regra. Quando a instalação está conectada ao Nodaro Cloud e também tem uma NODARO_API_KEY, ela usa a conexão e ignora a chave.

Sem arquivos e sem reinicialização.

  1. Abra /setup e conclua a etapa 1, Crie seu login do servidor. Os cartões de integridade não exigem login, mas salvar uma chave exige.
  2. Encontre os blocos dos provedores na seção Integridade da instalação. Os mesmos blocos ficam no app, em Integrações › Provedores de modelos.
  3. Clique em Colar chave em um bloco, cole a chave e salve.

Cada bloco diz o que a chave dele habilita e onde conseguir uma. A chave é armazenada criptografada no seu próprio banco de dados e passa a valer na hora. Se você se conectar ao Nodaro Cloud, nenhum bloco é obrigatório: a conexão cobre todos eles.

Sem chaves para gerenciar.

  1. Em /setup, na etapa 2, Conecte um provedor de modelos, clique em Conectar o nodaro.ai.
  2. O navegador abre a tela de consentimento do Nodaro Cloud. Faça login, ou crie uma conta gratuita com 300 créditos, e aprove.
  3. Você volta para a sua instalação, já conectada.

Os modelos de imagem, vídeo, fala e texto passam, então, a ser executados pela sua conta do Nodaro Cloud e são cobrados em créditos. Leia Conectar ao Nodaro Cloud para ver os detalhes.

Para infraestrutura como código. Crie um arquivo chamado .env ao lado do arquivo do Compose:

KIE_API_KEY=...            # broadest model coverage
# or
REPLICATE_API_TOKEN=...
# or
NODARO_API_KEY=...         # a personal API token from app.nodaro.ai, Settings › API Tokens

Depois, aplique-o:

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

Uma chave no .env tem prioridade sobre uma chave colada na tela. O bloco dela mostra set (env) e não pode ser editado ali mesmo.

Leia Chaves de provedor para ver todos os provedores e o que cada um habilita.

Você paga os seus provedores diretamente. A Community Edition não tem sistema de créditos, taxas do Nodaro nem marca d’água.

Aprender o editor de graça

Os Tutoriais da tela inicial começam com um conjunto de guias passo a passo, adicionados na primeira inicialização. Navegar por eles não custa nada. As imagens, os vídeos e os áudios deles são carregados da CDN do Nodaro, então eles precisam de conexão com a internet. Veja Tutoriais e templates.

Verificar a instalação pela linha de comando

Para uma verificação mais profunda do que a /setup consegue mostrar, rode o teste de contrato a partir do seu clone. Ele precisa do Node.js.

node tools/community-smoke.mjs http://localhost:3000

O teste cria uma conta descartável, cria um workflow, envia uma geração, acompanha a tarefa até o estado final e informa quais verificações passaram. Uma verificação que não se aplica à sua instalação, por exemplo porque você já adicionou uma chave de provedor, é informada como ignorada. Sem flags extras, o teste nunca gasta nada.

Para testar também uma geração real, adicione --keyed:

node tools/community-smoke.mjs http://localhost:3000 --keyed

O --keyed precisa de uma KIE_API_KEY ou de um REPLICATE_API_TOKEN na instalação, no .env ou colados em /setup. Ele executa uma geração no modelo mais barato para essa chave: o Z-Image com a KIE_API_KEY e o Flux 2 Klein com o REPLICATE_API_TOKEN. Isso costuma custar menos de um centavo de dólar no provedor. Depois, o teste verifica se a mídia chegou ao armazenamento da própria instalação. Uma conexão ou um token do Nodaro Cloud é verificado separadamente.

Comandos do dia a dia

TarefaComando
Iniciar em segundo planodocker compose -f docker-compose.community.yml up -d
Acompanhar os registrosdocker compose -f docker-compose.community.yml logs -f
Parar o conjunto de serviçosdocker compose -f docker-compose.community.yml down
Aplicar um .env alteradodocker compose -f docker-compose.community.yml up -d

Nunca adicione -v ao down, a menos que seja essa a intenção: docker compose down -v apaga os volumes e, com eles, o seu banco de dados e a sua mídia.

Antes que outras pessoas possam acessar a instalação

Os padrões do Compose foram feitos para uso local e são públicos. Antes de expor o conjunto de serviços a uma rede, gere novas chaves de autenticação, defina novas senhas para o banco de dados e o armazenamento e sirva a instalação por HTTPS. Siga Proteger a instalação e Proxy reverso e HTTPS.

Próximos passos

Perguntas frequentes

Quanto tempo leva a primeira inicialização de um Nodaro auto-hospedado?

A primeira inicialização baixa a imagem pré-compilada do app, de cerca de 2,4 GB, e os serviços incluídos, então leva alguns minutos em uma conexão comum. É um download, não uma compilação. As inicializações seguintes levam segundos.

Preciso de um arquivo .env para rodar a Community Edition?

Não. Todo valor do docker-compose.community.yml tem um padrão que funciona. Crie um arquivo .env só para adicionar chaves de provedor, mudar a URL pública ou usar os seus próprios serviços gerenciados.

Por que a minha instalação nova não consegue gerar nada?

Ela ainda não tem um provedor de modelos. Cole uma chave de provedor em /setup, defina uma no .env ou conecte a instalação a uma conta do Nodaro Cloud. A tela inicial mostra um aviso com as duas opções até que exista um provedor.

A instalação padrão é segura para colocar na internet?

Não. As chaves e as senhas padrão do arquivo do Compose são públicas. Antes que outras pessoas possam acessar a instalação, gere novas chaves de autenticação, defina novas senhas e sirva a instalação por HTTPS, atrás de um proxy reverso.

Quanto custa a Community Edition?

Você não paga nada ao Nodaro. Ela não tem sistema de créditos, taxas do Nodaro nem marca d’água. Você paga diretamente os seus provedores de modelos, ou paga em créditos o que é executado por uma conexão com o Nodaro Cloud.

Última atualização

Nesta página