Principais conclusões
- Um template de Docker Compose, não um app independente — ele conecta quatro ferramentas de código aberto já existentes em vez de trazer código novo próprio
- Reúne n8n (automação de workflows, mais de 400 integrações), Ollama (inferência de LLM local), Qdrant (banco de dados vetorial) e PostgreSQL (armazenamento de dados)
- Licenciado sob Apache-2.0, gratuito, sem conta ou API key necessárias
- Perfis separados de Docker Compose para inferência somente com CPU, GPU Nvidia e GPU AMD (Linux)
- Já vem com um workflow de exemplo pré-carregado no n8n, demonstrando um pipeline RAG local com os serviços Ollama e Qdrant incluídos
- O repositório no GitHub mostra cerca de 15.300 estrelas e cerca de 3.800 forks em setembro de 2026
- Selecionado e mantido pela n8n, a empresa de automação de workflows low-code por trás da própria plataforma n8n
📍 Em uma frase
O Self-hosted AI Starter Kit é um template de Docker Compose gratuito, licenciado sob Apache-2.0, da n8n, que reúne n8n, Ollama, Qdrant e PostgreSQL em um único comando para criar workflows de IA local sem nenhuma dependência da nuvem.
💬 Em termos simples
Em vez de instalar separadamente uma ferramenta de workflow, um executor de modelo local e um banco de dados vetorial e conectá-los você mesmo, esse kit entrega os quatro já configurados para conversar entre si — você roda um único comando docker-compose e tem um ambiente de automação de IA local funcionando, com um workflow RAG de exemplo já carregado.
📌Nota: Esta análise é o complemento aprofundado da entrada do Self-hosted AI Starter Kit no Local LLM Software Directory — veja essa página para uma comparação rápida com dezenas de outras ferramentas de IA local.
O que é o Self-Hosted AI Starter Kit?
O Self-hosted AI Starter Kit é um template de Docker Compose, não um software novo — a própria descrição no GitHub o chama de «an open, docker compose template» que ajuda a «inicializar rapidamente um ambiente de desenvolvimento local completo de IA e low-code». Ele combina quatro projetos de código aberto mantidos separadamente (n8n, Ollama, Qdrant e PostgreSQL) em uma configuração já conectada, entregando uma stack de IA local funcional sem instalar e conectar cada peça manualmente.
- Função principal: um
docker-compose.ymle arquivos de configuração de apoio que iniciam n8n, Ollama, Qdrant e PostgreSQL juntos, já conectados em rede para que possam se comunicar entre si - n8n: uma plataforma de automação de workflows low-code com mais de 400 integrações e nós de IA/LangChain dedicados para criar agentes e automações
- Ollama: executa modelos de linguagem abertos localmente, exposto aos workflows do n8n como um provedor de modelo
- Qdrant: um banco de dados vetorial de código aberto usado para armazenar e recuperar embeddings em workflows do tipo RAG
- PostgreSQL: o banco de dados relacional que sustenta o próprio armazenamento de workflows e credenciais do n8n
- Mantenedor: n8n, a empresa por trás da plataforma de automação de workflows n8n
- Repositório canônico: github.com/n8n-io/self-hosted-ai-starter-kit — a fonte dos passos de instalação e do histórico de versões usados nesta análise
Histórico do projeto e marcos de versão do Starter Kit
A n8n publicou o Self-hosted AI Starter Kit como um recurso complementar ao seu conjunto crescente de nós de IA e integração com LangChain, com o objetivo de dar aos desenvolvedores uma forma rápida e reproduzível de testar a automação de workflows de IA local sem montar a stack subjacente na mão.
- 1Lançamento inicial — pacote básico de quatro serviços
Why it matters: Trouxe o docker-compose.yml original conectando n8n, Ollama, Qdrant e PostgreSQL, com um workflow de exemplo RAG pré-carregado. - 2Adição dos perfis Compose de GPU
Why it matters: Introduziu perfis Compose separados `gpu-nvidia` e `gpu-amd` além do perfil padrão `cpu`, permitindo que o Ollama use a aceleração de GPU disponível em sistemas compatíveis em vez de rodar inferência somente em CPU para cada modelo. - 3Contínuo: acompanhando as próprias adições de nós de IA/LangChain do n8n
Why it matters: À medida que o produto principal do n8n ganhava mais nós específicos de IA e capacidades de construção de agentes, o workflow de exemplo pré-carregado e a documentação do starter kit foram atualizados para refletir o que a versão do n8n incluída consegue fazer.
O que dá para fazer com o Starter Kit?
O valor do starter kit está no que os serviços incluídos fazem juntos, não em funcionalidade nova própria. Veja o que cada parte realmente faz, segundo o README oficial no GitHub.
- Automação de workflows local — crie e execute automações no editor visual do n8n, usando qualquer uma das mais de 400 integrações junto com nós de IA/LangChain dedicados para construir agentes
- Inferência de LLM local — o Ollama executa modelos abertos (Llama, Qwen, Gemma e outros) localmente, disponíveis para os workflows do n8n como provedor de modelo sem necessidade de API key externa
- Armazenamento vetorial local para RAG — o Qdrant armazena e recupera embeddings para que os workflows do n8n possam construir pipelines de geração aumentada por recuperação totalmente em infraestrutura local
- Armazenamento persistente de workflows e credenciais — o PostgreSQL sustenta o próprio banco de dados do n8n, de modo que workflows, credenciais e histórico de execução persistem após reinícios dos containers
- Perfis de aceleração por GPU — perfis Compose separados (
cpu,gpu-nvidia,gpu-amd) permitem que o Ollama use o hardware de GPU disponível para inferência local mais rápida onde for suportado - Acesso compartilhado a arquivos — uma pasta montada
/data/shareddá aos workflows do n8n uma forma de ler e gravar arquivos locais, útil para workflows RAG baseados em documentos - Workflow de exemplo pré-carregado — o kit vem com um workflow do n8n funcional já importado, demonstrando um padrão RAG local usando os serviços Ollama e Qdrant incluídos como template inicial
Exemplos de uso: três formas de usar o Starter Kit
Estes são workflows concretos construídos a partir dos recursos documentados e incluídos do starter kit acima — não casos de uso hipotéticos.
Instalar o Self-Hosted AI Starter Kit
O starter kit é instalado via git clone e Docker Compose — não existe um app baixável separadamente. Os passos abaixo vêm do README oficial no GitHub — sempre confira diretamente nessa página, já que os comandos exatos podem mudar entre atualizações.
Passo | Comando / Link |
|---|---|
| 1. Clonar o repositório | git clone https://github.com/n8n-io/self-hosted-ai-starter-kit.git |
| 2. Entrar no diretório | cd self-hosted-ai-starter-kit |
| 3. Copiar o arquivo de ambiente | cp .env.example .env |
| 4a. Iniciar (somente CPU) | docker compose --profile cpu up |
| 4b. Iniciar (GPU Nvidia) | docker compose --profile gpu-nvidia up |
| 4c. Iniciar (GPU AMD, Linux) | docker compose --profile gpu-amd up |
| Código-fonte | github.com/n8n-io/self-hosted-ai-starter-kit |
O n8n fica disponível em http://localhost:5678 assim que a stack sobe. As necessidades de hardware variam conforme os modelos rodados no Ollama — um modelo pequeno funciona em uma máquina modesta somente com CPU, enquanto modelos maiores se beneficiam dos perfis de GPU Nvidia ou AMD; confira o tamanho de um modelo na biblioteca do Ollama antes de baixá-lo. Requer Docker e Docker Compose instalados no macOS, Windows (via WSL2) ou Linux — o starter kit em si não tem nenhum build específico de sistema operacional.
Preços e licenciamento
O starter kit em si é gratuito e de código aberto, licenciado sob Apache-2.0. Como ele reúne outros projetos de código aberto, vale conhecer também a licença e o modelo de custo próprios de cada componente incluído.
Self-hosted AI Starter Kit (este template)
- Licença:
- Apache-2.0, conforme o arquivo LICENSE do repositório
- Custo:
- Gratuito
n8n (incluído)
- Licença:
- Sustainable Use License (código disponível, não aprovada pela OSI) para uso self-hosted; veja a análise do n8n para todos os detalhes de licenciamento
- Custo:
- Gratuito para uso self-hosted conforme os termos de licença do n8n
Ollama (incluído)
- Licença:
- MIT
- Custo:
- Gratuito
Qdrant (incluído)
- Licença:
- Apache-2.0
- Custo:
- Gratuito
PostgreSQL (incluído)
- Licença:
- PostgreSQL License (permissiva)
- Custo:
- Gratuito
Rodar toda a stack não custa nada em licenciamento de software — apenas a sua própria infraestrutura (computação, armazenamento e, opcionalmente, uma GPU) representa um custo real. Se você estender o workflow do n8n pré-carregado para chamar uma API de LLM paga na nuvem ou uma integração paga de terceiros, o preço próprio desse provedor se aplica; o starter kit em si não adiciona nenhuma margem ou assinatura.
Self-Hosted AI Starter Kit vs. n8n puro
O starter kit não substitui o n8n — ele é o n8n mais uma stack de IA local já conectada ao redor. A forma mais clara de entender a diferença é comparar o que você já tem pronto com o que precisaria configurar sozinho.
O que você instala
- Self-Hosted AI Starter Kit:
- n8n + Ollama + Qdrant + PostgreSQL, já conectados em um único docker-compose.yml
- n8n puro (self-hosted):
- Somente n8n — veja a análise do n8n para seus próprios passos de instalação
Inferência de LLM local
- Self-Hosted AI Starter Kit:
- Incluída por padrão via Ollama
- n8n puro (self-hosted):
- Não incluída; você conecta seu próprio provedor de modelo (local ou na nuvem) manualmente
Banco de dados vetorial para RAG
- Self-Hosted AI Starter Kit:
- Incluído por padrão via Qdrant
- n8n puro (self-hosted):
- Não incluído; você adicionaria e conectaria um banco vetorial sozinho
Workflow de exemplo
- Self-Hosted AI Starter Kit:
- Workflow RAG local de exemplo já carregado na primeira execução
- n8n puro (self-hosted):
- Começa com uma tela em branco; templates estão disponíveis separadamente na biblioteca de templates do n8n
Ideal para
- Self-Hosted AI Starter Kit:
- Ter um ambiente de workflow de IA totalmente local rodando em minutos, sem conectar serviços manualmente
- n8n puro (self-hosted):
- Times que já rodam sua própria infraestrutura de modelo ou vetorial e só precisam da camada de automação
Se você já tem o Ollama ou um banco de dados vetorial rodando em outro ponto da sua infraestrutura, instalar o n8n puro e conectá-lo aos seus serviços existentes pode ser mais simples do que adotar as versões incluídas do starter kit. Se você está começando do zero, o starter kit elimina o trabalho de integração.
Quem deveria usar o Starter Kit?
Se o starter kit é indicado ou não depende de você querer um ambiente de workflow de IA local pronto para uso ou preferir montar os mesmos componentes sozinho.
Starter Kit vs. outras ferramentas de workflow de IA local
O Self-hosted AI Starter Kit está no espaço de automação de workflows e frameworks RAG, ao lado de várias outras opções que podem ser self-hosted. Veja como ele se compara a ferramentas próximas — consulte o Local LLM Software Directory para o catálogo completo, e a comparação dedicada Starter Kit vs. n8n puro acima para o confronto mais direto.
- n8n — a plataforma de automação de workflows sobre a qual este kit é construído; veja a seção de comparação dedicada acima e a análise completa do n8n para seus próprios detalhes de instalação e licenciamento.
- LangChain-Chatchat — uma aplicação de RAG e base de conhecimento self-hosted com interface própria integrada, em vez de uma tela de automação de workflows de propósito geral; veja a análise do LangChain-Chatchat se um app dedicado de chat com documentos servir melhor do que um construtor de workflows.
- RAGFlow — um motor RAG de compreensão profunda de documentos, focado em analisar documentos complexos (tabelas, layouts) de forma mais completa do que uma ferramenta de workflow genérica; veja a análise do RAGFlow.
- Haystack — um framework RAG voltado a Python para desenvolvedores que preferem escrever o código do pipeline diretamente em vez de usar um construtor visual de workflows; veja a análise do Haystack.
Erros comuns ao avaliar o Starter Kit
A maior parte da confusão sobre o Self-hosted AI Starter Kit vem de tratá-lo como uma aplicação independente, entender errado o que ele realmente reúne, ou escolher o perfil Compose errado.
Perguntas frequentes
O que é o Self-hosted AI Starter Kit?
É um template de Docker Compose de código aberto, criado pela n8n, que reúne n8n, Ollama, Qdrant e PostgreSQL em um único comando para criar workflows de IA local e pipelines RAG sem nenhuma dependência da nuvem.
O Self-hosted AI Starter Kit é gratuito?
Sim. O template em si é licenciado sob Apache-2.0 e não custa nada para rodar. Seus componentes incluídos (n8n, Ollama, Qdrant, PostgreSQL) são cada um gratuitos para uso self-hosted conforme suas respectivas licenças — veja a tabela de preços acima.
O que o Self-hosted AI Starter Kit realmente reúne?
Quatro projetos de código aberto mantidos separadamente: n8n (automação de workflows, mais de 400 integrações), Ollama (inferência de LLM local), Qdrant (banco de dados vetorial) e PostgreSQL (banco de dados relacional que sustenta os próprios dados do n8n). É uma configuração docker-compose, não um software novo.
O Self-hosted AI Starter Kit exige uma conta na nuvem ou uma API key?
Não. Cada serviço incluído roda localmente por padrão, e o workflow RAG de exemplo pré-carregado usa apenas os serviços Ollama e Qdrant incluídos. Você pode opcionalmente adicionar chaves de API de provedores na nuvem depois, dentro de um workflow do n8n, se quiser.
Como eu instalo o Self-hosted AI Starter Kit?
Clone o repositório (git clone https://github.com/n8n-io/self-hosted-ai-starter-kit.git), copie o arquivo de ambiente (cp .env.example .env) e depois rode docker compose --profile cpu up (ou gpu-nvidia/gpu-amd para aceleração por GPU). Veja a tabela de instalação acima para a sequência completa.
Ele suporta aceleração por GPU?
Sim, por meio de perfis separados de Docker Compose: gpu-nvidia para GPUs Nvidia e gpu-amd para GPUs AMD no Linux, além do perfil padrão cpu para inferência somente com CPU.
É a mesma coisa que o n8n?
Não. O n8n é um dos quatro componentes incluídos. O starter kit é um ambiente pré-configurado que instala o n8n junto com Ollama, Qdrant e PostgreSQL — veja a comparação Self-Hosted AI Starter Kit vs. n8n puro acima para as diferenças exatas.
Qual licença o próprio n8n usa dentro deste kit?
O n8n tem código disponível sob sua própria Sustainable Use License, não aprovada pela OSI, para uso self-hosted — distinta da licença Apache-2.0 que cobre este template de starter kit em si. Veja a análise do n8n para o detalhe completo de licenciamento.
Quantas estrelas o Self-hosted AI Starter Kit tem no GitHub?
O repositório no GitHub mostra cerca de 15.300 estrelas e cerca de 3.800 forks em setembro de 2026 — confira o repositório ao vivo para o número atual, já que ele muda continuamente.
Quem mantém o Self-hosted AI Starter Kit?
Ele é selecionado e mantido pela n8n, a empresa por trás da plataforma de automação de workflows n8n, como um recurso complementar que mostra workflows de IA local construídos com os nós de IA e LangChain do n8n.