能力标签

🔌 MCP 🤖 Agent 🔄 工作流 👁 OCR 🌐 翻译 🐳 Docker 💻 CLI 🔗 REST API 🧬 Embedding 📚 RAG

🔄

n8n工作流

自托管AI

基于 Shell · 可视化低代码工作流，300+ 服务连接器

英文名：selfhost-ai

⭐ 896 Stars 🍴 228 Forks 💻 Shell 📄 Apache-2.0 🏷 AI 8.2分

8.2AI 综合评分

n8naiautomationchatgpt-alternative

⬇ 下载源码 ZIP ⚙️ 配置说明 📺 TG 频道

✦ AI Skill Hub 推荐

自托管AI 是 AI Skill Hub 本期精选n8n工作流之一。综合评分 8.2 分，整体质量较高。我们强烈推荐将其纳入你的 AI 工具库，帮助提升工作效率。

📚 深度解析

自托管AI 是基于 n8n 平台的可视化工作流模板。n8n 是目前最受开发者欢迎的开源工作流自动化工具之一，支持自托管部署，同时提供云端版本，通过拖拽式界面连接数百种应用和服务，无需编写代码即可构建复杂的自动化流程。

自托管AI 工作流模板封装了特定场景下的最佳实践配置。导入后你无需从零开始搭建——只需根据向导配置必要的 API Key 和账号信息，激活工作流后即可立即运行。这类预制模板特别适合希望快速验证自动化方案可行性的用户，避免在节点连接和逻辑配置上花费大量时间。

n8n 的核心优势在于数据主权：自托管版本的所有数据（包括 Credentials 和执行记录）完全存储在你自己的服务器上，适合对数据隐私有要求的企业和个人用户。AI Skill Hub 推荐通过 Docker 部署 n8n 自托管实例，并将自托管AI 作为工作流库的起始模板。

📋 工具概览

自托管AI 是一款基于 Shell 开发的开源工具，专注于 n8n、ai、automation 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。

GitHub Stars

⭐ 896

开发语言

Shell

支持平台

macOS / Linux

维护状态

正常维护，社区驱动

开源协议

Apache-2.0

AI 综合评分

8.2 分

工具类型

n8n工作流

Forks

228

📖 中文文档

以下内容由 AI Skill Hub 根据项目信息自动整理，如需查看完整原始文档请访问底部「原始来源」。

📌 核心特色

基于 n8n 平台的可视化低代码工作流
支持拖拽式节点编排，将自动化门槛降至最低
内置 300+ 第三方服务连接器，覆盖主流工具生态
支持 Webhook、定时触发、事件驱动等多种启动方式
可导出 JSON 文件，方便团队共享和版本管理

🎯 主要使用场景

定时采集外部数据并自动生成分析报告推送
实现多系统间的数据同步和状态更新通知
构建自动化运维告警和响应处置流程

以下安装命令基于项目开发语言和类型自动生成，实际以官方 README 为准。

安装命令

# 克隆仓库
git clone https://github.com/kossakovsky/selfhost-ai
cd selfhost-ai

# 查看安装说明
cat README.md

# 按 README 完成环境依赖安装后即可使用

📋 安装步骤说明

访问 GitHub 仓库，下载工作流 JSON 文件
登录 n8n 工作台
点击右上角「导入工作流」按钮
上传或粘贴 JSON 内容
根据提示配置必要的 API Key、账号等参数
激活工作流后即可正常运行

以下用法示例由 AI Skill Hub 整理，涵盖最常见的使用场景。

常用命令 / 代码示例

# 查看帮助
selfhost-ai --help

# 基本运行
selfhost-ai [options] <input>

# 详细使用说明请查阅文档
# https://github.com/kossakovsky/selfhost-ai

以下配置示例基于典型使用场景生成，具体参数请参照官方文档调整。

配置示例

// n8n 工作流配置步骤
// 1. 在 n8n 中点击 "Import Workflow"
// 2. 粘贴 JSON 文件内容或上传文件
// 3. 配置必要的 Credentials：
//    - Settings → Credentials → New
//    - 选择对应服务类型填写 API Key
// 4. 激活工作流 (Toggle ON)
// 5. 通过 Webhook 或定时触发器运行

