Установка

Запустите VibeOS на своей машине. Данные и конфигурация хранятся в ~/.vibeos.

Поддержка платформ

Полную матрицу поддержки (ОС, способы установки и платформенные ограничения) смотрите в разделе Поддержка платформ.

Рекомендуется: Desktop (macOS / Windows)

1. Скачайте свежую сборку с vibeos.com.ru/download (Mac DMG или Windows Setup.exe).
2. macOS: откройте DMG и запустите Install VibeOS (копирует в Applications и снимает карантин Gatekeeper).
   Запасной путь: перетащите VibeOS в Applications, затем правый клик → Открыть → подтвердите.
   Windows: запустите установщик NSIS; если SmartScreen предупреждает — Подробнее → Выполнить в любом случае.
3. Запустите VibeOS. При первом старте Python-агент разворачивается в ~/.vibeos/vibeos-agent и создаётся virtualenv — для release-сборок ручной git clone не нужен.

Android: APK пока нет — используйте Termux и scripts/install.sh (есть и на странице скачивания).

Подробный гайд по macOS: Installing VibeOS on macOS в репозитории.

---

Командная строка / из исходников

Bootstrap (рекомендуется разработчикам)

git clone https://github.com/Linx72/VibeOS.git
cd vibeos
./scripts/bootstrap-vibeos.sh

Скрипт создаёт ~/.vibeos, ставит зависимости в venv и при возможности линкует CLI-команды vibeos.

Опционально: указать desktop-приложению на ваш clone

./scripts/link-agent-home.sh

Создаёт symlink ~/.vibeos/vibeos-agent → ваш checkout, чтобы упакованное приложение использовало локальный код.

После установки

source ~/.zshrc   # или ~/.bashrc
vibeos
vibeos doctor     # проверка окружения

Настройка провайдера и инструментов:

vibeos model          # Выбрать LLM-провайдера и модель
vibeos tools          # Включить / выключить инструменты
vibeos gateway setup  # Платформы обмена сообщениями
vibeos setup          # Полный мастер настройки

Имя CLI

Предпочитайте vibeos. В части документации и скриптов ещё встречается прежнее имя — на многих установках работают оба варианта.

---

Структура установки

Путь	Назначение
~/.vibeos/	Конфиг, .env (секреты), сессии, навыки, логи
~/.vibeos/vibeos-agent/	Checkout агента или symlink (bootstrap desktop)
~/.vibeos/config.yaml	Настройки без секретов
~/.vibeos/.env	Только API-ключи

Устаревшие домашние каталоги VibeOS (~/.vibeos) можно перенести в ~/.vibeos через встроенную миграцию (vibeos doctor / migrate-хелперы).

---

Предварительные требования (сборка из исходников)

• Git
• Python 3.11+ (bootstrap/uv может поставить управляемый интерпретатор)
• Node.js (UI desktop, браузерная автоматизация, WhatsApp-мост — по необходимости)
• На Linux для Playwright/Chromium: системные библиотеки (libnss3 и т.п.) или один раз playwright install-deps от администратора

Пользователям Nix

Поддержка Nix — best-effort. См. Nix и NixOS.

---

Ручная / developer-установка

Для контрибуции или запуска конкретной ветки см. Development Setup в руководстве по участию.

---

Устранение неполадок

Проблема	Решение
vibeos: command not found	Перезагрузите shell; убедитесь, что ~/.local/bin (или bin вашего venv) есть в PATH
API key not set	Запустите vibeos model или пропишите ключи в ~/.vibeos/.env
Нет конфига после обновления	vibeos config check, затем vibeos config migrate
Desktop не открывается (macOS)	Запустите Install VibeOS из DMG, или правый клик → Открыть, или xattr -cr /Applications/VibeOS.app

Диагностика: vibeos doctor — покажет, чего не хватает и как это исправить.

Обновления

См. Обновление и удаление. Пользователи desktop также могут поставить новую сборку с vibeos.com.ru/download.