Требования к системе¶

Перед установкой Р13.Орбита убедитесь, что ваша система соответствует следующим требованиям.

Операционная система¶

Р13.Орбита поддерживает следующие операционные системы:

• Linux (Debian 11+, Ubuntu 20.04+, CentOS 8+)
• macOS (11.0+)
• Windows (10/11 с WSL2)

ClickHouse¶

Р13.Орбита использует ClickHouse как аналитическое хранилище данных.

Версия¶

Требуется: ClickHouse 22.x+

Варианты установки¶

Вариант 1: Docker (рекомендуется для разработки)¶

docker run -d --name clickhouse \
  -p 8123:8123 \
  -p 9000:9000 \
  clickhouse/clickhouse-server:latest

Вариант 2: Нативная установка¶

sudo apt-get install -y apt-transport-https ca-certificates dirmngr
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 8919F6BD2B48D754
echo "deb https://packages.clickhouse.com/deb stable main" | sudo tee /etc/apt/sources.list.d/clickhouse.list
sudo apt-get update
sudo apt-get install -y clickhouse-server clickhouse-client
sudo service clickhouse-server start

brew install clickhouse
brew services start clickhouse

Проверка работоспособности¶

# Проверка HTTP интерфейса
curl http://localhost:8123
# Должен вернуть: Ok.

# Или через клиент
clickhouse-client --query "SELECT 1"
# Должен вернуть: 1

LLM Provider¶

Р13.Орбита требует доступ к провайдеру больших языковых моделей (LLM).

Поддерживаемые провайдеры¶

OpenAI-совместимое API (рекомендуется)¶

Что нужно:

• API ключ от вашего провайдера (например, OpenAI, Nebius AI Studio)
• Доступ к моделям GPT-4 или GPT-3.5-turbo (или аналогичным)

Стоимость: ~$0.03 за 1000 токенов (GPT-4)

Любые совместимые API:

• Nebius AI Studio (Token Factory) - рекомендуется
• Azure OpenAI
• Anthropic Claude
• Локальные прокси (vLLM, text-generation-webui)

Ollama (бесплатно, локально)¶

Что нужно:

• Установленный Ollama
• Минимум 8 GB RAM
• Скачанная модель (llama2, mistral и др.)

Установка:

# macOS/Linux
curl -fsSL https://ollama.com/install.sh | sh

# Скачать модель
ollama pull llama2

Плюсы: Бесплатно, приватность Минусы: Требует мощное железо, качество ниже GPT-4

GigaChat (Сбер)¶

Что нужно:

• Регистрация на developers.sber.ru
• API ключ GigaChat

Плюсы: Локализация, понимание русского языка Минусы: Требуется российская юрлицо/физлицо

База данных метаданных¶

Р13.Орбита хранит метаданные (чаты, датасеты, визуализации) в реляционной БД.

Поддерживаемые БД¶

PostgreSQL (рекомендуется для продакшн)¶

Версия: PostgreSQL 13+

Установка:

sudo apt install postgresql postgresql-contrib
sudo systemctl start postgresql

brew install postgresql@15
brew services start postgresql@15

docker run -d --name postgres \
  -e POSTGRES_PASSWORD=yourpassword \
  -p 5432:5432 \
  postgres:15

Опциональные компоненты¶

Следующие компоненты опциональны, но рекомендуются для полнофункциональной установки:

Keycloak (SSO аутентификация)¶

Версия: Keycloak 22+

Требуется только для мультипользовательского режима с SSO.

# Docker
docker run -d --name keycloak \
  -e KEYCLOAK_ADMIN=admin \
  -e KEYCLOAK_ADMIN_PASSWORD=admin \
  -p 8080:8080 \
  quay.io/keycloak/keycloak:22.0 start-dev

Системные ресурсы¶

Минимальные требования (для разработки)¶

• CPU: 2 cores
• RAM: 4 GB
• Диск: 10 GB свободного места

Рекомендуемые (для продакшн)¶

• CPU: 4+ cores
• RAM: 16 GB+
• Диск: 100 GB+ (SSD)

Для Ollama (локальный LLM)¶

• RAM: 16 GB+ (для моделей 7B параметров)
• RAM: 32 GB+ (для моделей 13B+ параметров)
• GPU: Опционально (ускоряет в 10-50 раз)

Сетевые требования¶

Порты¶

Убедитесь, что следующие порты доступны:

Firewall¶

Если используется firewall, разрешите входящие подключения на нужные порты:

# Ubuntu/Debian (ufw)
sudo ufw allow 8000/tcp
sudo ufw allow 8123/tcp

# CentOS/RHEL (firewalld)
sudo firewall-cmd --add-port=8000/tcp --permanent
sudo firewall-cmd --add-port=8123/tcp --permanent
sudo firewall-cmd --reload

Проверка готовности¶

Используйте этот чеклист перед установкой:

Базовые требования¶

• ClickHouse установлен и запущен
• Доступ к LLM API (OpenAI-совместимый, Ollama или другой)
• PostgreSQL доступен

Сетевые требования¶

• Порты 8000, 8123 свободны
• Firewall настроен (если используется)
• Интернет доступ для скачивания пакетов

Опциональные компоненты¶

• Keycloak установлен (для SSO)

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

После проверки всех требований переходите к Установке.

Если возникают проблемы, см. Решение проблем.