Быстрый старт

От нуля до рабочей установки VibeOS: поставить, выбрать провайдера, проверить чат и знать, что делать, если что-то сломалось.

Предпочитаете видео?

Обзоры upstream по-прежнему полезны для общего ядра агента. Для установки и пакетов именно VibeOS смотрите README репозитория и vibeos.com.ru/download.

Для кого это руководство

Вы только начинаете и хотите самый короткий путь к рабочей установке
Меняете провайдера и не хотите терять время на ошибки конфигурации
Настраиваете VibeOS для команды, бота или постоянно работающего процесса
Устали от состояния «установилось, но всё равно ничего не делает»

Самый быстрый путь

Выберите строку под свою цель:

Цель	Сначала	Затем
Просто хочу, чтобы VibeOS заработал на машине	`vibeos setup`	Запустите реальный чат и убедитесь, что агент отвечает
Уже знаю своего провайдера	`vibeos model`	Сохраните конфигурацию и начните диалог
Нужен бот или always-on установка	После рабочего CLI — `vibeos gateway setup`	Подключите Telegram, Discord, Slack или другую платформу
Нужна локальная или self-hosted модель	`vibeos model` → custom endpoint	Проверьте endpoint, имя модели и длину контекста
Нужен fallback между несколькими провайдерами	Сначала `vibeos model`	Routing и fallback — только после рабочего базового чата

Правило: пока обычный чат не проходит, новые функции не подключайте. Сначала один чистый диалог — потом gateway, cron, skills, voice или routing.

1. Установите VibeOS

Через установщик VibeOS Desktop на macOS (рекомендуется)

Скачайте свежую DMG / VibeOS.app с vibeos.com.ru/download и запустите. Данные лежат в ~/.vibeos.

Из исходников (CLI + опциональный desktop)

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

Без desktop (curl-установщик)

На checkout предпочтительнее bootstrap выше. В части гайдов ещё встречается:

curl -fsSL https://vibeos.com.ru/downloads/install.sh | bash

Полное руководство по установке — с примечаниями по платформам.

Android / Termux

На телефоне смотрите отдельное руководство по Termux: проверенный ручной путь, поддерживаемые extras и текущие ограничения Android.

После shell-установки перезагрузите shell:

source ~/.bashrc   # или source ~/.zshrc

Варианты установки, зависимости и troubleshooting — в руководстве по установке.

2. Выберите провайдера

Это самый важный шаг настройки. Пройдите выбор интерактивно:

vibeos model

Самый простой путь: Nous Portal

Одна подписка покрывает 300+ моделей плюс Tool Gateway (web search, генерация изображений, TTS, облачный браузер). На свежей установке:

vibeos setup --portal

Команда авторизует вас, выставит Nous как провайдера и включит Tool Gateway за один запуск.

Режимы setup

На свежей установке vibeos setup предлагает три режима:

Quick Setup (Nous Portal) — бесплатный OAuth, без API-ключей; настраивает модель и инструменты Tool Gateway. Рекомендуемый быстрый путь.
Full Setup — вы сами проходите каждого провайдера, инструмент и опцию (со своими ключами).
Blank Slate — всё выключено, кроме минимума для запуска агента: провайдер и модель, toolset File Operations и Terminal. Нет web, browser, code execution, vision, memory, delegation, cron, skills, plugins и MCP; compression, checkpoints, smart routing и memory capture тоже выключены. После минимальной базы выберите: оставить всё выключенным (закончить с минимальным агентом) или пройти все настройки (tools, skills, plugins, MCP и messaging). Берите этот режим, если нужен полностью контролируемый минимум и вы хотите включать только необходимое.

Blank Slate записывает явный список platform_toolsets.cli и agent.disabled_toolsets, поэтому невыбранное не загрузится — даже после vibeos update. Позже можно включить что угодно через vibeos tools, добавить стартовые skills через vibeos skills opt-in --sync или донастроить через vibeos setup agent.

Хорошие значения по умолчанию:

