Pastukhov Agent — это личный ИИ-помощник, который работает над вашим проектом на компьютере или сервере: читает и изменяет файлы, выполняет команды, следит за качеством кода и ведёт с вами обычный чат. Он пригодится и разработчику, и владельцу бизнеса, который хочет самостоятельно вносить изменения в свой проект. Эта страница — с чего начать.
Сначала выберите способ установки — каждый удобен по-своему:
- Установка через Docker (рекомендуется) — Docker — это технология «контейнеров»: приложение запускается в изолированной среде, где уже есть все необходимые инструменты. Работает на Linux, macOS и Windows. Контейнер полностью отделён от остальной системы: агент не сможет случайно повредить ваш компьютер, а «сломанный» контейнер воссоздаётся за секунды. Инструкция по установке Docker
- Windows Docker Desktop — тот же Docker, но с графическим приложением Docker Desktop для Windows (на базе WSL 2). Удобно, если вы привыкли управлять программами мышью, а не командами. Инструкция по установке Windows Docker Desktop
- Mac Docker Desktop — то же самое для macOS (Intel и Apple Silicon): графическое управление Docker с полной изоляцией. Инструкция по установке Mac Docker Desktop
- Установка WSL — Docker на Windows через WSL (подсистема Windows для Linux) без отдельной программы Docker Desktop. Даёт ту же изоляцию и нативную производительность Linux на Windows 10 или 11. Инструкция по установке WSL
- Установка Windows — обычное приложение для Windows 10/11: устанавливается как программа, работает в браузере. Настройки задаются переменными окружения или параметрами запуска. Инструкция по установке Windows
Почему рекомендуем Docker даже на Windows: ИИ-модели лучше всего работают с Linux-инструментами, которые уже включены в контейнер, — на чистой Windows их пришлось бы устанавливать отдельно. Кроме того, контейнер полностью изолирован: модели не могут повредить основную систему, а среду для конкретной задачи легко пересоздать за секунды.
Любой способ установки даёт всё необходимое для работы. После установки нужно настроить модель и указать API-ключ вашего поставщика ИИ — об этом в разделе Настройка первой модели ниже.
Настройка учётных данных
Учётные данные — это ваш логин и пароль для входа в приложение, как в личный кабинет. Они задаются переменными окружения AGENT_LOGIN (логин) и AGENT_PASSWORD (пароль). Переменные окружения — это технические параметры запуска: вы прописываете их один раз в настройках (например, в файле docker-compose), и программа применяет их автоматически при каждом запуске.
Если переменные не заданы, приложение само сгенерирует временный пароль (логин — agent) и выведет его в консоль — окно, где работает программа. Такие учётные данные действуют до перезапуска приложения — удобно, чтобы просто попробовать программу. Полный список переменных — на странице Модели.
Установщик Windows
Программа установки настроит всё за вас: логин и пароль вы задаёте один раз при установке, и они сохраняются в системе. После установки приложение автоматически откроется в браузере с готовым демо-проектом. Если пропустить шаг с учётными данными, приложение выдаст временные и покажет их в окне консоли.
Docker
Задайте AGENT_LOGIN и AGENT_PASSWORD в файле docker-compose или файле .env. Пароль хранится в виде SHA256-хэша — это «отпечаток» пароля, по которому нельзя восстановить исходный текст: даже если файл настроек попадёт не в те руки, пароль останется в безопасности. На странице входа есть встроенный генератор такого отпечатка. Если переменные не заданы, приложение выдаст временные учётные данные в лог контейнера — смотрите их командой docker logs. Подробнее — в инструкции по установке Docker.
Ручная установка
Можно задать переменные окружения перед запуском, а можно просто запустить приложение и воспользоваться временными учётными данными из консоли. При задании пароля через переменную он должен быть SHA256-хэшем — используйте встроенный генератор на странице входа.
Когда вы входите с временными учётными данными, на странице входа появляется предупреждение. Чтобы сделать их постоянными, задайте переменные окружения и перезапустите приложение.
После входа вы получаете JWT-токен — «цифровой пропуск»: он поддерживает вашу сессию 90 дней, так что повторно входить каждый раз не придётся.
По умолчанию ключ подписи токенов генерируется автоматически и хранится во временной папке системы — для обычной работы этого достаточно. Для постоянного ключа задайте переменную JWT_SECRET_KEY (не менее 32 символов): тогда выданные «пропуски» останутся действительными между перезапусками приложения.
Главный интерфейс
После входа вы видите список чатов — главный экран, с которого начинается работа:
- Список чатов — здесь собраны все ваши разговоры. У каждого чата — заголовок и время последнего обновления. Если чатов ещё нет, вас встретит заметная кнопка Новый чат.
- Новый чат — каждая беседа независима и не делится контекстом с другими, поэтому можно работать над несколькими задачами одновременно и нигде не запутаться.
- Обновления в реальном времени — список чатов обновляется сам, через технологию SignalR: новые чаты и прогресс работы появляются на экране сразу, страницу перезагружать не нужно.
Список чатов запоминается браузером локально, поэтому при повторных визитах открывается мгновенно. Если он рассинхронизировался с базой данных — например, после удаления чатов из другого браузера, — нажмите кнопку обновления рядом с полем поиска чатов.
Нажмите на любой чат, чтобы открыть его. Внутри — общение с агентом; подробно об интерфейсе чата — в документации Чат.
Демо-проект (Windows)
В установщик Windows входит готовый демо-проект: на нём удобно посмотреть, как агент разрабатывает, собирает, проверяет и исправляет код. При первом запуске приложения вы увидите именно его.
Для установки через Docker или вручную укажите путь к вашему проекту переменной окружения AGENT_PROJECT_PATH. Pastukhov Agent работает с любой кодовой базой — просто укажите папку проекта и начинайте чат.
Демо-проект включает демо-навыки — готовые инструкции для агента, как выполнять типовые задачи. Они полезны сами по себе и служат шаблонами для ваших собственных навыков. Подробнее — в документации Навыки.
Pastukhov Agent работает в режиме одного проекта: один экземпляр — один проект. Экземпляры полностью изолированы, поэтому можно запускать несколько одновременно — на разных портах и для разных проектов.
Настройка первой модели
Прежде чем начать чат, нужно создать модель — набор настроек, который говорит агенту, какую нейросеть использовать и как к ней подключиться. Минимально — указать API-ключ: это секретный ключ доступа к нейросети, который выдаёт поставщик ИИ (компания, предоставляющая нейросети, — Anthropic, z.ai, OpenRouter и другие).
Быстрый способ: пока моделей нет, в области ввода сообщений появляется ссылка «создать модель» — диалог настройки откроется прямо там, где нужно, отдельно переходить на страницу «Модели» не обязательно.
Как создать первую модель:
- Нажмите Новая модель — на странице Модели в главном меню или по ссылке «создать модель» в области ввода сообщений
- Выберите поставщика ИИ из встроенного списка — Anthropic, z.ai, OpenRouter, xAI Grok, MiniMax, Kimi или «Своё»
- Выберите вариант модели (например, Claude Sonnet 4.6 или Claude Opus 4.7 для Anthropic) — модели отличаются качеством, скоростью и ценой
- Введите ваш API-ключ — все остальные параметры (название модели, адрес поставщика, цены) подставятся автоматически
Если вашего поставщика или модели нет в списке, возьмите любой существующий шаблон и поправьте параметры после создания, либо добавьте поставщика в файл .pastukhov/providers.yml проекта. Можно также связаться с нами — добавим его во встроенный список.
Какой поставщик выбрать: для интенсивной разработки (крупные программные продукты) удобнее всего z.ai (модели GLM) — там есть планы под активную работу. Для всего остального — включая повседневную работу с готовыми продуктами — оптимален DeepSeek с оплатой за фактические токены (доступен через шаблон OpenRouter). Если вы планируете и разрабатывать, и пользоваться готовым продуктом, заведите обе модели и переключайтесь под задачу.
После создания модели выберите её в селекторе моделей — выпадающий список рядом с полем ввода (он появляется, когда создана хотя бы одна модель). Можно создать несколько моделей для разных поставщиков и переключаться между ними в любой момент. Подробнее — в документации Модели.
Отправка первого сообщения
Начать разговор просто:
- Создайте чат — в списке чатов нажмите Новый чат.
- Введите сообщение — в поле ввода напишите вопрос или опишите задачу обычными словами. Поле поддерживает многострочный текст.
- Отправьте — нажмите Enter или кнопку отправки. Shift+Enter добавляет перенос строки без отправки.
- Следите за ответом — ответ появляется в реальном времени. Если агент читает файлы или выполняет действия, вы увидите это прямо в чате.
Совет: будьте конкретны. Вместо «Исправь баг» напишите «Форма входа не отправляется при нажатии кнопки. Помоги найти проблему». Чем больше контекста — тем точнее помощь.
Пока агент работает, заголовок страницы показывает текущую статистику: затраченное время, скорость обработки (токенов в секунду — токены это «единицы текста», за которые вы платите поставщику) и стоимость на текущий момент. Рядом появляется кнопка остановки — нажмите, чтобы прервать запрос в любой момент.
Нажмите на любое сообщение, чтобы увидеть его детали — какие файлы были прочитаны или изменены. Для правок показывается diff — наглядное сравнение «было/стало»: добавленные строки зелёным, удалённые красным. Наведите курсор на сообщение, чтобы увидеть статистику (время обработки, токены, стоимость) и кнопки: копировать сообщение или продолжить разговор с этого места — удобно для возобновления остановленного чата.
Все возможности чата — типы сообщений, выбор навыка, переключение моделей, очередь сообщений — описаны в документации Чат.
Работа с несколькими чатами
Каждый чат — самостоятельный разговор со своим контекстом: один можно посвятить отладке функции, другой — планированию нового проекта, третий — изучению части кода. Вот как этим пользоваться:
- Создание чатов — нажмите Новый чат в списке чатов. После первого сообщения агент сам придумает чату понятный заголовок.
- Переключение между чатами — вернитесь к списку чатов и выберите нужный. Каждый чат помнит весь разговор, поэтому вы продолжите ровно с того места, где остановились.
Рекомендация: заводите отдельный чат под каждую задачу или тему — так разговоры остаются сфокусированными, а нужную информацию легко найти. Например, один чат — «Обновление формы заказа», другой — «Настройка уведомлений по почте».
Что дальше?
Теперь, когда вы знакомы с основами, можно углубиться в возможности агента:
- Чат — типы сообщений, выбор навыка, переключение моделей, очередь сообщений и плавающая панель задач. Читать о чате
- Модели — несколько поставщиков ИИ, управление API-ключами, переключение между конфигурациями. Читать о моделях
- Файлы и проекты — как агент читает, редактирует и управляет файлами вашего проекта. Читать о файлах и проектах
- Сборка и развёртывание — автоматические проверки качества, управление запуском приложения. Читать о сборке и развёртывании
- Навыки — использование, создание и управление навыками, расширяющими возможности агента. Читать о навыках
- Настройки — карточный хаб: оформление, чат и звук, автоматизация, инструменты и конфигурация. Читать о настройках
Назад: Документация | Далее: Чат