Selfhost AI CLI

Установщик разворачивает выбранные AI-сервисы на отдельном VPS и дает команды для настройки и обслуживания стека

  • 955 ★ репозитория
  • Последний коммит
  • Apache-2.0
CLI

Широкий доступ

Почему такой уровень

  • Установщик с sudo меняет пакеты системы, сеть и межсетевой экран
  • Файл `.env` и страница Welcome содержат секреты выбранных сервисов
  • Обновление может заменить ручные правки инфраструктуры и перезапустить рабочие сервисы
Все причины и проверки

kossakovsky/selfhost-ai

Установка

Ручная установка

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

Только на подготовленном отдельном VPS. Проверьте скрипт, домен и ресурсы до запуска с правами администратора.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Установщик с sudo меняет пакеты системы, сеть и межсетевой экран
  • Файл `.env` и страница Welcome содержат секреты выбранных сервисов
  • Обновление может заменить ручные правки инфраструктуры и перезапустить рабочие сервисы

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Selfhost AI устанавливает набор сервисов для AI-проектов на вашем сервере. Интерактивный мастер предлагает выбрать нужные компоненты, после чего готовит окружение и запускает Docker Compose. CLI-команды обслуживают полученный стек. Среди компонентов есть Ollama и Open WebUI для работы с моделями. Для автоматизации можно выбрать n8n, а для поиска по документам отдельные хранилища и RAG-сервисы. Опциональный n8n-MCP открывает кодовому агенту документацию узлов и инструменты процессов n8n. Установщик создает доменные адреса и страницу с доступами к выбранным сервисам. После установки команда `make status` показывает контейнеры, а `make doctor` проверяет инфраструктуру. У каждого установленного сервиса остаются собственные настройки и условия использования.

Для кого. Для разработчиков и администраторов, которые готовы обслуживать отдельный VPS с выбранными AI-сервисами и интеграциями для агентов.

Подходит, если

  • Нужно развернуть несколько совместимых AI-сервисов на отдельном сервере
  • Нужны общие команды проверки и обновления Docker-стека
  • Команде нужен собственный n8n вместе с выбранными AI-компонентами
  • Нужно подготовить серверную среду до подключения кодового агента к n8n-MCP

Не подходит, если

  • Нужно добавить один небольшой MCP без настройки сервера
  • Нельзя давать установщику права администратора на машине
  • Есть только домашний компьютер или общий хостинг без публичного VPS

Пример запроса к агенту

Подготовь план установки Selfhost AI на новый VPS только с n8n и нужными ему зависимостями. Проверь ресурсы, DNS и изменения системы до запуска скрипта.

Ограничения

Поддерживаемый путь требует отдельного VPS с публичным IP и 64-битной Ubuntu 24.04 LTS, а также wildcard A-записи домена на этот сервер. Для малого набора нужны 4 ГБ RAM, 2 ядра и 40 ГБ диска; для всех сервисов минимум 20 ГБ RAM, 4 ядра и 60 ГБ, без запаса под модели и данные. Установщик отправляет события через Scarf; `SCARF_ANALYTICS=false` в `.env` отключает его телеметрию. Локальная модель не отменяет внешние обращения других компонентов: проверяйте подключения выбранного набора.

Как отключить. В каталоге установки выполните `make stop` для остановки стека. Отдельно удалите подключения сервисов из агентов и отзовите их ключи. Сохраните данные контейнеров и `.env` до удаления. Остановка Compose не возвращает прежние настройки системы и межсетевого экрана, которые изменил установщик.

Частые вопросы

Как запустить установщик?

Клонируйте репозиторий и выполните `sudo bash ./scripts/install.sh` из его каталога. Скрипт меняет систему, поэтому сначала прочитайте его и подготовьте отдельный сервер.

Что меняется на сервере?

Установщик обновляет систему, настраивает межсетевой экран и защиту входа, ставит Docker и запускает выбранные сервисы. Это больше, чем запуск одного контейнера.

Где найти адреса и пароли сервисов?

На странице `welcome.<ваш-домен>`, которую установщик показывает в конце. Она содержит доступы к сервисам; ограничьте ее доступность и не публикуйте снимки экрана с паролями.

Сохраняет ли обновление ручные правки файлов?

Не все. `make update` сбрасывает отслеживаемые файлы, включая `Caddyfile` и `docker-compose.yml`. Для своих настроек используйте `caddy-addon/site-*.conf` и `docker-compose.override.yml`, как предлагает автор.

Обязательно ли импортировать готовые процессы n8n?

Нет. Импорт предлагается отдельно при выборе n8n. Перед его включением проверьте нужные процессы и их подключения; чужой шаблон может обращаться к внешним сервисам.

Какие лицензии и расходы есть у установки?

Установщик имеет Apache-2.0, компоненты сохраняют свои лицензии. VPS, домен и внешние API оплачиваются отдельно.

Обсуждение

Вопросов и отзывов пока нет.

CLI на Go сравнивает сервер с прошлым снимком, сообщает только значимые перемены и отдает их агенту через MCP

CLIШирокий доступ314Звезды репозитория

Скилл и бинарник на Go: агент с вашего согласия ставит на ваш сервер приложения из каталога в 93 программы через Docker Compose

СкиллШирокий доступ1,5 тыс.Звезды репозитория

Скилл, который разворачивает панель 3X-UI и Xray VLESS за nginx на Ubuntu-сервере и затем обслуживает его через готовые скрипты

СкиллШирокий доступ31Звезды репозитория
Российский стек

Devcontainer и Hyper-V VM с сервером 1С, изолирующие ИИ-агента от хостовой машины, чтобы ошибочная команда не задела реальные файлы и диски

ВоркфлоуРасширенный доступ44Звезды репозитория

CLI для постоянных Linux-окружений в Docker или Podman: у каждого проекта свой контейнер, где агент не видит остальную систему

CLIШирокий доступ385Звезды репозитория
Официальный

AI-помощник для Kubernetes: переводит запросы на естественном языке в операции kubectl и работает как MCP-сервер

CLIШирокий доступ7,6 тыс.Звезды репозитория

Коротко о README

Мастер создает секреты выбранных сервисов в `.env`. Пользователь сохраняет их у себя; команды Make управляют уже собранным стеком.

Бейдж для README

Сообщить о проблеме

Foxx AISelfhost AI
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.