Провайдер	Что это	Как настроить
Nous Portal	Подписка, zero-config	OAuth login через `vibeos model`
OpenAI Codex	ChatGPT OAuth, использует Codex models	Device code auth через `vibeos model`
Anthropic	Claude models напрямую — Max plan + дополнительные usage credits (OAuth) или API key для pay-per-token	`vibeos model` → OAuth login (требует Max + extra credits) или Anthropic API key
OpenRouter	Multi-provider routing по множеству моделей	Введите API key
Z.AI	GLM / модели, размещённые Zhipu	Задайте `GLM_API_KEY` / `ZAI_API_KEY` (также принимает `Z_AI_API_KEY`)
Kimi / Moonshot	Coding и chat models от Moonshot	Задайте `KIMI_API_KEY` (или Kimi-Coding-specific `KIMI_CODING_API_KEY`)
Kimi / Moonshot China	Endpoint Moonshot для China-region	Задайте `KIMI_CN_API_KEY`
Arcee AI	Trinity models	Задайте `ARCEEAI_API_KEY`
GMI Cloud	Multi-model direct API	Задайте `GMI_API_KEY`
MiniMax (OAuth)	Frontier model MiniMax через browser OAuth — API key не нужен (имя модели в `vibeos_cli/models.py` может меняться между релизами)	`vibeos model` → MiniMax (OAuth)
MiniMax	Международный endpoint MiniMax	Задайте `MINIMAX_API_KEY`
MiniMax China	Endpoint MiniMax для China-region	Задайте `MINIMAX_CN_API_KEY`
Alibaba Cloud	Qwen models через DashScope	Задайте `DASHSCOPE_API_KEY` (Qwen Coding Plan также принимает `ALIBABA_CODING_PLAN_API_KEY`)
Hugging Face	20+ open models через unified router (Qwen, DeepSeek, Kimi и др.)	Задайте `HF_TOKEN`
AWS Bedrock	Claude, Nova, Llama, DeepSeek через native Converse API	IAM role или `aws configure` (guide)
Azure Foundry	Модели, размещённые в Azure AI Foundry	Задайте `AZURE_FOUNDRY_API_KEY` + `AZURE_FOUNDRY_BASE_URL`
Google AI Studio	Gemini models через direct API	Задайте `GOOGLE_API_KEY` / `GEMINI_API_KEY`
xAI	Grok models через direct API	Задайте `XAI_API_KEY`
xAI Grok OAuth	Подписка SuperGrok / Premium+, API key не нужен	`vibeos model` → xAI Grok OAuth
NovitaAI	Multi-model API gateway	Задайте `NOVITA_API_KEY`
StepFun	Step Plan models	Задайте `STEPFUN_API_KEY`
Xiaomi MiMo	Модели, размещённые Xiaomi	Задайте `XIAOMI_API_KEY`
Tencent TokenHub	Модели, размещённые Tencent	Задайте `TOKENHUB_API_KEY`
Ollama Cloud	Managed Ollama-hosted models	Задайте `OLLAMA_API_KEY`
LM Studio	Локальное desktop app с OpenAI-compatible API	Задайте `LM_API_KEY` (и `LM_BASE_URL`, если не default)
Qwen OAuth	Qwen Portal browser OAuth — API key не нужен	`vibeos model` → Qwen OAuth
Kilo Code	Модели, размещённые KiloCode	Задайте `KILOCODE_API_KEY`
OpenCode Zen	Pay-as-you-go доступ к curated models	Задайте `OPENCODE_ZEN_API_KEY`
OpenCode Go	Подписка $10/month на open models	Задайте `OPENCODE_GO_API_KEY`
DeepSeek	Прямой доступ к DeepSeek API	Задайте `DEEPSEEK_API_KEY`
NVIDIA NIM	Nemotron models через build.nvidia.com или local NIM	Задайте `NVIDIA_API_KEY` (опционально: `NVIDIA_BASE_URL`)
GitHub Copilot	Подписка GitHub Copilot (GPT-5.x, Claude, Gemini и др.)	OAuth через `vibeos model` или `COPILOT_GITHUB_TOKEN` / `GH_TOKEN`
GitHub Copilot ACP	Copilot ACP agent backend (запускает локальный `copilot` CLI)	`vibeos model` (требует `copilot` CLI + `copilot login`)
Custom Endpoint	VLLM, SGLang, Ollama или любой OpenAI-compatible API	Задайте base URL + API key

Для большинства новых пользователей: выберите провайдера и принимайте значения по умолчанию, если нет явной причины их менять. Полный каталог с env vars и шагами настройки — на странице Провайдеры.

Минимальный контекст: 64K tokens

VibeOS требует модель с окном не менее 64 000 tokens. Меньшее окно не тянет многошаговые tool-calling сценарии и будет отклонено при запуске. Большинство hosted-моделей (Claude, GPT, Gemini, Qwen, DeepSeek) это условие закрывают. Для local model выставьте context size минимум 64K (например, --ctx-size 65536 для llama.cpp или -c 65536 для Ollama).

подсказка

