ИИ‑агенты > Pastukhov MultiAgent > Документация MultiAgent > Установка на Windows

Установка на Windows

MultiAgent ставится на Windows мастером установки — программой PastukhovMultiAgent-Setup-<версия>.exe: приложение работает локально на http://localhost:3991 и подключается к вашим удалённым Linux-серверам по SSH. Docker, WSL и SSH-инструменты на этом компьютере не нужны — всё, что нужно серверам, MultiAgent установит на них сам.

Системные требования

  • Windows 10 или новее (64-разрядная);
  • минимум 1 ГБ оперативной памяти, около 500 МБ свободного места на диске;
  • среда выполнения .NET не требуется — установщик включает всё необходимое, ничего дополнительно ставить не нужно;
  • права администратора не нужны — приложение устанавливается для текущего пользователя.

Мастер установки

Запустите установщик и пройдите шаги мастера:

  • Порт — по умолчанию 3991, приложение будет работать по адресу http://localhost:3991; порт можно поменять во время установки (диапазон 1–65535);
  • Папка данных — по умолчанию %LOCALAPPDATA%\Pastukhov\MultiAgent\data: здесь хранятся база данных, ключи и сертификаты, а также файл активированной лицензии. Папка лежит вне каталога приложения, поэтому данные сохраняются при переустановке и удалении; повторный запуск установщика запоминает ранее выбранную папку. Чтобы отказаться от локальной базы, укажите адрес PostgreSQL в MULTIAGENT_DATABASE;
  • Вход — имя пользователя (по умолчанию admin) и пароль (хранится в виде защищённого отпечатка). Учётная запись создаётся при первом запуске; если пароль пропустить, MultiAgent откроет страницу первичной регистрации. Обновить учётные данные можно повторным запуском мастера;
  • Лицензия — пустой ключ даёт встроенную 30-дневную пробную лицензию; ключ можно ввести сразу или обновить позже мастером или диалогом лицензии в приложении. Приобрести лицензию можно на странице лицензирования;
  • Параметры — ярлык на рабочем столе и в панели быстрого запуска (опционально).

Что устанавливается

  • Файлы приложения в %LOCALAPPDATA%\Pastukhov\MultiAgent: исполняемый файл и библиотеки, веб-клиент, встроенные шаблоны инструментов и продуктов, файлы переводов;
  • Переменные окружения в реестре Windows (см. ниже);
  • Группа в меню «Пуск»: Pastukhov MultiAgent.

Переменные окружения

Ярлыки запуска передают настройки как параметры командной строки, поэтому приложение стартует с правильной конфигурацией независимо от пользовательского окружения:

  • MULTIAGENT_DATA — корень данных (база, ключи, сертификаты, лицензия);
  • MULTIAGENT_PROJECT_PATH — корень приложения (файлы переводов брендов);
  • AGENT_TOOLS / AGENT_PRODUCTS — встроенные шаблоны инструментов и продуктов;
  • MULTIAGENT_LOGIN / MULTIAGENT_PASSWORD — создание пользователя при запуске (пароль — SHA256-хеш);
  • AGENT_LICENSE — ключ лицензии при первом запуске;
  • MULTIAGENT_BRAND — необязательное переопределение бренда; обычно определяется по имени exe-файла;
  • MULTIAGENT_DATABASE — необязательная строка подключения PostgreSQL (по умолчанию — локальная база в папке данных);
  • AGENT_API_URL / AGENT_API_KEY / MULTIAGENT_API_KEY — необязательное подключение собственного ассистента: встроенный чат и программный API (входящий ключ принимается как отпечаток).

Переменные можно передавать и прямо в командной строке в формате КЛЮЧ=ЗНАЧЕНИЕ — они переопределяют настройки для этого запуска:

:: Изменить порт для одного запуска
PastukhovMultiAgent.exe --urls=http://localhost:3992

:: Указать другую папку данных
PastukhovMultiAgent.exe MULTIAGENT_DATA=D:\MultiAgentData

:: Использовать PostgreSQL вместо локального SQLite
PastukhovMultiAgent.exe MULTIAGENT_DATABASE="Host=db.local;Port=5432;User Id=multiagent;Password=secret;Database=multiagent"

После установки

Запускайте MultiAgent через меню «Пуск» → Pastukhov MultiAgent → MultiAgent (или ярлык на рабочем столе), откройте http://localhost:3991 и войдите с учётными данными, заданными при установке. Затем добавьте первый сервер: Linux-машину с установленным Docker и доступом по SSH (по паролю или ключу — ключи загружаются в приложении и хранятся в базе в зашифрованном виде). Всё остальное — установку Docker и зависимостей на серверах — MultiAgent делает сам.

Бренд интерфейса определяется по имени исполняемого файла: сохраняйте имя PastukhovMultiAgent.exe либо закрепите бренд переменной MULTIAGENT_BRAND.

Обновление и удаление

Обновление — повторный запуск установщика новой версии: папка данных сохраняется. Удаление — через «Параметры → Приложения» или ярлык удаления в меню «Пуск»: удаляются файлы приложения и переменные окружения, но папка данных сохраняется — если нужно удалить всё, удалите %LOCALAPPDATA%\Pastukhov\MultiAgent\data вручную.

← Оглавление документации