Контроль и ключи остаются у вас
CLI, orchestration, safety policy и отчёты запускаются в вашем окружении. Подходит для первого знакомства и личной работы.
Установить LocalПЕРВЫЙ УПРАВЛЯЕМЫЙ RUN
Запустите VOLY локально
Установите control plane, подключите один провайдер и сначала выполните задачу в dry-run. Изменения откатятся, а diff и отчёт останутся для проверки.
До первого отчёта≈ 10 минут
Python3.10–3.14
СистемаmacOS · Linux · WSL
НужноGit + ключ провайдера
ВЫБЕРИТЕ КОНТУР
Локально сейчас или Cloud для команды
Общий контур без ручной настройки
Организация, участники, hosted runs и общая история расходов доступны в командном dashboard.
Открыть CloudLOCAL · 4 ШАГА
От клонирования до проверенного результата
Выполняйте команды по порядку из каталога, где хотите хранить исходный код VOLY.
01
Получить код
Клонируйте репозиторий
Создайте отдельное виртуальное окружение, чтобы зависимости VOLY не смешивались с проектами.
git clone https://github.com/voly-codes/voly.git
cd voly
python3 -m venv .venv && source .venv/bin/activate
Терминал находится в активном окружении .venv.
02
Установить
Подключите CLI и Web UI
Editable-установка удобна для обновления ядра и включает зависимости локального dashboard.
pip install -e ".[ui,dev]"
voly --help
Команда voly доступна в текущем терминале.
03
Настроить
Добавьте ключ и создайте конфигурацию
Скопируйте пример окружения, укажите хотя бы один API key и создайте voly.yaml. Файл .env защищён от записи агентами по умолчанию.
cp .env.example .env
# добавьте ключ в .env, затем:
voly init && voly status
Status показывает доступный executor или provider.
04
Проверить безопасно
Выполните первый dry-run
Укажите тестовый репозиторий. Агент выполнит задачу, но VOLY откатит запись файлов и сохранит diff в отчёте.
voly run "проверь README и предложи одно улучшение" --cwd ~/my-project --dry-run
Репозиторий не изменён; результат, файлы и dry-run diff сохранены.
ПОСЛЕ RUN
Проверьте доказательства, а не только ответ
Откройте последний run в CLI или запустите локальный dashboard на порту 7788.
voly runs list
voly runs show <task_id>
voly ui