Sherpa AI Server#

Скачивание дистрибутива#

Выберите одну опубликованную версию Sherpa AI Server. Архив client-files задает версию Docker-образов для установки или обновления. Не скачивайте каждый компонент по независимой ссылке /latest, так как при частичном выпуске это может привести к смешению разных версий.

Ниже пример для версии 2.5.1. Замените ее на нужную опубликованную версию и выполняйте команды в каталоге установки:

VERSION=2.5.1
CLIENT_ARCHIVE="docker_aiserver_client_files_${VERSION}.tgz"
BASE_URL="https://downloads.sherparpa.ru/SherpaAIServer/aiserver-client-files"

curl -fL -O "${BASE_URL}/${CLIENT_ARCHIVE}"
curl -fL -O "${BASE_URL}/${CLIENT_ARCHIVE}.SHA256SUM"

EXPECTED_SHA256="$(awk '{print $1}' "${CLIENT_ARCHIVE}.SHA256SUM")"
ACTUAL_SHA256="$(sha256sum "${CLIENT_ARCHIVE}" | awk '{print $1}')"
test "$ACTUAL_SHA256" = "$EXPECTED_SHA256" && echo 'SHA-256 OK'

Если проверка не вывела SHA-256 OK, не распаковывайте архив. Проверьте выбранную версию и скачайте файлы заново. Команда file определяет тип архива, но не подтверждает его целостность.

Установка с доступом к серверу загрузок#

После проверки архива распакуйте его и запустите установщик:

tar -xzf "$CLIENT_ARCHIVE"
chmod +x sh_scripts/*.sh
sudo ./sh_scripts/install.sh

Установщик подбирает необходимые образы по версии client-files, предлагает нужные модели, проверяет SHA-256 архивов и теги в Docker manifest до запуска сервисов. Набор образов зависит от выбранных вариантов: CPU или GPU, Whisper, reranker. Модели скачиваются отдельно и не имеют версии релиза.

Подробные шаги приведены в руководстве по установке. Для уже работающей установки используйте инструкцию по обновлению.

Установка без доступа к серверу загрузок#

На машине с доступом к дистрибутиву получите client-files, необходимые архивы Docker-образов точно той же версии и файлы <имя архива>.SHA256SUM. Перенесите их в один каталог на целевом сервере и запустите install.sh: он использует локальные файлы и проверяет их до установки. Если обязательного архива или контрольной суммы нет, получите полный комплект прежде, чем продолжать.

Основные компоненты: aiserver, aiserver-pg, aiserver-embed, aiserver-nginx, aiserver-websocket, aiserver-code-interpreter, aiserver-mcp-orchestrator, mypy. Для GPU дополнительно нужен aiserver-llm-server, для CPU — aiserver-llm-server-cpu. aiserver-whisper и aiserver-bge-reranker зависят от выбранных функций. Имя архива образа имеет вид <компонент>_<версия>.tar.gz.

Для переноса можно использовать SCP/SFTP или внешний носитель. После копирования убедитесь, что на диске достаточно места для архивов, временных файлов, распаковки и работающих контейнеров:

df -h .
ls -lh docker_aiserver_client_files_*.tgz *.tar.gz *.SHA256SUM

Не останавливайте работающую установку вручную ради подготовки файлов: скрипт обновления сначала проверяет доступность, версию, контрольные суммы, Docker manifest и свободное место, а затем выводит план действий.