Провайдера можно сменить в любой момент через vibeos model — без lock-in. Полный список и детали настройки: AI Providers.

Как хранятся настройки

VibeOS разделяет секреты и обычную конфигурацию:

Секреты и токены → ~/.vibeos/.env
Остальные настройки → ~/.vibeos/config.yaml

Проще всего задавать значения через CLI:

vibeos config set model anthropic/claude-opus-4.6
vibeos config set terminal.backend docker
vibeos config set OPENROUTER_API_KEY sk-or-...

Значение само попадёт в нужный файл.

3. Запустите первый чат

vibeos            # классический CLI
vibeos --tui      # современный TUI (рекомендуется)

Появится баннер с моделью, доступными tools и skills. Дайте конкретный, легко проверяемый запрос:

Выберите интерфейс

У VibeOS два терминальных интерфейса: классический CLI на prompt_toolkit и более новый TUI с модальными окнами, выделением мышью и non-blocking вводом. Sessions, slash-команды и config общие — попробуйте vibeos и vibeos --tui.

Summarize this repo in 5 bullets and tell me what the main entrypoint is.

Check my current directory and tell me what looks like the main project file.

Help me set up a clean GitHub PR workflow for this codebase.

Признаки успеха:

В баннере видны выбранные модель и провайдер
VibeOS отвечает без ошибок
При необходимости вызывается tool (terminal, чтение файла, web search)
Диалог нормально идёт дальше одного хода

Если это работает — самая сложная часть позади.

4. Проверьте, что сессии работают

Перед следующим шагом убедитесь, что resume живой:

vibeos --continue    # возобновить последнюю сессию
vibeos -c            # короткий вариант

Вы должны вернуться к только что начатой сессии. Если нет — проверьте активный profile и то, сохранилась ли session. Это важно позже при нескольких setup или машинах.

5. Попробуйте ключевые функции

Используйте terminal

❯ What's my disk usage? Show the top 5 largest directories.

Агент запускает команды терминала от вашего имени и показывает результат.

Slash commands

Введите /, чтобы увидеть autocomplete dropdown со всеми commands:

Command	Что делает
`/help`	Показать все доступные commands
`/tools`	Список доступных tools
`/model`	Интерактивно переключить models
`/personality pirate`	Попробовать забавную personality
`/save`	Сохранить conversation

Многострочный ввод

Нажмите Alt+Enter, Ctrl+J или Shift+Enter, чтобы добавить новую строку. Shift+Enter требует terminal, который отправляет его как отдельную sequence (Kitty / foot / WezTerm / Ghostty по умолчанию; iTerm2 / Alacritty / VS Code terminal после включения Kitty keyboard protocol). Alt+Enter и Ctrl+J работают в любом terminal.

Прервать агента

Если агент слишком долго выполняет задачу, введите новое сообщение и нажмите Enter — это прервёт текущую задачу и переключит его на новые инструкции. Ctrl+C тоже работает.

6. Добавьте следующий слой

Только после того, как базовый чат работает. Выберите то, что нужно:

Бот или общий ассистент

vibeos gateway setup    # Interactive platform configuration

Подключите Telegram, Discord, Slack, WhatsApp, Signal, Email, Home Assistant или Microsoft Teams.

Automation and tools

vibeos tools — настройка доступа к tools по platform
vibeos skills — просмотр и установка reusable workflows
Cron — только после того, как bot или CLI setup стабилен

Sandboxed terminal

Для безопасности запускайте агента в Docker container или на remote server:

vibeos config set terminal.backend docker    # Docker isolation
vibeos config set terminal.backend ssh       # Remote server

Voice mode

# From the VibeOS install directory (the curl installer placed it at
# ~/.vibeos/vibeos-agent on Linux/macOS or %LOCALAPPDATA%\vibeos\vibeos-agent on Windows):
cd ~/.vibeos/vibeos-agent
uv pip install -e ".[voice]"
# Includes faster-whisper for free local speech-to-text

Затем в CLI: /voice on. Нажмите Ctrl+B, чтобы записывать. См. Voice Mode.

Skills

Skills — это instruction documents по требованию, которые учат VibeOS выполнять конкретную задачу: deploy to Kubernetes, открыть GitHub PR, fine-tune a model, искать GIFs. Каждый skill — файл SKILL.md с name, description и пошаговой procedure. Агент бесплатно читает короткие descriptions и загружает полный content skill только тогда, когда задача действительно этого требует, поэтому добавление skills не раздувает каждый request.

VibeOS поставляется с каталогом bundled skills, уже установленным в ~/.vibeos/skills/. Вы можете добавить больше из Skills Hub или написать свои.

