インストールリファレンス
Tip
このページを読むべきタイミング:インストール方法(pip / uv / Docker / ErisPulse-App クライアント)を選ぶ必要があるときや、インストールに失敗してトラブルシューティングが必要なときに読んでください。とにかく最速で動かしたいだけなら、5分クイックスタート に最短の手順がまとめられているため、不要であればスキップしてください。
システム要件
- Python 3.10 – 3.14(3.14t のフリースレッド / GIL なしビルドは実験的なサポートであり、フレームワーク側では実験的な CI スモークテストにより継続的に監視していますが、正式な保証は行いません)
- pip または uv(推奨)
- 十分なディスク容量(最低 100MB)
インストール方法
方法 1: pip を使用したインストール
# ErisPulse のインストール
pip install ErisPulse
# 最新バージョンへのアップグレード
pip install ErisPulse --upgrade
方法 2: uv を使用したインストール(推奨)
uv はより高速な Python ツールチェーンであり、開発環境での使用が推奨されています。
uv のインストール
# pip を使用して uv をインストール
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 は独立したツール環境で動作し、プロジェクト環境を汚染しません。
# インストール(.venv をアクティブ化する必要なく、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実行環境とErisPulse SDKが内蔵されており、ターミナルや手動設定は不要です。
- GitHub Releases から、プラットフォームに応じてダウンロードを選択してください(Android
online/offlineAPK、Windowssetup.exe/zip、Linuxtar.gz、macOSzip) - App内でインスタンスを作成して起動し、ネイティブのインターフェースでアダプタとモジュールを管理し、モジュールストアを閲覧します
詳細な説明は、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 フリービルドは実験的サポートであり、正式な保証はありません)
pip installの代わりにuv pip install ErisPulseを試してください- 権限エラーが表示される場合は、
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 が含まれている場合、Debian/Ubuntu ではデフォルトで python3-venv がインストールされていないことが原因です(システムの Python では ensurepip が無効化されています):
sudo apt install python3.13-venv # 実際の Python バージョンに対応するパッケージをインストール
# または汎用メタパッケージをインストール:
sudo apt install python3-venv
インストール後、インストールスクリプトを再実行してください。最新のインストールスクリプトは、この問題を検出すると自動的に確認を行い、対応するシステムパッケージのインストールを試みます。また、uv を使用することもできます(uv venv は ensurepip に依存しません)。
次のステップ
- インストール後にプロジェクトを初期化し、アダプターをインストールする:5分クイックスタート に沿って残りの手順を完了しましょう
- 日常的にコマンドラインでコンポーネントを管理する:CLI コマンドリファレンス を参照
- トークンの設定やポートの調整:設定ファイルの説明 をご覧ください