Установка 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
- Откройте VS Code.
- Нажмите
Ctrl + P(илиCmd + Pв macOS). - Вставьте следующую команду и нажмите Enter:
ext install agenticmarket.andromity-agentУстановка расширения через CLI
Если вы предпочитаете устанавливать из терминала:
code --install-extension agenticmarket.andromity-agent2. Установка отдельного 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-run4. Особенности платформ
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.
Остальные страницы документации доступны на английском языке. Открыть документацию на английском
Быстрый старт: первая задача AI-агента в VS Code или терминале
Установите Andromity, подключите модель, отметьте рабочую область как доверенную и проверьте первое изменение кода в VS Code или терминале.
Настройка AI-моделей, провайдеров и API-ключей
Полный справочник по ~/.andromity/config.toml, переменным окружения, моделям и настройкам конфиденциальности.