# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17

УСТАНОВКА BACH
=================


ОПИСАНИЕ
============
Инструкция по первоначальной установке BACH. BACH — это персональная агентная ОС,
который работает локально и управляет моделями ИИ.


ТРЕБОВАНИЯ
===============
- Python >= 3.10
- npm (для сервера MCP)
-> 100 МБ свободной памяти
- Необязательно: OneDrive (для синхронизации между несколькими системами).
- Необязательно: Tailscale (для удаленного доступа к серверу)


БЫСТРЫЙ СТАРТ
============
# 1. Клонировать репозиторий
клон git https://github.com/ellmos-ai/bach.git
cd bach

# 2. Проверьте требования
bach setup preflight

# 3. Завершите установку
bach setup full-install

# 4. Запустите первый сеанс
bach --startup


ШАГИ ПОЛНОЙ УСТАНОВКИ
=====================
"bach setup full-install" автоматически выполнит следующие шаги:

1. Предполетная проверка Python, npm, памяти, прав на запись
2. Настройте ProSync для одной или нескольких систем (по умолчанию: одна)
3. Сервер MCP ellmos-codecommander-mcp, ellmos-filecommander-mcp
4. Хуки Claude Code для защиты БД и другие хуки в ~/.claude/
5. Инициализируйте секреты ~/.bach/bach_secrets.json
6. Персонализируйте профиль пользователя USER.md и синхронизируйте его с БД.
7. Язык (необязательно). Установите язык системы и переключите документы.
8. Справочные документы (необязательно). Создайте файлы справки для выбранного языка (резервный вариант EN).
9. Окончательная проверка всех компонентов

Необязательно: --with-n8n для n8n-Manager-MCP, --lang <код> для выбора языка (de/en/es/ru/ja/zh),
--config <json> для пакетной конфигурации.


СЦЕНАРИИ ИСПОЛЬЗОВАНИЯ
=================
BACH имеет установку. После установки параметры конфигурации решают
о сценарии развертывания.

Одна система (по умолчанию)
-----------------------
BACH работает на одном компьютере, синхронизация не требуется.

  bach setup full-install
  # ProSync остается деактивированным (по умолчанию)

Мультисистема с OneDrive
-------------------------
BACH находится в OneDrive и используется на нескольких компьютерах.
Каждая система имеет локальную базу данных (~/.bach/bach.db), которая находится через
ProSync синхронизирован.

  bach setup full-install
  bach setup prosync --multi-system
  # Синхронизация: синхронизация БД bach (вручную) или автоматически при запуске/выходе

Сервер (Headless)
-----------------
BACH запускается на сервере (например, Mac Studio, Linux-сервере) и
Удаленное управление через Telegram, веб-интерфейс или системный трей.

  bach setup full-install
  # Затем активируйте коннекторы:
  # - Telegram-бот:hub/_services/chat/telegram_chat.py
  # — Веб-интерфейс: gui/server.py --host 0.0.0.0
  # - Системный трей:hub/_services/chat/chat_tray.py --port 8081
  # - Чат CLI:hub/_services/chat/buddha_cli.py

Для многосистемных серверов дополнительно:
  bach setup prosync --multi-system


ПОСЛЕ УСТАНОВКИ
=====================
bach setup check           Проверка установки
bach --startup             Начать первый сеанс
bach --help                Использовать справочную систему
bach --help setup          Показать параметры настройки


ФАЙЛЫ
=======
hub/setup.py Обработчик установки (логика установщика)
data/bach.db База данных BACH (создается во время установки)
Профиль пользователя ../USER.md (шаблон -> персонализированный)
~/.bach/bach_secrets.json Хранилище секретов
~/.claude/settings.json Обработчики кода Claude


СМ. ТАКЖЕ
==========
docs/help/setup.txt Обработчики установки (все операции)
docs/help/check.txt Проверка после установки
docs/help/db_sync.txt ProSync: синхронизация мультисистемной базы данных
docs/help/startup.txt Начать сеанс
