Skip to main content

​
Установка и первый запуск

Эта страница описывает базовый путь: подготовить Велес, создать рабочую область, проверить CLI и запустить сервер для интерфейса Велеса и внешних каналов.

​
Что нужно понимать заранее

Для первого запуска важно знать три вещи:
  • CLI-команды veles пока сохраняют техническое имя старого исполняемого файла;
  • рабочая область хранит файлы, память и служебные данные Велеса;
  • графический интерфейс подключается к серверу Велеса и показывает чат, задачи, файлы, сессии и секреты.
Велес может работать и без графического интерфейса: через CLI или каналы вроде Telegram.

​
Быстрый старт Велеса

Создайте конфигурацию и рабочую область:
Команда создаёт:
  • ~/.veles/config.json — основной файл конфигурации;
  • ~/.veles/workspace — рабочую область Велеса;
  • шаблонные файлы инструкций и памяти.
Для интерактивной настройки используйте мастер:

​
Настройте модель

Минимально нужен хотя бы один LLM-провайдер и модель по умолчанию. Пример через OpenRouter:
Если вы используете локальную модель или OAuth-провайдера, смотрите Провайдеры и модели.

​
Проверьте CLI

Одно сообщение:
Если Велес ответил связным текстом — модель и провайдер настроены верно, можно двигаться дальше. Если появилась ошибка про ключ или модель, вернитесь к разделу «Настройте модель» и сверьтесь с Провайдеры и модели.
Интерактивный режим:
Выход из интерактивного режима: exit, quit, /exit, /quit, :q или Ctrl+D. Полезные параметры:

​
Запустите сервер

Сервер нужен для интерфейса Велеса, каналов, расписаний, периодических проверок и внутренних операций с рабочей областью.
Если в конфигурации не задан gateway.token, сервер не запустится. Токен нужен для авторизации интерфейса Велеса и внутренних клиентов. Вместо записи в config.json можно задать переменную окружения VELES_GATEWAY_TOKEN; она переопределит значение из файла конфигурации. Пример:
Проверьте, что сервер поднялся: curl http://127.0.0.1:18790/health должен ответить. Тот же токен указывается в интерфейсе Велеса для подключения. Если интерфейс пишет «не подключено» — см. Диагностику.

​
Несколько экземпляров

Для изоляции проектов, каналов или команд используйте отдельные файлы конфигурации и рабочие области:
Важно:
  • --config выбирает файл конфигурации и каталог служебных данных;
  • рабочая область обычно берётся из agents.defaults.workspace;
  • --workspace временно переопределяет рабочую область;
  • если несколько серверов работают одновременно, у них должны быть разные порты.

​
Docker

Базовый сценарий:
При ручном Docker-запуске монтируйте .veles, чтобы сохранить конфиг и рабочую область:

​
Systemd

Для постоянного Linux-запуска обычно создают user service, который вызывает:
Перед этим проверьте путь:

​
Что читать дальше