Быстрый старт | Документация AQBot

Установка

Скачайте последний установщик со страницы загрузки или GitHub Releases.

macOS

Чип	Файл
Apple Silicon (M1 / M2 / M3 / M4)	`AQBot_x.x.x_aarch64.dmg`
Intel	`AQBot_x.x.x_x64.dmg`

Откройте .dmg и перетащите AQBot в папку «Программы».
Запустите AQBot. Если macOS блокирует приложение, перейдите в Системные настройки → Конфиденциальность и безопасность и нажмите Всё равно открыть.

macOS: «Приложение повреждено» или «Разработчик не верифицирован»

AQBot подписан собственным сертификатом подписи кода проекта, а не сертификатом Apple Developer ID, поэтому после загрузки из браузера macOS всё ещё может сообщать, что «Приложение AQBot повреждено и не может быть открыто» или что «Не удаётся открыть AQBot, так как не удалось проверить разработчика».

Отключать Gatekeeper для всей системы не нужно — разрешите только AQBot:

В Finder нажмите на AQBot.app, удерживая Control, выберите Открыть, затем снова нажмите Открыть.
Если приложение по-прежнему блокируется, перейдите в Системные настройки → Конфиденциальность и безопасность, найдите AQBot в разделе Безопасность и нажмите Всё равно открыть.
Снова запустите AQBot.

Разрешение Gatekeeper и разрешение «Универсальный доступ» — это разные настройки. Для панели инструментов выделения текста также включите AQBot в Системные настройки → Конфиденциальность и безопасность → Универсальный доступ, следуя подсказке в приложении.

Windows

Архитектура	Файл
x64 (большинство ПК)	`AQBot_x.x.x_x64-setup.exe`
ARM64	`AQBot_x.x.x_arm64-setup.exe`

Запустите установщик и следуйте мастеру. Запустите AQBot из меню «Пуск» или ярлыка на рабочем столе.

Linux

Формат	Архитектура	Файл
Debian / Ubuntu	x64	`AQBot_x.x.x_amd64.deb`
Debian / Ubuntu	ARM64	`AQBot_x.x.x_arm64.deb`
Fedora / openSUSE	x64	`AQBot_x.x.x_x86_64.rpm`
Fedora / openSUSE	ARM64	`AQBot_x.x.x_aarch64.rpm`
Любой дистрибутив	x64	`AQBot_x.x.x_amd64.AppImage`
Любой дистрибутив	ARM64	`AQBot_x.x.x_aarch64.AppImage`

bash

# Debian / Ubuntu
sudo dpkg -i AQBot_x.x.x_amd64.deb
# Fedora / openSUSE
sudo rpm -i AQBot_x.x.x_x86_64.rpm
# AppImage (любой дистрибутив)
chmod +x AQBot_x.x.x_amd64.AppImage
./AQBot_x.x.x_amd64.AppImage

Начальная настройка

1. Открыть настройки

Запустите AQBot и нажмите на значок шестерёнки внизу боковой панели, или нажмите Cmd/Ctrl+,.

2. Добавить провайдера

Перейдите в Настройки → Провайдеры и нажмите кнопку +.

Введите отображаемое имя (например, OpenAI).
Выберите тип провайдера (OpenAI, Anthropic, Google Gemini и т.д.).
Вставьте ваш API-ключ.
Подтвердите Base URL — официальный endpoint предзаполнен для встроенных типов.

3. Получить модели

Нажмите Получить модели, чтобы загрузить список доступных моделей из API провайдера. Вы также можете добавлять ID моделей вручную при необходимости.

4. Установить модель по умолчанию

Перейдите в Настройки → Модель по умолчанию и выберите провайдера и модель, которые новые разговоры должны использовать по умолчанию.

Ваш первый разговор

Нажмите Новый чат в боковой панели (или нажмите Cmd/Ctrl+N).
Выберите модель из селектора моделей вверху чата.
Введите сообщение и нажмите Enter.
AQBot транслирует ответ в реальном времени. Модели с поддержкой блоков размышлений (например, Claude, DeepSeek R1) отображают процесс рассуждений в сворачиваемом разделе.

Горячие клавиши

Сочетание	Действие
`Cmd/Ctrl`+`Shift`+`A`	Показать / скрыть текущее окно
`Cmd/Ctrl`+`Shift`+`Alt`+`A`	Показать / скрыть все окна
`Cmd/Ctrl`+`Shift`+`W`	Закрыть окно
`Cmd/Ctrl`+`N`	Новый разговор
`Cmd/Ctrl`+`,`	Открыть настройки
`Cmd/Ctrl`+`K`	Палитра команд
`Cmd/Ctrl`+`Shift`+`G`	Переключить API-шлюз

Данные и резервное копирование

Каталоги данных

Путь	Содержимое
`~/.aqbot/`	Состояние приложения — база данных, ключи шифрования, векторная БД, SSL-сертификаты
`~/Documents/aqbot/`	Файлы пользователя — изображения, документы, резервные копии

Следующие шаги

Настройка провайдеров — добавление и управление ИИ-провайдерами
MCP-серверы — подключение внешних инструментов для расширения возможностей ИИ
API-шлюз — предоставление провайдеров как локального API-сервера