ErisPulse ErisPulse
インタラクティブ版で開く →
このページのセクション
静的ミラーです。内容はインタラクティブ版が正となります インタラクティブ版で開く →

インストールリファレンス

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/offline APK、Windows setup.exe/zip、Linux tar.gz、macOS zip)
  • App内でインスタンスを作成して起動し、ネイティブのインターフェースでアダプタとモジュールを管理し、モジュールストアを閲覧します

詳細な説明は、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. pip install の代わりに uv pip install ErisPulse を試してください
  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 が含まれている場合、Debian/Ubuntu ではデフォルトで python3-venv がインストールされていないことが原因です(システムの Python では ensurepip が無効化されています):

sudo apt install python3.13-venv   # 実際の Python バージョンに対応するパッケージをインストール
# または汎用メタパッケージをインストール:
sudo apt install python3-venv

インストール後、インストールスクリプトを再実行してください。最新のインストールスクリプトは、この問題を検出すると自動的に確認を行い、対応するシステムパッケージのインストールを試みます。また、uv を使用することもできます(uv venv は ensurepip に依存しません)。

次のステップ