explaingit

n8n-io/self-hosted-ai-starter-kit

Analysis updated 2026-06-24

14,809Audience · developerComplexity · 2/5Setup · moderate

TLDR

Docker Compose starter template from n8n that bundles n8n, Ollama, Qdrant, and Postgres so you can build local AI workflows on your own hardware.

Mindmap

mindmap
  root((self-hosted-ai-starter-kit))
    Inputs
      Docker Compose
      Env file
      Ollama models
      n8n workflows
    Outputs
      Local n8n UI
      Chat agent
      Vector store
      Postgres data
    Use Cases
      Build local agents
      Summarize PDFs
      Run Slack bots
      Test RAG flows
    Tech Stack
      Docker
      n8n
      Ollama
      Qdrant
      Postgres
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Spin up a local AI workflow stack with n8n, Ollama, Qdrant, and Postgres in one command

USE CASE 2

Build a private chatbot that answers questions over your own PDFs using local models

USE CASE 3

Prototype a scheduling or Slack agent without sending data to a cloud LLM

USE CASE 4

Test a RAG pipeline locally before moving it to a production deployment

What is it built with?

Dockern8nOllamaQdrantPostgreSQL

How does it compare?

n8n-io/self-hosted-ai-starter-kitacdlite/recomposenvidia/deeplearningexamples
Stars14,80914,80914,806
LanguageJavaScriptJupyter Notebook
Last pushed2024-08-12
MaintenanceStale
Setup difficultymoderateeasyhard
Complexity2/52/55/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Docker pulls and a first-run Llama 3.2 download eat several gigabytes, and Apple Silicon needs a custom Ollama-on-host setup since Docker cannot use the GPU.

In plain English

The Self-hosted AI Starter Kit is an open-source template put together by the n8n team. The goal is to give you a ready-made local setup for building AI workflows on your own machine instead of relying on a hosted cloud service. Everything is wired together with Docker Compose, so once you have Docker installed you run a single command and the whole stack comes up. The kit bundles four pieces. The first is n8n itself, a low-code automation platform with over 400 integrations and nodes for AI work such as agents, text classifiers, and information extractors. The second is Ollama, a tool for downloading and running local large language models. The third is Qdrant, an open-source vector database for storing the numeric embeddings that AI applications use to look things up by meaning. The fourth is PostgreSQL, used as a general-purpose database. The README lists possible projects you might build with this combination: scheduling agents, secure summarisation of company PDFs, smarter Slack bots, and private analysis of financial documents. Installation comes in a few flavours. You clone the repository, copy the example environment file, and then choose a docker compose profile that matches your hardware. There are separate profiles for NVIDIA GPUs, AMD GPUs on Linux, and plain CPU. On Apple Silicon Macs the GPU cannot be passed into Docker, so the README offers two routes: run everything on CPU, or install Ollama on the Mac directly and have the Docker stack talk to it through host.docker.internal. Once the stack is running you open n8n at localhost port 5678 to do a one-time setup, then load the example workflow and click the Chat button to try it. The first run downloads the Llama 3.2 model through Ollama, which may take a while. After that, the README suggests keeping things local by always picking the Ollama node for language models and Qdrant for vector storage. The README closes with upgrade commands for each hardware profile, a list of recommended reading on AI agents and vector databases, a video walkthrough, and links to the n8n template gallery so you can import other workflows. It notes that the kit is aimed at proof-of-concept work and is not tuned for production deployments.

Copy-paste prompts

Prompt 1
Clone the n8n self-hosted AI starter kit and start it with the NVIDIA GPU compose profile
Prompt 2
Adjust the kit so n8n in Docker talks to an Ollama running natively on my Apple Silicon Mac
Prompt 3
Build an n8n workflow that ingests PDFs into Qdrant and answers questions with Llama 3.2
Prompt 4
Swap Llama 3.2 for a different Ollama model in the starter kit and test the chat node
Prompt 5
Harden the starter kit Docker Compose file for a small production deployment with TLS

Frequently asked questions

What is self-hosted-ai-starter-kit?

Docker Compose starter template from n8n that bundles n8n, Ollama, Qdrant, and Postgres so you can build local AI workflows on your own hardware.

How hard is self-hosted-ai-starter-kit to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is self-hosted-ai-starter-kit for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.