0.4.11
Поиск по документации… ⌘K
02 · Руководство пользователя

02. Установка

AstraCode распространяется готовыми бинарными архивами. Архив можно:

  • скачать в GitLab Package Registry проекта Astra Code Build;
  • получить напрямую от команды AstraCode — например, файлом в рабочей беседе.

GitLab Package Registry:

text
https://gitlab.prosto.aib.pro/astracode/astra-code-build/-/packages

Для доступа к внутреннему GitLab требуется корпоративная сеть или VPN. Если вам уже предоставили архив, доступ к GitLab для установки не нужен.

Архивы бывают двух типов:

  • licensed — перед работой нужно активировать лицензию;
  • nolicense — специальная сборка без проверки лицензии, активация не требуется.

Ниже используется версия 0.5.1. Для другой версии подставьте фактическое имя полученного архива и распакованной директории.

Linux x86_64

Licensed-сборка

Распакуйте архив и перейдите в созданную директорию:

bash
tar -xzf astracode-linux-x86_64-gnu-0.5.1.tar.gz
cd astracode-linux-x86_64-gnu-0.5.1

Активируйте лицензию, указав путь к полученному ключу:

bash
./bin/astracode license activate --file /path/to/license.key

Запустите AstraCode для нужного проекта:

bash
./bin/astracode -C /path/to/project

Сборка без лицензии

bash
tar -xzf astracode-linux-x86_64-gnu-nolicense-0.5.1.tar.gz
cd astracode-linux-x86_64-gnu-nolicense-0.5.1
./bin/astracode -C /path/to/project

Активация лицензии для nolicense-сборки не нужна.

Повторный запуск после перезапуска терминала

Команда cd, выполненная ранее, не сохраняется между терминальными сессиями. Перейдите в распакованную директорию снова:

bash
cd /path/to/astracode-linux-x86_64-gnu-0.5.1
./bin/astracode -C /path/to/project

Либо запускайте бинарник по абсолютному пути:

bash
/path/to/astracode-linux-x86_64-gnu-0.5.1/bin/astracode -C /path/to/project

Для nolicense-сборки путь аналогичный, но содержит -nolicense-.

macOS Apple Silicon

Licensed-сборка

Распакуйте полученный архив в отдельную постоянную директорию:

bash
mkdir -p "$HOME/astracode-0.5.1"
unzip astracode-macos-0.5.1.zip -d "$HOME/astracode-0.5.1"

Перейдите в неё и снимите quarantine-атрибут:

bash
cd "$HOME/astracode-0.5.1"
xattr -dr com.apple.quarantine ./astracode

Активируйте лицензию:

bash
./astracode license activate --file /path/to/license.key

Запустите AstraCode для нужного проекта:

bash
./astracode -C /path/to/project

При первом запросе доступа к macOS Keychain выберите Always Allow. После этого Keychain не должен спрашивать пароль при каждом запуске.

Сборка без лицензии

Имя предоставленного nolicense-архива может отличаться, поэтому используйте фактическое имя файла:

bash
mkdir -p "$HOME/astracode-nolicense-0.5.1"
unzip /path/to/provided-nolicense-archive.zip -d "$HOME/astracode-nolicense-0.5.1"
cd "$HOME/astracode-nolicense-0.5.1"
xattr -dr com.apple.quarantine ./astracode
./astracode -C /path/to/project

Активация лицензии для nolicense-сборки не нужна.

Повторный запуск после перезапуска терминала

Перейдите в директорию с распакованным бинарником:

bash
cd "$HOME/astracode-0.5.1"
./astracode -C /path/to/project

Либо используйте абсолютный путь:

bash
"$HOME/astracode-0.5.1/astracode" -C /path/to/project

Для nolicense-сборки используйте путь $HOME/astracode-nolicense-0.5.1/astracode.

Проверка версии

Linux:

bash
./bin/astracode --version

macOS:

bash
./astracode --version

Для nolicense-сборки команда должна показать суффикс -nolicense.

Опционально: добавить команду astracode в PATH

Этот шаг нужен только для удобства. Без него AstraCode полноценно работает при запуске через ./bin/astracode, ./astracode или абсолютный путь.

Сначала переместите распакованную директорию туда, где планируете хранить её постоянно. Симлинк перестанет работать, если позднее переместить или удалить эту директорию.

Linux

Находясь в корне распакованной Linux-сборки:

bash
mkdir -p "$HOME/.local/bin"
ln -sfn "$(pwd)/bin/astracode" "$HOME/.local/bin/astracode"

macOS

Находясь в директории с бинарником astracode:

bash
mkdir -p "$HOME/.local/bin"
ln -sfn "$(pwd)/astracode" "$HOME/.local/bin/astracode"

Если ~/.local/bin ещё не входит в PATH, для zsh добавьте его в ~/.zshrc:

bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> "$HOME/.zshrc"
source "$HOME/.zshrc"

Проверьте настройку:

bash
astracode --version

После этого из любой директории можно запускать:

bash
astracode -C /path/to/project

Первый запуск

При первом запуске AstraCode создаёт рабочую директорию ~/.astracode/. В ней хранятся конфигурация, секреты, сессии, память, скиллы и логи.

Если модель ещё не настроена, автоматически откроется форма добавления провайдера. Настроить или сменить его позднее можно через /model.

В TUI полезно проверить:

text
/status
/debug-config

Обновление

Получите архив новой версии тем же способом: из GitLab Package Registry или напрямую от команды AstraCode. Распакуйте его в новую директорию и сначала проверьте запуск по относительному или абсолютному пути.

Если вы создавали симлинк ~/.local/bin/astracode, переключите его на новый бинарник командами из раздела про PATH.

Конфигурация и пользовательские данные находятся отдельно в ~/.astracode/, поэтому при замене бинарника сохраняются.

Если что-то не работает

См. 15-troubleshooting.md. Типовые проблемы:

  • Permission denied — выполните chmod +x для бинарника.
  • macOS сообщает operation not permitted — снимите com.apple.quarantine через xattr.
  • Could not find suitable model provider — запустите TUI и настройте провайдера через /model.
  • Короткая команда astracode не найдена — запускайте бинарник относительным/абсолютным путём или добавьте ~/.local/bin в PATH.
ESC