Просмотр и установка из hub:

vibeos skills browse                      # list everything available
vibeos skills search kubernetes           # find skills by keyword
vibeos skills install openai/skills/k8s   # install one (runs a security scan first)

Аргумент установки — slug source/path из hub: openai/skills/k8s означает skill k8s из каталога OpenAI. vibeos skills browse показывает точные slugs.

Использовать skill — каждый установленный skill автоматически становится slash command:

/k8s deploy the staging manifest          # run the skill with a request
/k8s                                       # load it and let VibeOS ask what you need

Это работает в CLI и на любой подключённой messaging platform. Не нужно устанавливать всё заранее — агент сам выбирает подходящий bundled skill в обычном диалоге, когда задача совпадает.

См. Skills System, чтобы узнать, как писать свои skills, использовать external skill directories и полный список hub sources.

MCP servers

# Add to ~/.vibeos/config.yaml
mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

Editor integration (ACP)

ACP support поставляется со стандартными extras [all], поэтому curl installer уже включает его. Просто выполните:

vibeos acp

(Если вы установили без [all], сначала выполните cd ~/.vibeos/vibeos-agent && uv pip install -e ".[acp]".)

См. ACP Editor Integration.

Частые сбои

Вот проблемы, которые чаще всего отнимают время:

Симптом	Вероятная причина	Исправление
VibeOS открывается, но даёт пустые или сломанные ответы	Неверная provider auth или выбор модели	Снова запустите `vibeos model` и проверьте provider, model и auth
Custom endpoint "работает", но возвращает мусор	Неверный base URL, model name или endpoint на самом деле не OpenAI-compatible	Сначала проверьте endpoint в отдельном client
Gateway запускается, но ему никто не может писать	Bot token, allowlist или platform setup неполные	Повторно запустите `vibeos gateway setup` и проверьте `vibeos gateway status`
`vibeos --continue` не находит старую session	Вы переключили profiles или session не сохранилась	Проверьте `vibeos sessions list` и убедитесь, что вы в правильном profile
Model unavailable или странное fallback behavior	Provider routing или fallback settings слишком агрессивны	Держите routing выключенным, пока базовый provider не стабилен
`vibeos doctor` сообщает о проблемах config	Config values отсутствуют или устарели	Исправьте config и повторно проверьте обычный chat перед добавлением features

Recovery Toolkit

Когда что-то выглядит неправильно, используйте такой порядок:

vibeos doctor
vibeos model
vibeos setup
vibeos sessions list
vibeos --continue
vibeos gateway status

Эта последовательность быстро возвращает вас от "broken vibes" к известному состоянию.

Quick Reference

Command	Description
`vibeos`	Начать чат
`vibeos model`	Выбрать LLM provider и model
`vibeos tools`	Настроить, какие tools включены для каждой platform
`vibeos setup`	Полный setup wizard (настраивает всё сразу)
`vibeos doctor`	Диагностика проблем
`vibeos update`	Обновить до latest version
`vibeos gateway`	Запустить messaging gateway
`vibeos --continue`	Возобновить последнюю session

Следующие шаги

CLI Guide — освоить terminal interface
Configuration — настроить setup под себя
Messaging Gateway — подключить Telegram, Discord, Slack, WhatsApp, Signal, Email, Home Assistant, Teams и другие
Tools & Toolsets — изучить доступные capabilities
AI Providers — полный список providers и details настройки
Skills System — reusable workflows and knowledge
Tips & Best Practices — советы для power users

sidebar_position: 1 title: "Быстрый старт" description: "Первый разговор с VibeOS — от установки до чата примерно за 5 минут"

Быстрый старт

Это руководство проводит от нуля до рабочей установки VibeOS. Установите, выберите провайдера, проверьте чат и узнайте, что делать, если что-то ломается.

Предпочитаете смотреть?

Upstream-обзоры по общему ядру агента всё ещё полезны. Для установки и упаковки именно VibeOS смотрите README репозитория и vibeos.com.ru/download.

Для кого это

Вы новичок и хотите самый короткий путь к рабочей конфигурации
Меняете провайдера и не хотите терять время на ошибки конфигурации
Настраиваете VibeOS для команды, бота или постоянно работающего сценария
Устали от ситуации «установилось, но ничего не происходит»

Самый быстрый путь

Выберите строку под вашу цель:

