Início rápido

Deixe a IA construir#

zeltro create "A timeclock for employees in Django"

Descreva o que você quer em linguagem simples. O Zeltro envolve sua ideia com as instruções da plataforma e a entrega ao CLI de IA que você configurou.

A partir daí o trabalho é dividido, e essa divisão é o ponto principal:

  • O Zeltro cria o projeto, cria e conecta o banco de dados, instala o framework ou app, gera o .env, atribui um endereço ao projeto, inicia o contêiner e devolve uma URL funcionando.
  • A IA só personaliza o que fica por cima — models, rotas, templates, regras de negócio — e depois atualiza o README do projeto com a URL e as credenciais, se houver.

O agente nunca precisa descobrir como configurar o nginx, escolher uma porta ou provisionar um banco de dados. Ele chama um comando do Zeltro e recebe um projeto rodando. É daí que vem a economia de prompt e de tokens.

zeltro create "A customer check-in system in Laravel"
zeltro create "An inventory tracker in Express"
zeltro create "New Grafana"
zeltro create "https://github.com/monicahq/monica"

Rode sem argumentos em um terminal e ele pergunta o que você quer construir:

zeltro create

Prompts longos podem vir de um arquivo ou da stdin:

zeltro create -f spec.md
zeltro create < spec.md
cat spec.md | zeltro create

Antes, defina seu agente com zeltro ai-set. Veja Fluxo de trabalho com IA para o quadro completo.

Ou crie a estrutura você mesmo#

Primeiro o framework, depois o nome:

zeltro new laravel my-shop
zeltro new django survey-app
zeltro new flask my-api
zeltro new express my-service

O banco de dados é escolhido automaticamente conforme o framework (PHP/Node → MySQL, Python → PostgreSQL). Para trocar:

zeltro new flask notes --database sqlite
zeltro new express api --database postgres

Lista completa de frameworks e opções: Frameworks.

Ou instale algo pronto#

zeltro install grafana
zeltro install gitea
zeltro install n8n

Cada um sobe totalmente configurado, no endereço que o zeltro status mostra. Veja todos os mais de 200: Biblioteca de apps.

new vs install: new cria a estrutura de um projeto vazio que você escreve. install implanta um app pronto que outra pessoa escreveu. Se você escolher o errado, o Zeltro indica o comando certo.

Ou traga um projeto existente#

# clone a repo and adapt it
zeltro clone work-directly https://github.com/user/my-app
zeltro clone fork https://github.com/user/my-app
zeltro clone new-repo https://github.com/user/my-app my-app

# already have the folder in your projects directory (~/zeltro-projects by default)
zeltro setup my-project
zeltro up my-project

O Zeltro adapta automaticamente o docker-compose.yaml que o projeto já tem — os bancos de dados embutidos são removidos e apontados para os serviços compartilhados, e o original é guardado como docker-compose.upstream.yaml. Veja Arquitetura → Adaptação do compose.

No dia a dia#

zeltro up my-project      # start one project (shared services start too)
zeltro up-all             # start everything
zeltro down my-project    # stop one project
zeltro down-all           # stop everything (shared services keep running)
zeltro status             # what's running
zeltro stop-services      # stop the shared services too

Para abrir um projeto, rode zeltro status my-project. Ele mostra dois endereços:

  • LOCAL ACCESS, para um navegador nesta máquina. No Linux é o IP do próprio contêiner, como http://10.x.x.x. No macOS é http://localhost:<port>.
  • LAN ACCESS, para outras máquinas da sua rede: http://<this-machine's-IP>:<port>.

http://my-project/ não funciona no seu navegador. O Zeltro não escreve no /etc/hosts, então os nomes dos projetos só são resolvidos entre contêineres.

Achou um erro nesta tradução? Avise a gente no GitHub.