Sherpa AI Server#

Download da distribuição#

Escolha uma versão publicada do Sherpa AI Server. O arquivo client-files determina a versão das imagens Docker para instalação ou atualização. Os componentes não devem ser baixados por links /latest independentes, pois uma publicação parcial pode misturar versões diferentes.

Este exemplo usa a versão 2.5.1. Substitua-a pela versão publicada desejada e execute os comandos no diretório de instalação:

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'

Se a verificação não exibir SHA-256 OK, não extraia o arquivo. Confira a versão e baixe os arquivos novamente. O comando file identifica o tipo de arquivo, mas não verifica sua integridade.

Instalação com acesso ao servidor de downloads#

Depois de verificar o arquivo, extraia-o e execute o instalador:

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

O instalador seleciona as imagens conforme a versão de client-files, oferece os modelos necessários e verifica os valores SHA-256 dos arquivos e as tags do manifesto Docker antes de iniciar os serviços. O conjunto depende das opções CPU ou GPU, Whisper e reranker. Os modelos são baixados separadamente e não estão vinculados à versão do lançamento.

Siga o guia de instalação para ver as etapas detalhadas. Para uma instalação existente, use o guia de atualização.

Instalação sem acesso ao servidor de downloads#

Em um computador com acesso à distribuição, obtenha client-files, os arquivos de imagens Docker necessários de exatamente a mesma versão e cada arquivo <nome do arquivo>.SHA256SUM. Transfira todos para um diretório no servidor de destino e execute install.sh. Ele usa e verifica os arquivos locais antes da instalação. Obtenha os arquivos e checksums faltantes antes de continuar.

Os componentes principais são aiserver, aiserver-pg, aiserver-embed, aiserver-nginx, aiserver-websocket, aiserver-code-interpreter, aiserver-mcp-orchestrator e mypy. GPU também exige aiserver-llm-server. CPU exige aiserver-llm-server-cpu. aiserver-whisper e aiserver-bge-reranker dependem das funcionalidades escolhidas. Os arquivos de imagem usam o nome <componente>_<versão>.tar.gz.

Transfira os arquivos por SCP/SFTP ou mídia removível. Após copiar, confira se há espaço para arquivos, arquivos temporários, extração e contêineres em execução:

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

Não pare manualmente uma instalação em execução enquanto prepara os arquivos: o script de atualização verifica disponibilidade, versão, checksums, manifesto Docker e espaço livre antes de mostrar seu plano de ações.