Цель	Сначала сделайте	Затем
Просто хочу, чтобы VibeOS работал на машине	`vibeos setup`	Запустите реальный чат и убедитесь, что есть ответ
Уже знаю провайдера	`vibeos model`	Сохраните конфиг и начните чат
Нужен бот или always-on	После рабочего CLI — `vibeos gateway setup`	Подключите Telegram, Discord, Slack или другую платформу
Локальная или self-hosted модель	`vibeos model` → custom endpoint	Проверьте endpoint, имя модели и длину контекста
Fallback между провайдерами	Сначала `vibeos model`	Добавляйте routing/fallback только после стабильного базового чата

Правило: если VibeOS не может завершить обычный чат, не добавляйте новые функции. Сначала добейтесь одного чистого диалога, затем наращивайте gateway, cron, skills, голос или routing.

1. Установите VibeOS

Через установщик VibeOS Desktop на macOS (рекомендуется)

Скачайте свежий DMG / VibeOS.app с vibeos.com.ru/download и запустите. Данные лежат в ~/.vibeos.

Из исходников (CLI + опциональный десктоп)

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

Без десктопа (curl-установщик)

Предпочтительнее bootstrap из checkout выше. В некоторых гайдах ещё показывают:

curl -fsSL https://vibeos.com.ru/downloads/install.sh | bash

Полные заметки по платформам — в руководстве по установке.

Android / Termux

Если ставите на телефон, смотрите отдельный гайд по Termux: проверенный ручной путь, поддерживаемые дополнения и текущие ограничения Android.

После установки из shell перезагрузите оболочку:

source ~/.bashrc   # or source ~/.zshrc

Подробные варианты установки, требования и troubleshooting — в руководстве по установке.

2. Выберите провайдера

Mattermost шаг настройки. Интерактивно пройдите выбор через vibeos model:

vibeos model

Самый простой путь: Nous Portal

Одна подписка покрывает 300+ моделей плюс Tool Gateway (веб-поиск, генерация изображений, TTS, облачный браузер). На свежей установке:

vibeos setup --portal

Команда выполнит вход, выставит Nous как провайдера и включит Tool Gateway.

Режимы setup

На свежей установке vibeos setup предлагает три режима:

Quick Setup (Nous Portal) — бесплатный OAuth, без API-ключей; настраивает модель и инструменты Tool Gateway. Рекомендуемый быстрый путь.
Full Setup — самостоятельно пройти все провайдеры, инструменты и опции (свои ключи).
Blank Slate — почти всё выключено, кроме минимума для агента: провайдер и модель, toolset File Operations и Terminal. Без web, browser, code execution, vision, memory, delegation, cron, skills, plugins и MCP; compression, checkpoints, smart routing и memory capture тоже выключены. После базовой настройки выберите: оставить всё выключенным или пройти все конфигурации. Удобно, когда нужен минимальный контролируемый агент.

Blank Slate пишет явный список platform_toolsets.cli и agent.disabled_toolsets, поэтому ничего лишнего не подгрузится даже после vibeos update. Позже включайте через vibeos tools, skills — vibeos skills opt-in --sync, настройки агента — vibeos setup agent.

Хорошие значения по умолчанию:

