Hivekeep
RU
Настроить
Установка

Запустите Hivekeep.

Одна команда делает всё. Как только система поднимется, Queenie настроит остальное, беседуя с вами: никаких конфигурационных файлов.

Рекомендуется · самый простой способ

Вставьте одну строку. И всё.

Выполните это в терминале на вашей машине с Linux или macOS. Команда установит всё за вас.

curl -fsSL https://raw.githubusercontent.com/MarlBurroW/hivekeep/main/install.sh | bash

Когда установка завершится, откройте напечатанную ссылку в браузере. Остальное сделает Queenie.

По желанию

Нужен свой порт, домен или Docker?

Пропустите этот шаг, если строки выше вам достаточно. Иначе ответьте на пару вопросов, и мы сгенерируем точную команду под вашу конфигурацию.

1 · Как вы будете его использовать?

2 · Параметры

3 · Запуск

Установкаshell
curl -fsSL https://raw.githubusercontent.com/MarlBurroW/hivekeep/main/install.sh | bash

Ключ шифрования: о нём позаботятся за вас. Установщик автоматически генерирует и сохраняет его в $DATA_DIR/.encryption-key, так что секреты переживают перезапуски. Сделайте резервную копию этого файла вместе с базой данных. (Если предпочитаете управлять им сами, закрепите фиксированный ENCRYPTION_KEY переключателем выше.)

Если установка не удалась
  • port already in use / EADDRINUSE: порт 3000 занят. Измените поле «Порт» выше и запустите снова.
  • Windows: установщик работает только на Linux и macOS. Запустите его внутри WSL2 или используйте Docker Desktop.
  • Скачивание или клонирование зависает: убедитесь, что машина может достучаться до github.com и bun.sh по HTTPS (их может блокировать прокси).

Откройте http://localhost:3000 в браузере. Queenie проведёт вас через остальное (учётная запись администратора, ваш первый провайдер ИИ, ваши первые агенты). Никаких конфигурационных файлов.
Продвинутые и другие варианты Требования, а также Docker против нативной установки и сборки из исходников
Перед началом

Что нужно установочной строке.

На большинстве машин всё это уже есть.

Возможность запускать sudo
Установщику это нужно, чтобы доустановить недостающие системные пакеты (git, curl, unzip).
Около 500 МБ свободного места
Место для клонирования и сборки. 1 ГБ и больше: с запасом.
64-битная машина
x86_64 или ARM64. 32-битные системы (старые Raspberry Pi) не поддерживаются.
Исходящий HTTPS
Установщик скачивает с github.com и bun.sh, поэтому они должны быть доступны.
Наличие openssl
Используется для генерации ключей. Идёт в комплекте почти с каждым Linux и macOS.

У вас Windows? Нативный установщик не работает в Windows напрямую. Используйте WSL2 (запустите строку внутри вашего дистрибутива Linux) или Docker Desktop.

Сравнение

Нативно, Docker или из исходников?

Все три варианта запускают одно и то же приложение. Разница лишь в том, как оно живёт на машине.

Рекомендуется

Нативно (install.sh)

Выбирайте, если хотите, чтобы всё просто работало. Одна команда на вашей собственной машине с Linux или macOS.

  • Одна команда, сборка локально, не нужно публиковать или скачивать образ
  • Ключ шифрования сохраняется автоматически, секреты не теряются
  • Работает как сервис (systemd / launchd), автообновление с откатом
  • Агенты хозяйничают на машине: ставят инструменты и зависимости, прямой доступ к железу
  • Изменяет хост-систему (так задумано)
  • Только Linux и macOS (Windows через WSL2)
Контейнер

Docker

Выбирайте, если вы уже живёте в Docker и хотите чистый изолированный «прибор».

  • Полная изоляция, ноль следов на хосте
  • Работает везде, где работает Docker, включая Windows
  • Опубликованный образ пока недоступен, пока предпочтите нативную установку
  • Инструменты и бинарники, установленные агентами, не переживают перезапуск
  • Нужно сохранять том с данными, иначе вы потеряете секреты
Из исходников

Вручную

Выбирайте, если хотите читать код, дорабатывать его или запускать по-своему.

  • Полный контроль: клонируйте, собирайте, запускайте через Bun сами
  • Лучший вариант для контрибьюторов и разработки
  • Ни сервиса, ни автообновления, всё это вы настраиваете сами
  • Bun, сборка, миграции и ключ шифрования: всё вручную