Главная/Документация/Начало работы/Установка AIKraft Agents
Начало работы Особенности сборки AIKraft

Установка AIKraft Agents

Инструкция по установке настольного приложения AIKraft Agents на macOS, Windows и Linux, включая системные требования, способы установки и сборку из исходного кода.

Установите настольное приложение AIKraft Agents на macOS, Windows или Linux.

AIKraft Agents — это нативное настольное приложение. Оно работает локально на вашем компьютере, хранит учётные данные в зашифрованном виде на диске и подключается к внешним сервисам только при настройке источников.

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

Платформа Архитектуры Примечания
macOS Apple Silicon (arm64) macOS 11+. Поддержка Intel Mac прекращена начиная с v0.10.1 (v0.10.0 была последним выпуском для Intel).
Windows x64 Windows 10+
Linux x64 Формат AppImage, требует FUSE

Сборки для macOS Intel (x64) прекращены начиная с v0.10.1. Новые версии выпускаются только для Apple Silicon (M-series). Intel Mac могут установить последнюю поддерживаемую сборку v0.10.0, но не получат будущие обновления. Windows и Linux не затрагиваются.

Ручная установка (рекомендуется)

macOS

Apple Silicon (M1/M2/M3/M4):

terminalbash
https://aikraft.ru/electron/latest/Craft-Agents-arm64.dmg
  1. Скачайте файл .dmg
  2. Откройте DMG и перетащите Craft Agent в папку Applications
  3. Запустите из папки Applications или Spotlight (CMD+Space, введите «Craft Agent»)

Intel Mac не поддерживаются. Начиная с v0.10.1, AIKraft Agents выпускает только сборку для Apple Silicon (arm64). Последний релиз с .dmg для Intel был v0.10.0.

Windows

Скачать:

terminalbash
https://aikraft.ru/electron/latest/Craft-Agents-x64.exe
  1. Скачайте и запустите установщик
  2. Следуйте указаниям установщика (установка в %LOCALAPPDATA%\Programs\Craft Agent)
  3. Запустите из меню Пуск или ярлыка на рабочем столе

Linux

Скачать:

terminalbash
https://aikraft.ru/electron/latest/Craft-Agents-x64.AppImage
  1. Скачайте AppImage
  2. Сделайте файл исполняемым: chmod +x Craft-Agents-x64.AppImage
  3. Запустите: ./Craft-Agents-x64.AppImage

Требуется FUSE. Установите с помощью:

  • Debian/Ubuntu: sudo apt install fuse libfuse2
  • Fedora: sudo dnf install fuse fuse-libs

Установка скриптом

Для автоматизированной установки с проверкой контрольных сумм:

macOS / Linux

terminalbash
curl -fsSL https://aikraft.ru/install-app.sh | bash

Это автоматически загружает, проверяет и устанавливает AIKraft Agents.

Windows

terminalpowershell
irm https://aikraft.ru/install-app.ps1 | iex

Выполните в PowerShell. Загружает, проверяет контрольную сумму и запускает установщик.

Сборка из исходного кода

AIKraft Agents — открытый исходный код. Чтобы собрать из исходников:

Предварительные требования

  • Bun — среда выполнения и менеджер пакетов
  • Node.js 18+ — необходим для electron-builder
  • Git

Клонирование и сборка

terminalbash
# Клонирование репозитория
git clone https://github.com/lukilabs/craft-agents-oss.git
cd craft-agents-oss

# Установка зависимостей
bun install

# Режим разработки (горячая перезагрузка)
bun run electron:dev

# Производственная сборка (сборка и запуск)
bun run electron:start

Сборка установщиков

macOS

terminalbash
# Apple Silicon
bash apps/electron/scripts/build-dmg.sh arm64

Результат: apps/electron/release/Craft-Agents-arm64.dmg

Подпись кода и нотарификация требуют учётных данных Apple Developer. Установите переменные окружения APPLE_SIGNING_IDENTITY, APPLE_ID, APPLE_TEAM_ID и APPLE_APP_SPECIFIC_PASSWORD. Без них сборка будет неподписанной.

Windows

terminalpowershell
powershell -ExecutionPolicy Bypass -File apps/electron/scripts/build-win.ps1

Результат: apps/electron/release/Craft-Agents-x64.exe

Linux

terminalbash
bash apps/electron/scripts/build-linux.sh x64

Результат: apps/electron/release/Craft-Agents-x64.AppImage

Запуск

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

  • macOS — папка Applications или Spotlight (CMD+Space, введите «Craft Agent»)
  • Windows — меню Пуск, ярлык на рабочем столе или craft-agents в терминале
  • Linux — выполните craft-agents из терминала (если установлено скриптом) или запустите AppImage напрямую

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

Дальнейшие шаги

Добавить источники

Подключите GitHub, Linear, API и локальные файлы, чтобы расширить возможности агента.

Оптимизация вывода команд с RTK

Установите RTK и включите Настройки → ИИ → Производительность → Оптимизация токенов для сессий программирования с интенсивным использованием команд.

Нужен такой агент в вашей компании?

Устанавливаем под ключ: настройка на компьютерах сотрудников, единый аккаунт, интеграция с 1С и внутренними системами, обучение команды. Подробнее о внедрении →