Провайдер	Что это	Как настроить
Nous Portal	Подписка, почти без конфигурации	OAuth через `vibeos model`
OpenAI Codex	ChatGPT OAuth, модели Codex	Device code через `vibeos model`
Anthropic	Claude напрямую — Max + extra credits (OAuth) или API-ключ	`vibeos model` → OAuth или ключ Anthropic
OpenRouter	Маршрутизация ко многим моделям	Введите API-ключ
Z.AI	Модели GLM / Zhipu	`GLM_API_KEY` / `ZAI_API_KEY` (также `Z_AI_API_KEY`)
Kimi / Moonshot	Coding и chat модели Moonshot	`KIMI_API_KEY` (или `KIMI_CODING_API_KEY`)
Kimi / Moonshot China	Endpoint для региона Китая	`KIMI_CN_API_KEY`
Arcee AI	Модели Trinity	`ARCEEAI_API_KEY`
GMI Cloud	Прямой multi-model API	`GMI_API_KEY`
MiniMax (OAuth)	Frontier MiniMax через браузерный OAuth — без API-ключа	`vibeos model` → MiniMax (OAuth)
MiniMax	Международный endpoint MiniMax	`MINIMAX_API_KEY`
MiniMax China	Китайский endpoint MiniMax	`MINIMAX_CN_API_KEY`
Alibaba Cloud	Qwen через DashScope	`DASHSCOPE_API_KEY` (для Coding Plan также `ALIBABA_CODING_PLAN_API_KEY`)
Hugging Face	20+ open-моделей через единый роутер	`HF_TOKEN`
AWS Bedrock	Claude, Nova, Llama, DeepSeek через Converse API	IAM role или `aws configure` (гайд)
Azure Foundry	Модели Azure AI Foundry	`AZURE_FOUNDRY_API_KEY` + `AZURE_FOUNDRY_BASE_URL`
Google AI Studio	Gemini через прямой API	`GOOGLE_API_KEY` / `GEMINI_API_KEY`
xAI	Grok через прямой API	`XAI_API_KEY`
xAI Grok OAuth	SuperGrok / Premium+, без API-ключа	`vibeos model` → xAI Grok OAuth
NovitaAI	Multi-model API gateway	`NOVITA_API_KEY`
StepFun	Модели Step Plan	`STEPFUN_API_KEY`
Xiaomi MiMo	Модели Xiaomi	`XIAOMI_API_KEY`
Tencent TokenHub	Модели Tencent	`TOKENHUB_API_KEY`
Ollama Cloud	Управляемые модели Ollama	`OLLAMA_API_KEY`
LM Studio	Локальное desktop-приложение с OpenAI-compatible API	`LM_API_KEY` (и `LM_BASE_URL` при необходимости)
Qwen OAuth	OAuth портала Qwen — без API-ключа	`vibeos model` → Qwen OAuth
Kilo Code	Модели KiloCode	`KILOCODE_API_KEY`
OpenCode Zen	Pay-as-you-go к курируемым моделям	`OPENCODE_ZEN_API_KEY`
OpenCode Go	Подписка $10/мес на open-модели	`OPENCODE_GO_API_KEY`
DeepSeek	Прямой API DeepSeek	`DEEPSEEK_API_KEY`
NVIDIA NIM	Nemotron через build.nvidia.com или локальный NIM	`NVIDIA_API_KEY` (опционально `NVIDIA_BASE_URL`)
GitHub Copilot	Подписка Copilot (GPT-5.x, Claude, Gemini и др.)	OAuth через `vibeos model`, или `COPILOT_GITHUB_TOKEN` / `GH_TOKEN`
GitHub Copilot ACP	Бэкенд Copilot ACP (локальный `copilot` CLI)	`vibeos model` (нужны `copilot` CLI + `copilot login`)
Custom Endpoint	VLLM, SGLang, Ollama или любой OpenAI-compatible API	Base URL + API-ключ

Для большинства новичков: выберите провайдера и примите значения по умолчанию, если нет причины менять их. Полный каталог — на странице Providers.

Минимум контекста: 64K токенов

VibeOS требует модель с контекстом не меньше 64 000 токенов. Модели с меньшим окном отвергаются при старте. Большинство hosted-моделей (Claude, GPT, Gemini, Qwen, DeepSeek) проходят легко. Для локальной модели выставьте контекст ≥ 64K (например --ctx-size 65536 для llama.cpp или -c 65536 для Ollama).

подсказка

Провайдера можно сменить в любой момент через vibeos model — без vendor lock-in. Полный список — в AI Providers.

Как хранятся настройки

VibeOS разделяет секреты и обычную конфигурацию:

Секреты и токены → ~/.vibeos/.env
Несекретные настройки → ~/.vibeos/config.yaml

Проще всего задавать значения через CLI:

vibeos config set model anthropic/claude-opus-4.6
vibeos config set terminal.backend docker
vibeos config set OPENROUTER_API_KEY sk-or-...

Нужное значение автоматически попадёт в нужный файл.

3. Первый чат

vibeos            # classic CLI
vibeos --tui      # modern TUI (recommended)

Вы увидите баннер с моделью, доступными инструментами и навыками. Используйте конкретный и проверяемый промпт:

Выберите интерфейс

У VibeOS два терминальных интерфейса: классический CLI на prompt_toolkit и новый TUI с модальными оверлеями, выделением мышью и неблокирующим вводом. Сессии, slash-команды и конфиг общие — сравните vibeos и vibeos --tui.

Summarize this repo in 5 bullets and tell me what the main entrypoint is.

Check my current directory and tell me what looks like the main project file.

Help me set up a clean GitHub PR workflow for this codebase.

Признаки успеха:

В баннере видны выбранные модель/провайдер
VibeOS отвечает без ошибки
При необходимости использует инструмент (terminal, чтение файла, web search)
Диалог продолжается больше одного хода

Если это работает — самое сложное уже позади.

4. Проверьте сессии

Перед следующим шагом убедитесь, что resume работает:

