Справочник по установке
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/offlineAPK, для 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 завершена
Часто задаваемые вопросы
Ошибка установки
- Проверьте, входит ли версия Python в поддерживаемый диапазон (поддерживается 3.10 – 3.14; экспериментальная поддержка 3.14t с свободным потоком / без GIL не гарантируется).
- Попробуйте использовать
uv pip install ErisPulseвместоpip install. - Если возникает ошибка прав, попробуйте
pip install --user ErisPulseили используйте виртуальное окружение. - Если SSL-ошибка сертификата возникает в корпоративной среде с прокси, попробуйте
pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org ErisPulse. - Убедитесь, что сетевое подключение работает и доступен репозиторий pip.
Ошибка конфигурации
- Проверьте синтаксис
config.toml(TOML-формат чувствителен к отступам и кавычкам). - Убедитесь, что все необходимые параметры конфигурации заполнены.
- Просмотрите логи терминала для получения подробной информации об ошибке.
- Используйте
epsdk init, чтобы пересоздать конфигурационный файл.
Ошибка установки модуля
- Убедитесь, что имя модуля написано правильно (регистр важен).
- Проверьте сетевое подключение.
- Используйте
epsdk list-remote, чтобы просмотреть список доступных модулей. - Убедитесь, что модуль совместим с текущей версией 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).
Далее
- Инициализация проекта и установка адаптеров после установки: следуйте инструкциям в 5-минутном руководстве, чтобы завершить оставшиеся шаги
- Управление компонентами через командную строку в повседневной работе: см. Справочник по командам CLI
- Для заполнения токенов и настройки портов: ознакомьтесь с описанием конфигурационного файла