Mantenha a decisão sobre o produto separada da decisão operacional. Um modelo pode iniciar o software. Não identifica as pessoas que aprovam alterações ou restauram o serviço.
O que é o kit inicial de IA autoalojado do n8n?
O kit oficial é um modelo aberto do Docker Compose para um ambiente local de desenvolvimento de IA e low-code. O n8n mantém o projeto e combina a sua plataforma de fluxos de trabalho autoalojada com componentes compatíveis para fluxos de trabalho locais de IA (GitHub).
O inventário documentado é:
- n8n, a plataforma de fluxos de trabalho autoalojada (GitHub)
- Ollama, o serviço local de modelos de linguagem (GitHub)
- Qdrant, o armazenamento vetorial (GitHub)
- PostgreSQL, a base de dados (GitHub)
O repositório inclui um ficheiro do Docker Compose e definições pré-configuradas de rede e armazenamento (GitHub). O respetivo README também documenta um ficheiro de ambiente, perfis de máquina, um fluxo de trabalho incluído, acesso a ficheiros locais e comandos de atualização específicos de cada perfil (GitHub).
Os exemplos oficiais incluem um agente de marcação de compromissos, resumos de PDFs empresariais, bots do Slack para comunicações da empresa e operações de TI, e análise de documentos financeiros (GitHub, documentação do n8n). Estes são exemplos de caminhos para programadores. Não são serviços acabados para clientes, e o AI Jungle OS não afirma que os fornece.
Não misture este inventário com outros repositórios. Por exemplo, local-ai-packaged é um projeto separado que acrescenta componentes como Supabase, Open WebUI, Flowise, Neo4j, Langfuse, SearXNG e Caddy (local-ai-packaged). Esses componentes não fazem parte do kit oficial do n8n descrito aqui.
Qual é a diferença entre uma experiência local e um serviço privado de IA com manutenção?
Uma experiência local comprova que um fluxo de trabalho pode ser executado. Um serviço privado com manutenção também tem responsáveis identificados pelas decisões de acesso, alteração, falha e recuperação. A primeira metade desta distinção vem do âmbito documentado do kit. A segunda metade corresponde aos nossos critérios para compradores.
| Área de decisão | O que o kit oficial documenta | O que este guia lhe pede para decidir |
|---|---|---|
| Finalidade | Um ambiente local de desenvolvimento de IA e low-code para começar e criar provas de conceito (GitHub, documentação do n8n) | Que fluxos de trabalho podem continuar a ser experiências e quais podem tornar-se um serviço |
| Componentes | n8n, Ollama, Qdrant e PostgreSQL num modelo do Docker Compose (GitHub) | Que componentes exatos pertencem ao seu serviço e são por ele suportados |
| Limite de produção | O kit não está totalmente otimizado para produção e deve ser protegido e reforçado antes da utilização em produção (documentação do n8n) | Quem decide que a sua configuração está pronta e regista essa decisão |
| Acesso | A configuração indica que deve copiar o ficheiro de ambiente de exemplo e alterar os respetivos segredos e palavras-passe (GitHub) | Quem detém o acesso de administrador e as credenciais das aplicações |
| Atualizações | O README fornece comandos de atualização específicos de cada perfil (GitHub) | Quem analisa, aprova, aplica e reverte uma alteração |
| Recuperação | O guia de início rápido abrange o arranque e a inspeção dos registos da primeira execução (GitHub) | O que é restaurado, por quem e como o resultado é verificado |
Esta tabela não define uma norma universal de produção. Evita um erro comum de categoria: interpretar uma lista de componentes como se fosse um modelo operacional.
A camada em falta é a responsabilização, não outro contentor. Se ninguém for responsável por uma atualização ou por um fluxo de trabalho que falhou, o limite do serviço continua por definir.
Como deve escolher entre um kit inicial e uma configuração operada?
Escolha com base em respostas escritas, não no tamanho da lista de componentes. Use as seguintes verificações como registo editorial da decisão. Estas verificações não ampliam a declaração de suporte do n8n.
Responsabilidade
Identifique a pessoa responsável pelo anfitrião e a pessoa responsável por cada fluxo de trabalho. Indique quem pode interromper um fluxo de trabalho. Se a mesma pessoa for responsável por ambos, registe-o. O objetivo não é criar um processo extenso. O objetivo é obter uma resposta que continue clara quando algo falhar.
Acesso
Enumere as contas de administrador e as credenciais das aplicações necessárias para a configuração. Registe quem pode conceder acesso e quem pode removê-lo. O guia de início rápido oficial instrui os utilizadores a criar .env a partir de .env.example e a atualizar os segredos e as palavras-passe (GitHub). Os nossos critérios acrescentam a questão da responsabilidade humana.
Atualizações
Decida quem analisa uma alteração a um fluxo de trabalho, modelo ou componente. Registe quem a aprova e quem pode revertê-la. O repositório publica diferentes comandos de atualização para os perfis documentados (GitHub). Essas instruções ao nível dos comandos não definem a sua regra de aprovação.
Recuperação
Registe o que deve voltar a funcionar após uma falha. Identifique a pessoa que faz a restauração e a pessoa que verifica o resultado. Registe também o que deve ser exportável se o serviço mudar de responsável ou for interrompido. Estas são as questões operacionais deste guia. Não são funcionalidades de recuperação atribuídas ao kit inicial.
Use um kit inicial quando a tarefa imediata for criar e inspecionar um fluxo de trabalho local. Considere uma configuração operada quando o fluxo de trabalho tiver outros utilizadores além do programador e a sua empresa precisar de respostas duradouras às verificações acima. A designação importa menos do que a responsabilidade registada.
Como executar o exemplo do kit inicial de IA autoalojado?
Siga o percurso do repositório para a clonagem, o perfil, o navegador e o fluxo de trabalho incluído. A página oficial de implementação direciona os utilizadores para o repositório do kit no GitHub (documentação do n8n).
- Clone o repositório oficial e aceda ao respetivo diretório (GitHub).
- Copie
.env.examplepara.enve substitua os segredos e as palavras-passe (GitHub). - Inicie o perfil do Docker Compose documentado para a sua máquina:
gpu-nvidia,gpu-amdno Linux oucpu. O README apresenta um percurso separado para Mac (GitHub). - Abra
http://localhost:5678/, conclua a configuração do n8n, abra o fluxo de trabalho incluído e selecione Chat (GitHub). - Na primeira execução do fluxo de trabalho, inspecione os registos da consola do Docker se o Ollama ainda estiver a transferir o Llama3.2 (GitHub).
O README apresenta AI Agent, Text Classifier e Information Extractor entre os nós de IA disponíveis no n8n. Remete para o nó do Ollama para um modelo de linguagem local e para o Qdrant como armazenamento vetorial (GitHub). Este percurso coloca o exemplo em funcionamento. Não altera o aviso de produção publicado (documentação do n8n).
É possível executar o kit inicial no Ubuntu ou no Windows?
O repositório oficial documenta perfis do Docker Compose orientados para o hardware, não edições separadas para Ubuntu e Windows. Documenta um perfil de GPU AMD no Linux, um perfil de GPU Nvidia, um perfil de CPU e um percurso separado para Mac (GitHub).
No Ubuntu, use o perfil documentado que corresponda ao hardware disponível. O repositório associa explicitamente o perfil de GPU AMD ao Linux (GitHub). Não publica uma garantia de produção específica para Ubuntu no material fornecido.
Para Windows, o README fornecido não faz uma promessa de compatibilidade específica. O percurso geral documentado é o perfil de CPU, enquanto o texto sobre GPU menciona Nvidia e AMD no Linux (GitHub). Compare o README atual com a configuração exata de Windows, Docker e hardware que pretende utilizar.
Em qualquer dos casos, a escolha do sistema operativo não elimina a declaração do n8n de que o kit não está totalmente otimizado para produção e deve ser protegido e reforçado antes da utilização em produção (documentação do n8n).
De que hardware precisa um kit inicial de IA autoalojado?
O kit oficial fornece perfis de execução em vez de uma especificação universal de hardware. Documenta percursos para GPU Nvidia, GPU AMD no Linux, CPU e Mac com Apple Silicon (GitHub).
- Use
gpu-nvidiapara o percurso documentado da Nvidia. O README direciona os utilizadores que usam pela primeira vez uma GPU com Docker para as instruções do Ollama (GitHub). - Use
gpu-amdpara o percurso documentado da AMD no Linux (GitHub). - Use
cpupara o percurso documentado pelo repositório para outras máquinas (GitHub). - No Apple Silicon, o README afirma que a GPU não pode ser exposta à instância do Docker. Disponibiliza a operação apenas com CPU ou o Ollama nativo no anfitrião ligado ao n8n (GitHub).
As fontes oficiais fornecidas não indicam um requisito universal de RAM, armazenamento, simultaneidade, latência ou tamanho de modelo. Por isso, este guia não inventa nenhum. Comece por escolher o perfil documentado e depois avalie o modelo candidato para o fluxo de trabalho identificado.
Qual é o melhor modelo para o kit inicial?
O kit oficial não classifica um modelo como o melhor para todos os fluxos de trabalho. O fluxo de trabalho incluído refere que o Ollama transfere o Llama3.2 na primeira execução, e o README remete para o nó do Ollama quando pretende manter o modelo de linguagem local (GitHub).
Use estas perguntas editoriais ao selecionar um modelo:
- O modelo candidato funciona no perfil de hardware documentado que escolheu?
- O modelo deve permanecer local dentro do limite de dados que escolheu?
- Quem avalia o modelo para o fluxo de trabalho identificado?
- Quem aprova e reverte uma alteração ao modelo?
O Llama3.2 é o modelo indicado na nota sobre a primeira execução do fluxo de trabalho incluído. Esse facto não é uma recomendação universal (GitHub). As perguntas finais acima atribuem responsabilidades. Não fazem qualquer afirmação de desempenho.
A escolha de um modelo fica incompleta até que alguém assuma a avaliação e a decisão de alteração. Uma predefinição num fluxo de trabalho de exemplo continua a ser apenas uma predefinição.
O kit inicial de IA autoalojado é suficiente para uma empresa boutique?
É suficiente para iniciar uma prova de conceito, mas as fontes oficiais fornecidas não estabelecem que o kit predefinido seja suficiente para produção. O n8n afirma que o kit não está totalmente otimizado para produção e deve ser protegido e reforçado antes da utilização em produção (documentação do n8n).
Antes da utilização perante clientes, registe:
- o responsável pelo acesso de administrador e pelas credenciais das aplicações
- quem aprova alterações aos fluxos de trabalho, modelos e componentes
- a pessoa que analisa falhas e pode interromper um fluxo de trabalho
- o resultado de recuperação que deve ser restaurado e verificado
- o material que deve poder ser exportado durante uma transferência ou saída
- a pessoa que autoriza a passagem da prova de conceito para a produção
Esta lista contém os critérios editoriais do AI Jungle OS. Não promete que uma configuração específica esteja pronta para produção. Também não implica que o AI Jungle OS contenha o n8n ou o kit inicial público.
Se as suas respostas já identificarem operadores responsáveis, o kit público pode ser uma base útil para um laboratório. Se as respostas estiverem em branco, adicionar mais componentes não irá preenchê-las. Veja o cockpit do AI Jungle OS para conhecer o limite operacional usado por esta publicação.
Perguntas frequentes
O AI Jungle OS fornece o kit inicial do n8n?
Não. Este artigo utiliza o kit público do n8n como ponto de comparação. Não afirma que o AI Jungle OS fornece o n8n ou o kit inicial público.
A transferência do SourceForge é um kit inicial diferente?
O SourceForge descreve a sua página como um espelho exato do projeto do GitHub e afirma que não está afiliado ao projeto (SourceForge). Use o repositório oficial do GitHub como referência para o fluxo de trabalho e os ficheiros abordados neste guia (GitHub).
O autoalojamento define quem pode aprovar alterações?
Não. O local de implementação não atribui um responsável humano. Este guia trata a aprovação e a responsabilidade pela recuperação como decisões do comprador, não como capacidades documentadas do kit do n8n.
Escrito por Tileo, que opera um portefólio de negócios na internet neste mesmo cockpit.