vibeos --continue    # Resume the most recent session
vibeos -c            # Short form

Должна открыться только что созданная сессия. Если нет — проверьте профиль и факт сохранения сессии. Это важно при нескольких установках или машинах.

5. Попробуйте ключевые возможности

Терминал

❯ What's my disk usage? Show the top 5 largest directories.

Агент выполняет команды от вашего имени и показывает результат.

Slash-команды

Введите /, чтобы увидеть автодополнение:

Команда	Что делает
`/help`	Показать все команды
`/tools`	Список инструментов
`/model`	Интерактивно сменить модель
`/personality pirate`	Попробовать личность
`/save`	Сохранить разговор

Многострочный ввод

Alt+Enter, Ctrl+J или Shift+Enter добавляют новую строку. Shift+Enter требует терминал с отдельной последовательностью (Kitty / foot / WezTerm / Ghostty по умолчанию; iTerm2 / Alacritty / VS Code — с протоколом Kitty keyboard). Alt+Enter и Ctrl+J работают везде.

Прервать агента

Если агент слишком долго думает, введите новое сообщение и нажмите Enter — текущая задача прервётся. Также работает Ctrl+C.

6. Следующий слой

Только после рабочего базового чата. Выберите нужное:

Бот или общий ассистент

vibeos gateway setup    # Interactive platform configuration

Подключите Telegram, Discord, Slack, WhatsApp, Signal, Email, Home Assistant или Microsoft Teams.

Автоматизация и инструменты

vibeos tools — доступ к инструментам по платформам
vibeos skills — просмотр и установка переиспользуемых workflow
Cron — только после стабильного бота или CLI

Изолированный терминал

Для безопасности запускайте агента в Docker или на удалённом сервере:

vibeos config set terminal.backend docker    # Docker isolation
vibeos config set terminal.backend ssh       # Remote server

Голосовой режим

# From the VibeOS install directory (the curl installer placed it at
# ~/.vibeos/vibeos-agent on Linux/macOS or %LOCALAPPDATA%\vibeos\vibeos-agent on Windows):
cd ~/.vibeos/vibeos-agent
uv pip install -e ".[voice]"
# Includes faster-whisper for free local speech-to-text

Затем в CLI: /voice on. Запись — Ctrl+B. См. Voice Mode.

Навыки (Skills)

Skills — это документы-инструкции по требованию: как задеплоить в Kubernetes, открыть PR, дообучить модель, искать GIF. Каждый — файл SKILL.md с именем, описанием и процедурой. Агент бесплатно видит короткие описания и загружает полный текст только когда задача этого требует.

В ~/.vibeos/skills/ уже есть встроенный каталог. Можно добавить навыки из Skills Hub или написать свои.

Обзор и установка из хаба:

vibeos skills browse                      # list everything available
vibeos skills search kubernetes           # find skills by keyword
vibeos skills install openai/skills/k8s   # install one (runs a security scan first)

Аргумент установки — slug source/path из хаба. Точные slug показывает vibeos skills browse.

Использование — каждый установленный skill становится slash-командой:

/k8s deploy the staging manifest          # run the skill with a request
/k8s                                       # load it and let VibeOS ask what you need

Работает в CLI и во всех подключённых мессенджерах. Не обязательно ставить всё заранее — агент сам подхватывает подходящий bundled skill.

Подробнее — Skills System.

MCP-серверы

# Add to ~/.vibeos/config.yaml
mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

Интеграция с редактором (ACP)

ACP входит в стандартные extras [all], curl-установщик уже включает его. Запуск:

vibeos acp

(Если ставили без [all]: cd ~/.vibeos/vibeos-agent && uv pip install -e ".[acp]".)

См. ACP Editor Integration.

Типичные сбои

Симптом	Вероятная причина	Исправление
VibeOS открывается, но ответы пустые/битые	Неверная auth или модель	Снова `vibeos model`, проверьте провайдера, модель и auth
Custom endpoint «работает», но мусор	Неверный base URL / имя модели / не OpenAI-compatible	Проверьте endpoint отдельным клиентом
Gateway стартует, но писать нельзя	Токен бота, allowlist или настройка платформы	`vibeos gateway setup` и `vibeos gateway status`
`vibeos --continue` не находит сессию	Сменили профиль или сессия не сохранилась	`vibeos sessions list` и нужный профиль
Модель недоступна / странный fallback	Слишком агрессивный routing/fallback	Отключите routing, пока базовый провайдер нестабилен
`vibeos doctor` ругается на конфиг	Пропущенные или устаревшие значения	Исправьте конфиг, проверьте простой чат до новых фич

