ErisPulse ErisPulse
Открыть интерактивную версию →
Разделы страницы
Статическое зеркало — интерактивная версия является основной Открыть интерактивную версию →

Справочник по установке

Tip

Когда нужно читать эту статью: если вам нужно выбрать способ установки (pip / uv / Docker / клиентское приложение ErisPulse-App) или если установка не удалась и требуется устранение неполадок. Если вы хотите просто быстро запустить, 5-минутный старт уже охватывает самый простой процесс, и эту статью можно пропустить.

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

  • Python 3.10 – 3.14 (свободный поток 3.14t / сборка без GIL поддерживается экспериментально, фреймворк находится под экспериментальным мониторингом CI-смокинга, без официальных гарантий)
  • pip или uv (рекомендуется)
  • Достаточное количество места на диске (не менее 100 МБ)

Способы установки

Способ 1: Установка с помощью pip

# Установка ErisPulse
pip install ErisPulse

# Обновление до последней версии
pip install ErisPulse --upgrade

Способ 2: Установка с помощью uv (рекомендуется)

uv — это более быстрая инструментальная цепочка для Python, рекомендуемая для среды разработки.

Установка uv

# Установка uv с помощью pip
pip install uv

# Проверка установки
uv --version

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

# Создание директории проекта
mkdir my_bot && cd my_bot

# Установка Python 3.12
uv python install 3.12

# Создание виртуального окружения
uv venv

Активация виртуального окружения

# Windows
.venv\Scripts\activate

# Linux/Mac
source .venv/bin/activate

Установка ErisPulse

# Установка ErisPulse
uv pip install ErisPulse --upgrade

Способ 3: Установка с помощью uv tool (глобальный CLI, рекомендуется)

Если вы хотите использовать epsdk как глобальный командную строку, uv tool install — самый чистый способ: epsdk работает в независимой среде инструментов, не загрязняя никакую проектную среду:

# Установка (epsdk сразу доступен, без необходимости активации виртуального окружения)
uv tool install ErisPulse

# Обновление (или просто используйте epsdk self-update, который автоматически использует этот канал)
uv tool upgrade ErisPulse

Note

epsdk в среде инструментов автоматически распознает .venv проекта при запуске в директории проекта: epsdk install установит компоненты в проектное окружение, epsdk run запустит бота с использованием проектного окружения, сам фреймворк по-прежнему предоставляется средой инструментов, и обе среды не влияют друг на друга.

В меню однокомандного скрипта установки (get.erisdev.com/install.sh / install.ps1) также доступен способ установки «глобальный CLI (uv tool)», который автоматически установит uv и проведет вас через процесс.

Инициализация проекта и установка модулей

После установки полный процесс инициализации проекта, установки модулей и запуска описан в 5 минут к быстрому старту.

Способ 4: Использование клиентского приложения ErisPulse-App (без терминала)

Не хотите устанавливать среду Python? ErisPulse-App — это официальное клиентское приложение для всех платформ (Android / Windows / Linux / macOS), которое можно запускать прямо с телефона, а настольная версия поддерживает сворачивание в системную панель для постоянной фоновой работы; включает в себя встроенный интерпретатор Python и SDK ErisPulse, не требуя терминала и ручной настройки:

  • Скачайте нужную версию с GitHub Releases в зависимости от вашей платформы (для Android — online/offline APK, для Windows — setup.exe/zip, для Linux — tar.gz, для macOS — zip)
  • Создайте и запустите экземпляр в приложении, управляйте адаптерами и модулями через родной интерфейс, просматривайте каталог модулей

Подробное руководство см. в разделе Установка и использование ErisPulse-App.

Проверка установки

Проверка установки

# Проверка версии ErisPulse
epsdk --version

Запуск теста

# Запуск проекта
epsdk run main.py

Если вы видите подобный вывод, значит установка прошла успешно:

[INFO] Инициализация ErisPulse...
[INFO] Загружен адаптер: Yunhu
[INFO] Загружен модуль: MyModule
[INFO] Инициализация ErisPulse завершена

Часто задаваемые вопросы

Ошибка установки

  1. Проверьте, входит ли версия Python в поддерживаемый диапазон (поддерживается 3.10 – 3.14; экспериментальная поддержка 3.14t с свободным потоком / без GIL не гарантируется).
  2. Попробуйте использовать uv pip install ErisPulse вместо pip install.
  3. Если возникает ошибка прав, попробуйте pip install --user ErisPulse или используйте виртуальное окружение.
  4. Если SSL-ошибка сертификата возникает в корпоративной среде с прокси, попробуйте pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org ErisPulse.
  5. Убедитесь, что сетевое подключение работает и доступен репозиторий pip.

Ошибка конфигурации

  1. Проверьте синтаксис config.toml (TOML-формат чувствителен к отступам и кавычкам).
  2. Убедитесь, что все необходимые параметры конфигурации заполнены.
  3. Просмотрите логи терминала для получения подробной информации об ошибке.
  4. Используйте epsdk init, чтобы пересоздать конфигурационный файл.

Ошибка установки модуля

  1. Убедитесь, что имя модуля написано правильно (регистр важен).
  2. Проверьте сетевое подключение.
  3. Используйте epsdk list-remote, чтобы просмотреть список доступных модулей.
  4. Убедитесь, что модуль совместим с текущей версией SDK.

Стратегия выполнения Windows PowerShell

Если PowerShell выводит сообщение «Невозможно загрузить файл... так как выполнение скриптов запрещено на этой системе»:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Ошибка создания виртуального окружения в Debian/Ubuntu

Если скрипт установки сообщает о «неудаче создания виртуального окружения» и ошибка содержит ensurepip is not available, это связано с тем, что python3-venv не установлен по умолчанию в Debian/Ubuntu (системный ensurepip для Python отключен):

sudo apt install python3.13-venv   # Установите пакет, соответствующий вашей версии Python
# Или установите универсальный метапакет:
sudo apt install python3-venv

После установки перезапустите скрипт установки. Новые версии скриптов установки при обнаружении этой проблемы спрашивают пользователя и могут автоматически установить соответствующий системный пакет; также можно использовать uv (так как uv venv не зависит от ensurepip).

Далее