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 upA 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ço | O que faz | Onde 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 |
| GoTrue | Login com e-mail e senha. Não é preciso um servidor de e-mail. | — |
| PostgREST | A API de dados com que o editor se comunica | — |
| MinIO | Armazenamento de mídia. As imagens, os vídeos e os áudios gerados ficam no seu disco. | Volume minio-data |
| Redis | Filas de tarefas | Volume redis-data |
| Nodaro | O app: editor, API e workers, na porta 3000 | Volume 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.
- Abra
/setupe conclua a etapa 1, Crie seu login do servidor. Os cartões de integridade não exigem login, mas salvar uma chave exige. - Encontre os blocos dos provedores na seção Integridade da instalação. Os mesmos blocos ficam no app, em Integrações › Provedores de modelos.
- 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.
- Em
/setup, na etapa 2, Conecte um provedor de modelos, clique em Conectar o nodaro.ai. - O navegador abre a tela de consentimento do Nodaro Cloud. Faça login, ou crie uma conta gratuita com 300 créditos, e aprove.
- 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 TokensDepois, aplique-o:
docker compose -f docker-compose.community.yml up -dUma 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:3000O 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 --keyedO --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
| Tarefa | Comando |
|---|---|
| Iniciar em segundo plano | docker compose -f docker-compose.community.yml up -d |
| Acompanhar os registros | docker compose -f docker-compose.community.yml logs -f |
| Parar o conjunto de serviços | docker compose -f docker-compose.community.yml down |
Aplicar um .env alterado | docker 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
- Instalação — a configuração completa, com serviços gerenciados, armazenamento e segredos.
- Proxy reverso e HTTPS — sirva a instalação no seu domínio.
- Atualização — tags de imagem e atualizações.
- Backup e restauração — um comando para cada operação.
- Solução de problemas — quando um cartão em
/setupestá vermelho.
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.
Páginas relacionadas
Instalação
Chaves de provedor
Conectar ao Nodaro Cloud
Proxy reverso e HTTPS
Solução de problemas
Última atualização
Gerador de IA auto-hospedado
Rode o Nodaro como gerador auto-hospedado de vídeos, imagens e músicas com IA no seu servidor, com suas chaves e armazenamento, grátis pela licença fair-code.
Requisitos
O que o Nodaro auto-hospedado exige: Docker 24+ com Compose v2, banco Supabase, armazenamento compatível com S3, portas e chave de provedor ou o Nodaro Cloud.