Установка и запуск «Снег и ком»

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

• ОС: Debian/Ubuntu/Kali (рекомендуется) или Windows 10/11
• RAM: от 2 ГБ (для комфорта 4+ ГБ)
• Свободное место: от 5 ГБ (SSD)
• Python: 3.8–3.12
• PostgreSQL: 13+

Для сборки Python-пакетов на Linux нужны build-essential, python3-dev, libpq-dev.

Установка: Debian/Ubuntu/Kali

1. Обновите систему и поставьте базовые пакеты:

   sudo apt update && sudo apt -y upgrade sudo apt -y install python3 python3-venv python3-pip git build-essential python3-dev libpq-dev

2. Установите PostgreSQL и включите автозапуск:

   sudo apt -y install postgresql postgresql-contrib sudo systemctl enable postgresql sudo systemctl start postgresql

3. Клонируйте проект и перейдите в каталог:

   git clone https://github.com/your-company/snegikom.git cd snegikom

4. Создайте и активируйте виртуальное окружение:

   python3 -m venv venv source venv/bin/activate

5. Установите зависимости проекта (см. раздел ниже, если появятся ошибки сборки):

   pip install --upgrade pip pip install -r requirements.txt

Установка: Windows 10/11

1. Установите PostgreSQL (pgAdmin/psql) и создайте пользователя/БД (см. раздел про БД ниже).
2. Поставьте Python 3.10+ с опцией Add Python to PATH, затем Git.
3. Клонируйте проект, создайте и активируйте venv:

   git clone https://github.com/your-company/snegikom.git cd snegikom python -m venv venv venv\Scripts\activate

4. Установите зависимости:

   python -m pip install --upgrade pip pip install -r requirements.txt

Переменные окружения (.env)

Создайте файл .env в корне проекта со значениями под ваш сервер:

DB_HOST=localhost DB_PORT=5432 DB_NAME=snowcom_db DB_USER=snowcom_user DB_PASS=ТвойСекретныйПароль ADDONS_PATH=snegikom/addons,addons LOG_LEVEL=info PORT=8069

Путь к аддонам можно расширять через запятую. LOG_LEVEL: debug|info|warning|error.

Установка модулей и паков

─(㉿kali)-[~/Рабочий стол/СНЕГ И КОМ/snegikom/addons] └─$ unzip module_xyz.zip -d addons/

PostgreSQL: пользователь и база данных

На Linux создайте пользователя и БД (замените пароль на свой):

sudo -u postgres createuser --createdb --pwprompt snowcom_user # Введите пароль, например: StrongPass123 sudo -u postgres createdb --owner=snowcom_user snowcom_db

Если используете Windows — создайте пользователя и БД через pgAdmin или psql по аналогии.

Python-зависимости: частые проблемы

• Ошибки компиляции на Linux — убедитесь, что установлены build-essential, python3-dev, libpq-dev.
• На Windows убедитесь, что стоит Desktop development with C++ (Build Tools) или MSVC — для пакетов, требующих сборки.
• Повторная установка зависимостей: pip install --upgrade pip && pip install -r requirements.txt.

Запуск (точно в указанном порядке)

1) Создать и активировать виртуальное окружение

─(devil㉿kali)-[~/Рабочий стол/СНЕГ И КОМ] └─$ python3 -m venv venv source venv/bin/activate

2) Установить зависимости из requirements.txt

pip install -r requirements.txt - устанавливаем зависимости

3) Запустить сервис PostgreSQL

┌──(venv)─(devil㉿kali)-[~/Рабочий стол/СНЕГ И КОМИК - базовая итоговая версия/snegikom] └─$ sudo systemctl start postgresql [sudo] пароль для devil:

4) Старт «Снег и ком» с путями к аддонам и уровнем логов

┌──(venv)─(devil㉿kali)-[~/Рабочий стол/СНЕГ И КОМИК - базовая итоговая версия/snegikom] └─$ ./snegikom-bin --addons-path=snegikom/addons,addons --log-level=info

5) Открыть интерфейс в браузере и выбрать/создать базу:

открыть по адресу http://localhost:8069/web/database/selector

FAQ / Быстрое устранение ошибок

• Не запускается Postgres: проверь sudo systemctl status postgresql, порт 5432 доступен? ss -lntp | grep 5432
• Нет подключения к БД: проверь DB_HOST/DB_PORT/DB_NAME/DB_USER/DB_PASS, права пользователя и что сервис запущен.
• Пакеты не ставятся: обнови pip и установи системные dev-пакеты (см. раздел «Python-зависимости»).