📑 README 深度解析真实文档完整度 78/100 查看 GitHub 原文 →

以下内容由系统直接从 GitHub README 解析整理，保留代码块、表格与列表结构。

Selfhost AI — Self-Hosted AI Automation Platform

Deploy 30+ AI and automation tools with a single command. This open-source Docker Compose template creates a complete self-hosted environment with n8n (workflow automation), Flowise (AI agents), Ollama (local LLMs), vector databases (Qdrant, Weaviate), RAG engines, Supabase, monitoring stack, and more — all pre-configured behind Caddy reverse proxy with automatic HTTPS. Plus, optionally import 300+ community workflows during setup!

Key Features

Private AI Homelab — Run LLMs locally with Ollama, keep your data on your own servers
ChatGPT Alternative — Open WebUI provides a familiar chat interface for local AI models
Workflow Automation — n8n with 400+ integrations, scalable queue-based architecture
AI Agents & RAG — Flowise, Dify, LangChain, vector databases (Qdrant, Weaviate)
One Command Install — Interactive wizard, automatic secrets, zero manual configuration
Auto HTTPS — Caddy reverse proxy with automatic Let's Encrypt certificates
Built-in Monitoring — Grafana + Prometheus stack included
Production Ready — Scalable workers, health checks, proper service dependencies
Free & Open Source — No vendor lock-in, Apache 2.0 license

---

What's Included

✅ Caddy, Postgres, and Redis - Core services for web proxy, database, and caching, which are always included.

The installer also makes the following powerful open-source tools available for you to select and deploy via an interactive wizard during setup:

✅ Appsmith - An open-source low-code platform for building internal tools, dashboards, and admin panels with a drag-and-drop UI builder.

✅ n8n - A low-code platform with over 400 integrations and advanced AI components to automate workflows.

✅ ComfyUI - A powerful, node-based UI for Stable Diffusion workflows. Build and run image-generation pipelines visually, with support for custom nodes and extensions.

✅ Crawl4ai - A flexible web crawler designed for AI, enabling you to extract data from websites for your projects.

✅ Docling - Universal document converter that transforms PDF, DOCX, PPTX, XLSX, HTML, and images into clean Markdown or JSON. Features advanced PDF parsing, OCR support, and a REST API with optional web UI. Perfect for document processing in n8n workflows.

✅ Dify - An open-source AI application development platform that provides comprehensive LLMOps capabilities, including workflow management, prompt engineering, RAG pipelines, and AI agent orchestration. Perfect for building production-ready AI applications.

✅ Flowise - A no-code/low-code AI agent builder that complements n8n perfectly, allowing you to create sophisticated AI applications with ease.

✅ Gost - Versatile HTTP/HTTPS proxy for routing AI service outbound traffic through a central proxy point

✅ Gotenberg - A stateless API for converting HTML, Markdown, Word, Excel, and other documents to PDF, PNG, or JPEG. Available only within the Docker network for internal use by n8n workflows and other services.

✅ Grafana - An open-source platform for visualizing monitoring data, helping you understand system performance at a glance.

✅ Hermes Agent - An open-source autonomous AI agent by Nous Research with skills, persistent memory, MCP support, and multi-agent workflows. Includes a web dashboard and an OpenAI-compatible API that n8n workflows can call directly.

✅ InvokeAI - A professional creative engine for Stable Diffusion with a polished web UI, node-based workflow editor, inpainting/outpainting, and a REST API. Choose NVIDIA, AMD, or CPU hardware during install; models and outputs are stored in ./invokeai on the host.

✅ Langfuse - An open-source platform to help you observe and understand how your AI agents are performing, making it easier to debug and improve them.

✅ Letta - An open-source agent server and SDK that can be connected to various LLM API backends (OpenAI, Anthropic, Ollama, etc.), enabling you to build and manage AI agents.

✅ LightRAG - A simple and fast graph-based Retrieval-Augmented Generation system with automatic knowledge graph extraction, dual-level retrieval mechanisms, and incremental updates. Supports multiple storage backends (PostgreSQL, Neo4j, JSON) and embedding models.

✅ LibreTranslate - Self-hosted translation API (50+ languages).

✅ Neo4j - A graph database management system that allows you to model, store, and query data as a network of nodes and relationships.

