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

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

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

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

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

Python¶

Версия¶

Требуется: Python 3.11+

Проверьте версию:

python --version
# или
python3 --version

Должно вывести: Python 3.11.x или выше.

Установка Python 3.11+¶

sudo apt update
sudo apt install python3.11 python3.11-venv python3-pip

sudo dnf install python3.11 python3.11-pip

brew install python@3.11

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
• Доступ к моделям GPT-4 или GPT-3.5-turbo

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

OpenAI-Compatible API¶

Любые совместимые 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

SQLite (для разработки/тестирования)¶

Встроен в Python, дополнительная установка не требуется.

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

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

Redis (кэширование, rate limiting)¶

Версия: Redis 6+

# Docker
docker run -d --name redis -p 6379:6379 redis:7-alpine

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

Мониторинг (Prometheus, Grafana, Jaeger)¶

Опционально для production мониторинга.

См. Инфраструктура для деталей.

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

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

• 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

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

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

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

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

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

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

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

• Redis установлен (для кэширования)
• Keycloak установлен (для SSO)
• Мониторинг стек готов (для продакшн)

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

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

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