Набор для восстановления

Когда что-то «не то», идите по порядку:

vibeos doctor
vibeos model
vibeos setup
vibeos sessions list
vibeos --continue
vibeos gateway status

Эта последовательность быстро возвращает к известному состоянию.

Краткая справка

Команда	Описание
`vibeos`	Начать чат
`vibeos model`	Выбрать LLM-провайдера и модель
`vibeos tools`	Какие инструменты включены на платформах
`vibeos setup`	Полный мастер настройки
`vibeos doctor`	Диагностика
`vibeos update`	Обновить до последней версии
`vibeos gateway`	Запустить messaging-шлюз
`vibeos --continue`	Продолжить последнюю сессию

Что дальше

CLI Guide — терминальный интерфейс
Configuration — настройка под себя
Messaging Gateway — Telegram, Discord, Slack, WhatsApp, Signal, Email, Home Assistant, Teams и др.
Tools & Toolsets — доступные возможности
AI Providers — полный список провайдеров
Skills System — переиспользуемые workflow
Tips & Best Practices — советы для опытных пользователей

Предпочитаете видео?​

Для кого это руководство​

Самый быстрый путь​

1. Установите VibeOS​

Через установщик VibeOS Desktop на macOS (рекомендуется)​

Из исходников (CLI + опциональный desktop)​

Без desktop (curl-установщик)​

2. Выберите провайдера​

Как хранятся настройки​

3. Запустите первый чат​

4. Проверьте, что сессии работают​

5. Попробуйте ключевые функции​

Используйте terminal​

Slash commands​

Многострочный ввод​

Прервать агента​

6. Добавьте следующий слой​

Бот или общий ассистент​

Automation and tools​

Sandboxed terminal​

Voice mode​

Skills​

MCP servers​

Editor integration (ACP)​

Частые сбои​

Recovery Toolkit​

Quick Reference​

Следующие шаги​

sidebar_position: 1 title: "Быстрый старт" description: "Первый разговор с VibeOS — от установки до чата примерно за 5 минут"​

Быстрый старт

Предпочитаете смотреть?​

Для кого это​

Самый быстрый путь​

1. Установите VibeOS​

Через установщик VibeOS Desktop на macOS (рекомендуется)​

Из исходников (CLI + опциональный десктоп)​

Без десктопа (curl-установщик)​

2. Выберите провайдера​

Как хранятся настройки​

3. Первый чат​

4. Проверьте сессии​

5. Попробуйте ключевые возможности​

Терминал​

Slash-команды​

Многострочный ввод​

Прервать агента​

6. Следующий слой​

Бот или общий ассистент​

Автоматизация и инструменты​

Изолированный терминал​

Голосовой режим​

Навыки (Skills)​

MCP-серверы​

Интеграция с редактором (ACP)​

Типичные сбои​

Набор для восстановления​

Краткая справка​

Что дальше​

Предпочитаете видео?

Для кого это руководство

Самый быстрый путь

1. Установите VibeOS

Через установщик VibeOS Desktop на macOS (рекомендуется)

Из исходников (CLI + опциональный desktop)

Без desktop (curl-установщик)

2. Выберите провайдера

Как хранятся настройки

3. Запустите первый чат

4. Проверьте, что сессии работают

5. Попробуйте ключевые функции

Используйте terminal

Slash commands

Многострочный ввод

Прервать агента

6. Добавьте следующий слой

Бот или общий ассистент

Automation and tools

Sandboxed terminal

Voice mode

Skills

MCP servers

Editor integration (ACP)

Частые сбои

Recovery Toolkit

Quick Reference

Следующие шаги

sidebar_position: 1 title: "Быстрый старт" description: "Первый разговор с VibeOS — от установки до чата примерно за 5 минут"

Предпочитаете смотреть?

Для кого это

Самый быстрый путь

1. Установите VibeOS

Через установщик VibeOS Desktop на macOS (рекомендуется)

Из исходников (CLI + опциональный десктоп)

Без десктопа (curl-установщик)

2. Выберите провайдера

Как хранятся настройки

3. Первый чат

4. Проверьте сессии

5. Попробуйте ключевые возможности

Терминал

Slash-команды

Многострочный ввод

Прервать агента

6. Следующий слой

Бот или общий ассистент

Автоматизация и инструменты

Изолированный терминал

Голосовой режим

Навыки (Skills)

MCP-серверы

Интеграция с редактором (ACP)

Типичные сбои

Набор для восстановления

Краткая справка

Что дальше