> ## Documentation Index > Fetch the complete documentation index at: https://docs.evolutionfoundation.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Primeiros Passos com o EvoNexus > Como instalar e configurar o EvoNexus # Primeiros Passos com o EvoNexus ## Escolha seu método de instalação | Método | Ideal para | Requer | | - | - | - | | **[Docker](guides/docker-install)** | Quem quer uma instalação com um comando que funciona igual em qualquer SO (Linux, macOS, Windows+WSL2, VPS) | Docker Engine 24+ | | **CLI (`npx`)** | Usuários que querem rodar o EvoNexus junto com o Claude Code CLI já instalado | Claude Code, Python 3.11+, Node 18+, uv | | **Clone manual** | Desenvolvedores que querem modificar o código-fonte | git, Claude Code, Python 3.11+, Node 18+, uv | Em caso de dúvida, escolha o fluxo Docker. Continue lendo para o fluxo CLI. ## Pré-requisitos (apenas fluxo CLI) * **Claude Code CLI** — [Instalar Claude Code](https://claude.ai/claude-code) * **Python 3.11+** com [uv](https://docs.astral.sh/uv/) * **Node.js 18+** (para o dashboard) * **Chaves de API** das integrações que você quiser usar ## Instalação ### Opção A — Docker (mais rápido) Baixa as imagens oficiais multi-arch e roda o wizard em [http://localhost:8080](http://localhost:8080). Guia completo: [Instalando com Docker](guides/docker-install). ```bash theme={null} curl -O https://raw.githubusercontent.com/evolution-foundation/evo-nexus/main/docker-compose.hub.yml docker compose -f docker-compose.hub.yml up -d open http://localhost:8080 ``` Pule para [Use o Claude Code — comece pelo /oracle](#6-use-o-claude-code--comece-pelo-oracle) após o wizard concluir. ### Opção B — `npx` (fluxo CLI) ```bash theme={null} npx @evoapi/evo-nexus ``` Isso baixa e executa o wizard de setup interativo automaticamente. ### Opção C — Clone manual ```bash theme={null} git clone --depth 1 https://github.com/evolution-foundation/evo-nexus.git cd evo-nexus # Wizard de setup interativo make setup # Ou: python setup.py ``` O wizard pergunta: * Seu nome e empresa * Fuso horário e idioma * **Qual provedor de IA usar** (Anthropic por padrão; alternativas via OpenClaude) * Quais agentes habilitar * Quais integrações configurar E gera: * `config/workspace.yaml` — config central * `config/routines.yaml` — agendas das rotinas * `config/providers.json` — provedor de IA ativo + config do CLI backend * `.env` — chaves de API (preencha após o setup) * `CLAUDE.md` — arquivo de contexto para o Claude ### 2. Escolha seu Provedor de IA O wizard pergunta qual backend deve alimentar o EvoNexus. **A Anthropic é o padrão** — se você já tem o Claude Code autenticado, não precisa fazer mais nada. Para qualquer outro provedor (OpenRouter, OpenAI, Gemini, AWS Bedrock, Vertex AI, Codex Auth), o EvoNexus usa o [OpenClaude](https://www.npmjs.com/package/@gitlawb/openclaude), um binário drop-in compatível com o protocolo do Claude CLI. Instale uma vez: ```bash theme={null} npm install -g @gitlawb/openclaude ``` Em seguida, selecione o provedor no wizard (ou depois pela página **Providers** no dashboard) e preencha as chaves. O provedor ativo é armazenado em `config/providers.json` e tanto o terminal-server quanto o ADW runner releem o arquivo a cada nova sessão — não precisa reiniciar ao trocar. Veja [dashboard/providers](dashboard/providers) para a referência completa de provedores e [reference/env-variables](reference/env-variables) para todas as variáveis de ambiente relacionadas. ### 3. Configure as Chaves de API Edite `.env` com suas chaves: ```bash theme={null} nano .env ``` No mínimo, você precisa de: * Nenhuma chave para operação básica (agentes e skills funcionam sem integrações) * `DISCORD_BOT_TOKEN` — para monitoramento de comunidade * `STRIPE_SECRET_KEY` — para rotinas financeiras * Chaves OAuth de redes sociais — via página Integrations no dashboard ### 4. Inicie o Dashboard **Em VPS (remoto):** O wizard de setup cria automaticamente um usuário de sistema dedicado `evonexus` (o Claude Code recusa `--dangerously-skip-permissions` como root) e instala um **serviço systemd** que inicia no boot: ```bash theme={null} systemctl status evo-nexus # ver status systemctl restart evo-nexus # reiniciar journalctl -u evo-nexus -f # acompanhar logs su - evonexus # trocar para o usuário do serviço ``` Você também pode instalar o serviço systemd manualmente em uma instalação existente: ```bash theme={null} sudo bash install-service.sh ``` **Local (macOS/Linux):** ```bash theme={null} make dashboard-app ``` Abra [http://localhost:8080](http://localhost:8080) — a primeira execução mostra um wizard onde você cria a conta de admin e configura o workspace. Dashboard ### 5. Inicie as Rotinas Automatizadas Em VPS, o scheduler roda automaticamente dentro do serviço do dashboard. Localmente: ```bash theme={null} make scheduler ``` Isso inicia o scheduler que executa as rotinas nos horários configurados (veja `config/routines.yaml`). ### 6. Use o Claude Code — comece pelo `/oracle` Abra o Claude Code neste diretório. Ele lê o `CLAUDE.md` automaticamente e tem acesso a todos os agentes e skills. **A primeira coisa a executar: `/oracle`.** O Oracle é o ponto de entrada oficial — entrevista você sobre seu negócio, mapeia as capacidades do workspace para suas dores e entrega um **plano de ativação faseado** via skill `prod-activation-plan` (arquivo de índice + pasta-por-fase + arquivo-por-item, cada um com time de agentes sugerido e decisões pendentes). Você nunca precisa adivinhar o próximo passo. ```bash theme={null} /oracle # Comece aqui — discovery do negócio + plano de ativação ``` Após o plano ficar pronto, você pode invocar agentes individuais: ```bash theme={null} /clawdia # Hub de operações /flux # Análise financeira /atlas # Gestão de projetos /pulse # Pulso da comunidade /pixel # Redes sociais # Ou deixe o Claude rotear automaticamente conforme sua solicitação ``` ## Próximos Passos * Leia [Arquitetura](architecture) para entender como agentes, skills e rotinas trabalham juntos * Navegue por `.claude/skills/CLAUDE.md` para o índice completo de skills (175+ skills) * Confira `ROUTINES.md` para a documentação de rotinas * Customize `config/routines.yaml` para ajustar agendas This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.