> ## Documentation Index > Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt > Use this file to discover all available pages before exploring further. # Executar o n8n localmente com CometAPI > Use este guia para executar o n8n localmente com CometAPI, configurando definições de implantação local, credenciais e acesso a modelos. Implante o n8n na sua própria máquina e conecte-o ao CometAPI por meio do nó da comunidade para executar fluxos de trabalho automatizados de IA localmente. ## Pré-requisitos * Linux (Ubuntu/Debian/CentOS, etc.) ou macOS * 2 GB+ de RAM, 10 GB+ de espaço livre em disco * Acesso ao shell com acesso ao registro público do npm * Node.js 18.x ou 20.x LTS (consulte a Etapa 1) * Uma conta CometAPI com uma chave de API ativa — [obtenha a sua aqui](https://www.cometapi.com/console/token) Faça login no [console da CometAPI](https://www.cometapi.com/console/token). Clique em **Add API Key** e copie sua chave de API da CometAPI. Painel da CometAPI mostrando o botão Add API Key Detalhes da chave de API da CometAPI com URL base O n8n 1.x requer Node.js 18.x ou 20.x. A abordagem recomendada é o [nvm](https://github.com/nvm-sh/nvm): ```bash theme={null} # Install nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash # Reload your shell profile source ~/.bashrc # or ~/.zshrc on macOS # Install and activate the LTS version nvm install --lts nvm use --lts # Verify node -v npm -v ``` Se mais tarde você vir `n8n: command not found`, reinicie o terminal ou garanta que o diretório bin global do npm gerenciado pelo nvm esteja no seu `PATH`. ```bash theme={null} npm install -g n8n n8n -v # verify the installed version n8n start # runs on http://localhost:5678/ ``` Se a porta 5678 já estiver em uso: ```bash theme={null} export N8N_PORT=5679 n8n start ``` Para manter o n8n em execução após fechar o terminal: ```bash theme={null} npm install -g pm2 pm2 start "n8n" --name n8n pm2 save pm2 status ``` Terminal mostrando o n8n iniciando com sucesso Logs de inicialização do n8n no terminal Abra [http://localhost:5678/](http://localhost:5678/) no navegador. Na primeira execução, o assistente de configuração solicita que você crie uma conta **Owner** (email + senha). Conclua isso e faça login. Assistente de configuração da primeira execução do n8n solicitando os dados da conta Owner 1. Vá para **Settings** (canto inferior esquerdo) → **Community nodes** 2. Clique em **Install a community node** 3. Digite o nome do pacote: `@cometapi-dev/n8n-nodes-cometapi` 4. Marque a caixa de reconhecimento de risco e clique em **Install** Após a instalação, você poderá pesquisar por **CometAPI** no painel de nós. Painel Settings do n8n mostrando a seção Community nodes Caixa de diálogo de instalação com o nome do pacote CometAPI inserido Se a seção Community Nodes estiver ausente: verifique se você está conectado com a conta **Owner** e confira em **Settings → Security** se a instalação de nós da comunidade está habilitada. 1. Clique em **+ New** no topo para criar um workflow. 2. Clique em **+** na tela e pesquise por **CometAPI** para adicionar o nó. Tela de workflow do n8n com a busca do nó CometAPI aberta Nó CometAPI adicionado à tela do n8n 3. Adicione um nó **Manual Trigger** e conecte-o ao nó CometAPI. 4. No nó CometAPI, em **Credential to connect with**, escolha **Create new**. Cole sua chave de API da CometAPI em **CometAPI Key** e clique em **Save**. A Base URL vem por padrão como `https://api.cometapi.com` e normalmente não precisa ser alterada. Caixa de diálogo de credenciais da CometAPI com a chave de API inserida 5. Configure o nó: * **Model**: insira o model ID atual que você deseja usar * **Messages**: defina Role como `user`, Content como seu prompt de teste (por exemplo, `Hello`) * Opcional: adicione uma mensagem `system`, defina **Max Tokens**, **Temperature** etc. 6. Clique em **Execute step** para executar o nó. O painel **Output** mostra a resposta JSON. Painel de saída do n8n mostrando uma resposta JSON bem-sucedida da CometAPI * **`node-gyp` ou erros de build nativo** — instale as ferramentas de compilação: `sudo apt install build-essential python3` (Debian/Ubuntu) ou Xcode Command Line Tools (macOS). * **Erros de permissão do npm (EACCES)** — use nvm para uma instalação do Node.js em nível de usuário; não é necessário `sudo`. * **Conflito de porta (`localhost:5678` indisponível)** — defina `N8N_PORT=5679` (ou outra porta livre) antes de executar `n8n start`. * **Seção Community Nodes ausente** — faça login com a conta **Owner** e verifique **Settings → Security**. * **A instalação do npm falha em redes corporativas** — configure um proxy: `npm config set proxy http://user:pass@host:port` * **O nó CometAPI retorna 401/403** — verifique sua chave de API e se o model está acessível no seu plano CometAPI. * **Respostas vazias ou erros de limite de token** — aumente **Max Tokens**; ajuste **Temperature** e **Top P** conforme necessário. * **O n8n para quando o terminal é fechado** — use pm2: `pm2 start "n8n" --name n8n && pm2 save`.