✅ NocoDB - An open source Airtable alternative that turns any database into a smart spreadsheet with a no-code interface for building collaborative apps.

✅ Ollama - Run Llama 3, Mistral, Gemma, and other large language models locally. Optionally expose its API externally through Caddy under OLLAMA_HOSTNAME, protected by a generated Bearer token.

✅ Open WebUI - A user-friendly, ChatGPT-like interface to interact privately with your AI models and n8n agents.

✅ PaddleOCR - A CPU-ready OCR API powered by PaddleX Basic Serving.

✅ Portainer - A lightweight, secure web UI to manage your Docker environment (containers, images, volumes, networks) with ease.

✅ Databasus - Database backups & monitoring with a self-hosted UI.

✅ Postiz - An open-source social media scheduling and publishing platform.

✅ Prometheus - An open-source monitoring and alerting toolkit to keep an eye on system health.

✅ Qdrant - A high-performance open-source vector store, specialized for AI. While Supabase also offers vector capabilities, Qdrant is included for its speed, making it ideal for demanding AI tasks.

✅ RAGApp - Open-source application to build Retrieval-Augmented Generation (RAG) assistants over your data. Provides a web UI for chat and an HTTP API for integration with your workflows.

✅ RAGFlow - An open-source RAG engine based on deep document understanding with Elasticsearch backend, providing truthful question-answering capabilities with well-founded citations from complex formatted data.

✅ SearXNG - A free, open-source internet metasearch engine. It aggregates results from numerous search services without tracking or profiling you, ensuring your privacy.

✅ Supabase - An open-source alternative to Firebase, providing database storage, user authentication, and more. It's a popular choice for AI applications.

✅ Uptime Kuma - Self-hosted uptime monitoring tool with notifications

✅ WAHA - WhatsApp HTTP API (REST API) that you can configure in a click! 3 engines: WEBJS (browser based), NOWEB (websocket nodejs), GOWS (websocket go).

✅ Weaviate - An open-source AI-native vector database with a focus on scalability and ease of use. It can be used for RAG, hybrid search, and more.

Prerequisites before Installation

1. Domain Name: You need a registered domain name (e.g., yourdomain.com). 2. DNS Configuration: Before running the installation script, you must configure DNS A-record for your domain, pointing to the public IP address of the server where you'll install this system. Replace yourdomain.com with your actual domain: - Wildcard Record: A *.yourdomain.com -> YOUR_SERVER_IP 3. VPS (Virtual Private Server): A dedicated VPS with a public IP address is required. Home servers, shared hosting, or localhost setups are not supported. - Operating System: Ubuntu 24.04 LTS, 64-bit - For a minimal setup with n8n, Monitoring, Databasus and Portainer: 4 GB Memory / 2 CPU Cores / 40 GB Disk Space - For running all available services: at least 20 GB Memory / 4 CPU Cores / 60 GB Disk Space

Why This Setup?

This installer helps you create your own powerful, private AI workshop. Imagine having a suite of tools at your fingertips to:

Automate repetitive tasks.
Build smart assistants tailored to your needs.
Analyze information and gain insights.
Generate creative content.

This setup provides a comprehensive suite of cutting-edge services, all pre-configured to work together. Key advantages include:

Rich Toolset: Get a curated collection of powerful open-source tools for AI development, automation, and monitoring, all in one place.
Scalable n8n Performance: n8n runs in queue mode by default, leveraging Redis for task management and Postgres for data storage. You can dynamically specify the number of n8n workers and task runners during installation, allowing for robust parallel processing of your workflows to handle demanding loads.
Full Control: All of this is hosted by you, giving you full control over your data, operations, and how resources are allocated.

Installation

Running the Install

The recommended way to install is using the provided main installation script.

Connect to your server via SSH.
Run the following command:

    git clone https://github.com/kossakovsky/selfhost-ai && cd selfhost-ai && sudo bash ./scripts/install.sh

This single command automates the entire setup process, including:

Preparing your system (updates, firewall configuration, and basic security enhancements like brute-force protection).
Installing Docker and Docker Compose (tools for running applications in isolated environments).
Generating a configuration file (.env) with necessary secrets and your domain settings.
Launching all the services.

