К содержимому

CapyAgent - программа на вашем компьютере.

К содержимому

CapyAgent - программа на вашем компьютере.

Блог ·

Как поставить ИИ-ассистента на свой сервер за 10 минут

Одна команда на сервере, мастер спрашивает модель и бота, и через несколько минут агент отвечает вам в Telegram. Рассказываем по шагам, что подготовить заранее и что делать, если что-то не пошло.

Свой сервер нужен, когда агент должен работать круглосуточно. Приложение на ноутбуке молчит, пока закрыта крышка, и расписание при этом не срабатывает. Служба на сервере отвечает всегда, а утренние сводки и напоминания приходят вовремя.

Ниже весь путь от пустого сервера до первого ответа. На него уходит около десяти минут, если всё нужное уже под рукой.

Что подготовить

  • Сервер. Ubuntu или Debian, процессор x86_64 или arm64, от 2 ГБ памяти. Нужен вход по SSH. Для расшифровки голосовых и записей звонков лучше 4 ГБ и 4 ядра.
  • Доступ к модели. Подписка ChatGPT (вход кодом с телефона, ключ не нужен) или ключ API: OpenRouter, DeepSeek, Anthropic, GigaChat, YandexGPT и другие. Подойдёт и своя модель на этой же машине.
  • Бот в Telegram. Напишите @BotFather, отправьте /newbot, придумайте имя и логин. BotFather пришлёт токен: длинную строку с двоеточием.
  • Ваш Telegram ID. Это число, по которому агент узнаёт владельца. Его пришлёт бот @userinfobot.

Открывать порты наружу не нужно: агент сам забирает сообщения у Telegram.

Установка

Зайдите на сервер по SSH. Если входите обычным пользователем, станьте root командой sudo -i. Права root не обязательны: без них программа ляжет в домашнюю папку, а служба будет пользовательской. Дальше одна команда:

bash
# на сервере, от root# curl -fsSL https://capyagent.ru/install.sh | sh

Установщик скачает готовую программу под ваш процессор, сверит контрольную сумму и сам откроет мастер настройки. Собирать ничего не нужно. Если не хотите запускать скрипт вслепую, сначала скачайте его и прочитайте.

Что отвечать мастеру

  1. Модель. Введите номер из списка или название: chatgpt, openrouter, deepseek. Для подписки ChatGPT мастер покажет ссылку и код: откройте её на телефоне и введите код. Ключ API вставьте и нажмите Enter. Мастер проверит, что модель отвечает, и только потом запишет настройки.
  2. Telegram. Вставьте токен бота (при вставке его не видно, так задумано) и свой Telegram ID.
  3. Служба. На вопрос о службе ответьте «да»: агент будет работать сам и поднимется после перезагрузки сервера.
  4. Голосовые и звонки. Если нужны голосовые и записи звонков, ответьте «да». Расшифровка идёт на вашем сервере, звук никуда не уходит.

Проверка

Дождитесь строки «Готово: агент работает службой» и напишите боту в Telegram «привет». Агент ответит. Дальше разговаривайте с ним обычными словами.

Если бот молчит, проверьте две вещи. Первая: пишете ли вы с того Telegram, чей ID вы указали в мастере. Чужой человек в бота не напишет, пока вы не впустите его. Вторая: что говорит диагностика.

bash
# проверить, что всё в порядке# /opt/capyagent/bin/capyagent doctor# журнал службы# journalctl -u capyagent -f

Первая команда покажет, что не так, и подскажет, что делать. Вторая выводит журнал службы.

Видеозапись установки

На сайте есть запись установки на чистом сервере Debian. Она идёт полторы минуты: долгие места в записи ускорены. Если хочется сначала посмотреть, как это выглядит, откройте страницу установки.

Что агент умеет сразу

После установки агент отвечает в Telegram и в веб-панели, помнит ваши разговоры, расшифровывает голосовые и записи звонков прямо на сервере, ставит напоминания и задачи по расписанию. Файлы большого размера он тоже принимает, если у сервера есть прямая связь с Telegram.

Всё, что даёт доступ к машине (команды, файлы, снимки экрана), после установки выключено. Вы включаете это сами. Опасное действие идёт только после одноразового «да» с названием действия. Если хотите, чтобы запросы к модели не покидали сервер, поставьте на ту же машину модель через Ollama или LM Studio. Какая модель потянет ваш сервер, зависит от его мощности.

Если сервер в России

Часть нейросетей и сам Telegram с российских серверов могут не открываться. Мастер заметит это и предложит выход: вставить ссылку подписки VPN+ или указать свой прокси. Агент поднимет VPN только для Telegram и модели, остальная машина работает как раньше. Подписка VPN+ продаётся отдельно. Второй путь: выбрать модель, которая работает из России, например GigaChat или YandexGPT.

Есть и ограничение по файлам. Файлы больше 20 МБ требуют прямой связи сервера с Telegram, а с серверов в России её обычно нет. На вопрос об этом можно ответить «нет», всё остальное работает.

Компьютер вместо сервера

Агент работает и на обычном компьютере, пока тот включён.

  • macOS. В Терминале выполните ту же команду. Права администратора не нужны.
  • Windows. В PowerShell (не от администратора) выполните: iwr -useb https://capyagent.ru/install.ps1 | iex.
  • Приложение с окном. Если не хочется терминала, скачайте приложение для macOS (Apple Silicon и Intel), Windows или Linux (AppImage, deb, rpm). Внутри тот же агент. Приложения не подписаны, поэтому система один раз спросит подтверждение при первом запуске.

Обновления и цена

Агент сам за обновлениями в сеть не ходит. Обновить его можно вручную, когда вы решите: перед обновлением он сохраняет прежнюю версию и данные, а при сбое возвращается назад.

Программа бесплатна, если вы ставите её себе или внутри своей компании. Вы платите за сервер, если он у вас платный, и за доступ к модели, если пользуетесь платной.

Если не хочется держать сервер

Для этого есть облако: отдельный сервер под вашего агента, который мы настраиваем по заявке. Он стоит 1 590 ₽ в месяц. Модель оплачивается отдельно её поставщику, около 2 000 ₽ в месяц, вместе около 3 600 ₽. Туннель к зарубежным моделям внутри нашего облака входит в цену. Онлайн-оплаты пока нет: мы отвечаем на заявку в течение рабочего дня и выставляем счёт.

Подробная инструкция со скриншотами и видеозаписью установки на чистом сервере лежит в разделе установка на сервер.

Связанное

Расскажите, что у вас теряется

Три строки, полминуты. Ответим в течение рабочего дня.