Документация

Установка AI-агента Andromity для VS Code и терминала

Установите AI-агента для программирования Andromity из VS Code Marketplace, через pipx или с помощью установочного скрипта в Windows, macOS и Linux, а затем проверьте установку.

Andromity можно установить как нативное расширение VS Code, как отдельное CLI/TUI-приложение или из исходного кода для разработки.

Требования

Перед установкой Andromity убедитесь, что ваша система соответствует следующим требованиям:

  • Python: >= 3.11 (Python 3.12 и 3.13 полностью поддерживаются)
  • Git: установлен и доступен через системный PATH
  • Операционные системы: macOS (Apple Silicon / Intel), Linux (x86_64 / arm64), Windows 10/11 (PowerShell и WSL2)
  • Node.js (необязательно): >= 18.0.0 (требуется только для запуска собственных MCP-серверов на TypeScript)

1. Установка расширения VS Code

Расширение VS Code предоставляет полноценный интерфейс: размещение в дополнительной боковой панели (Secondary Sidebar), интерактивные наложения diff и профилировщик-водопад в реальном времени.

Установка из Marketplace

  1. Откройте VS Code.
  2. Нажмите Ctrl + P (или Cmd + P в macOS).
  3. Вставьте следующую команду и нажмите Enter:
ext install agenticmarket.andromity-agent

Установка расширения через CLI

Если вы предпочитаете устанавливать из терминала:

code --install-extension agenticmarket.andromity-agent

2. Установка отдельного CLI для терминала

Среда выполнения для терминала — это ядро агента без надстроек, с текстовым пользовательским интерфейсом (TUI) на базе Textual и Rich.

curl -fsSL https://raw.githubusercontent.com/agenticmarket/andromity/main/install.sh | bash

Установщик автоматически:

  • проверяет наличие Python 3.11+;
  • создаёт изолированное виртуальное окружение в ~/.andromity/venv;
  • создаёт символическую ссылку на исполняемый файл andromity в /usr/local/bin или ~/.local/bin.

3. Проверка установки

Убедитесь, что исполняемый файл CLI доступен в вашей командной оболочке:

andromity --version

Запустите интерактивный сеанс:

andromity

Выполните разовую команду из скрипта в режиме без интерфейса (headless):

andromity run "analyze git status and report pending changes" --dry-run

4. Особенности платформ

Python из Windows Store

Если Python установлен из Microsoft Store, Windows виртуализирует локальные данные приложений. Ваши файлы конфигурации будут находиться в каталоге:

%LOCALAPPDATA%\Packages\PythonSoftwareFoundation.Python.3.12_qbz5n2kfra8p0\LocalCache\Roaming\andromity\

При обычной установке Python или установке через pyenv-win файлы хранятся в %APPDATA%\andromity\config.toml.

Linux-серверы без графического интерфейса

При запуске Andromity на удалённых серверах по SSH убедитесь, что ваш терминал поддерживает 256-цветный режим или truecolor (export TERM=xterm-256color) — это обеспечит оптимальную отрисовку Textual.

Остальные страницы документации доступны на английском языке. Открыть документацию на английском