During the installation, the script will prompt you for:

Your primary domain name (Required, e.g., yourdomain.com). This is the domain for which you've configured the wildcard DNS record.
Your email address (Required, used for service logins like Flowise, Supabase dashboard, Grafana, and for SSL certificate registration with Let's Encrypt).
An optional OpenAI API key (Not required. If provided, it can be used by Supabase AI features and Crawl4ai. Press Enter to skip).
Whether you want to import ~300 ready-made n8n community workflows (y/n, Optional. This can take 20-30 minutes, depending on your server and network speed).
The number of n8n workers you want to run (Required, e.g., 1, 2, 3, 4. This determines how many workflows can be processed in parallel. Each worker automatically gets its own dedicated task runner sidecar for executing Code nodes. Defaults to 1 if not specified).
A Service Selection Wizard will then appear, allowing you to choose which of the available services (like Flowise, Supabase, Qdrant, Open WebUI, etc.) you want to deploy. Core services (Caddy, Postgres, Redis) will be set up to support your selections.

Upon successful completion, the script will display a summary report. This report contains the access URLs and credentials for the deployed services. Save this information in a safe place!

Setup Instructions

See the Cloudflare Tunnel guide: cloudflare-instructions.md

Pre-installed System Tools in n8n

The custom n8n Docker image (n8n/Dockerfile.n8n) includes the following system-level tools:

ffmpeg: A powerful multimedia framework for converting, recording, and streaming audio and video. Use it via the Execute Command node in n8n workflows for tasks like:
Converting video/audio formats (e.g., MP4 to MP3)
Extracting audio from video files
Resizing or compressing media files
Generating thumbnails from videos

Cleaning up Docker

If you need to free up disk space, you can run the Docker cleanup command. This removes all unused Docker containers, images, and volumes.

make clean

This can be useful for removing old images and freeing up space, but be aware that it will remove all unused data.

Installation & Updates

Command	Description
`make install`	Full installation
`make update`	Update system and services (resets to origin)
`make update-preview`	Preview available updates without applying (dry-run)
`make git-pull`	Update for forks (merges from upstream/main)
`make clean`	Remove unused Docker resources

Quick Start and Usage

After successful installation, your services are up and running! Here's how to get started:

1. Access Your Services: The installation script provided a summary report with all access URLs and credentials. Please refer to that report. The main services will be available at the following addresses (replace yourdomain.com with your actual domain):

n8n: n8n.yourdomain.com (Log in with the email address you provided during installation and the initial password from the summary report. You may be prompted to change this password on first login.)
Appsmith: appsmith.yourdomain.com (Low-code app builder)
ComfyUI: comfyui.yourdomain.com (Node-based Stable Diffusion UI)
Databasus: databasus.yourdomain.com
Dify: dify.yourdomain.com (AI application development platform with comprehensive LLMOps capabilities)
Docling: docling.yourdomain.com (Universal document converter with REST API; web UI available at /ui)
Flowise: flowise.yourdomain.com (Log in with the email address you provided during installation and the initial password from the summary report.)
Grafana: grafana.yourdomain.com
Hermes Agent: hermes.yourdomain.com (Dashboard; log in with the email you provided during installation and the password from the Welcome Page. Requires an LLM provider key: run docker compose -p localai run --rm hermes setup. OpenAI-compatible API at hermes-api.yourdomain.com/v1 with Authorization: Bearer <HERMES_API_SERVER_KEY>; internally at http://hermes:8642/v1. To let the agent manage Docker containers, mount /var/run/docker.sock into the hermes service via docker-compose.override.yml — off by default because it grants root-equivalent host access.)
InvokeAI: invokeai.yourdomain.com (Stable Diffusion studio; download a model via the Model Manager on first visit)
Langfuse: langfuse.yourdomain.com
Letta: letta.yourdomain.com
LibreTranslate: translate.yourdomain.com
LightRAG: lightrag.yourdomain.com
Neo4j: neo4j.yourdomain.com
NocoDB: nocodb.yourdomain.com
Ollama: ollama.yourdomain.com (Optional local-LLM API; every request must send Authorization: Bearer <OLLAMA_CADDY_API_TOKEN>. A leaked token grants full control — including pulling/deleting models — not just inference.)
Open WebUI: webui.yourdomain.com
PaddleOCR: paddleocr.yourdomain.com
Portainer: portainer.yourdomain.com (Protected by Caddy basic auth; on first login, complete Portainer admin setup)
Postiz: postiz.yourdomain.com
Prometheus: prometheus.yourdomain.com (Typically used as a data source for Grafana)
Qdrant: qdrant.yourdomain.com
RAGApp: ragapp.yourdomain.com
RAGFlow: ragflow.yourdomain.com
SearXNG: searxng.yourdomain.com
Supabase (Dashboard): supabase.yourdomain.com
Uptime Kuma: uptime-kuma.yourdomain.com (Uptime monitoring dashboard)
WAHA: waha.yourdomain.com (WhatsApp HTTP API; engines: WEBJS, NOWEB, GOWS)
Weaviate: weaviate.yourdomain.com

AI Templates (Examples from n8n.io)

Optional Internal Utility: Python Runner

What it is: An internal-only service to run your custom Python code inside the same Docker network as your other services (n8n, Postgres, Qdrant, etc.). No external ports are exposed, and it is not proxied by Caddy.
How to enable: Select “Python Runner” in the Service Selection Wizard during install/update, or add the profile manually: COMPOSE_PROFILES=...,python-runner.
Where to put code: Place your Python files in python-runner/. The default entry point is python-runner/main.py.
Dependencies: Add them to python-runner/requirements.txt; they will be installed automatically on container start.

Explore n8n:

Log in to your n8n instance. This is your central hub for workflow automation.
If you chose to import the community workflows during installation, you'll find over 300 examples in your "Workflows" section. These are a great way to learn and get ideas.
Start building your first workflow! You have access to over 400 integrations and powerful AI tools.

Utilize Integrated AI Tools:

Connect n8n with Vector Stores: Use n8n to connect to Qdrant (accessible via its own endpoint if needed, typically qdrant.yourdomain.com), Supabase, or Weaviate (weaviate.yourdomain.com) to store and retrieve information for your AI tasks like Retrieval Augmented Generation (RAG).
Build with Flowise: Access Flowise at flowise.yourdomain.com to create AI agents and applications. You can trigger Flowise agents from n8n or vice-versa.
Interact with Open WebUI: Use Open WebUI at webui.yourdomain.com as a chat interface for your local AI models or n8n agents (e.g., using the n8n_pipe integration if configured).
Configure LLMs: If you wish to use large language models (LLMs) from providers like OpenAI, Anthropic, or locally via Ollama (if installed), you can easily configure credentials and connections within n8n nodes or in services like Flowise and Open WebUI.

4. Check Monitoring (Optional): - Visit Grafana (grafana.yourdomain.com) to see dashboards monitoring your system's performance (data sourced from Prometheus).

Secure Access with Cloudflare Tunnel (Optional)

Cloudflare Tunnel provides zero-trust access to your services without exposing any ports on your server. All traffic is routed through Cloudflare's secure network, providing DDoS protection and hiding your server's IP address.

Diagnostics & Configuration

Command	Description
`make doctor`	Run system diagnostics (checks DNS, SSL, containers, disk, memory)
`make setup-tls`	Configure custom TLS certificates for corporate/internal use

Run make help for the full list of available commands.

Included Community Workflows

Get started quickly with a vast library of pre-built automations (optional import during setup)! This collection includes over 300 workflows covering a wide range of use cases:

🚦 What's inside?

AI Agents & Chatbots: RAG, LLM, LangChain, Ollama, OpenAI, Claude, Gemini, and more
Gmail & Outlook: Smart labeling, auto-replies, PDF handling, and email-to-Notion
HR, E-commerce, IT, Security, Research, and more!
Notion, Airtable, Google Sheets: Data sync, AI summaries, knowledge bases
PDF, Image, Audio, Video: Extraction, summarization, captioning, speech-to-text
Slack, Mattermost: Ticketing, feedback analysis, notifications
Social Media: LinkedIn, Pinterest, Instagram, Twitter/X, YouTube, TikTok automations
Telegram, WhatsApp, Discord: Bots, notifications, voice, and image workflows
WordPress, WooCommerce: AI content, chatbots, auto-tagging