简体中文 English 繁體中文 日本語 Русский
本文为静态镜像，内容以交互版为准 在交互式文档中心打开 →

インストールの参考

本文はインストール方法の完全な参考（pip / uv / Docker / 問題解決）です。
すぐに起動したい場合は、5分で始めるが最も簡易な手順をカバーしています。

システム要件

インストール方法

方法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はプロジェクト環境を使用してロボットを実行します。フレームワーク本体はツール環境から提供され、両者は互いに干渉しません。

プロジェクトの初期化とモジュールのインストール

インストール後、プロジェクトの初期化、モジュールのインストール、実行の完全な手順は、5分間のクイックスタートをご覧ください。

方法3：ErisPulse-Appクライアントの使用（ターミナル不要）

Python環境をインストールしたくないですか？ErisPulse-App は公式の全プラットフォーム対応クライアントです（Android / Windows / Linux / macOS）。スマートフォンで直接実行でき、デスクトップ版はシステムトレイに最小化して常時バックグラウンドで実行可能です。内部にPythonランタイムとErisPulse SDKを内蔵しており、ターミナルや手動の設定は不要です。

詳細な説明は、ErisPulse-Appのインストールと使用方法をご覧ください。

インストールの確認

インストールの確認

# ErisPulse のバージョンを確認
epsdk --version

テストの実行

# プロジェクトを実行
epsdk run main.py

上記のような出力が表示された場合、インストールが正常に完了しています。

[INFO] ErisPulse の初期化を開始しています...
[INFO] アダプタをロードしました: Yunhu
[INFO] モジュールをロードしました: MyModule
[INFO] ErisPulse の初期化が完了しました

よくある質問

インストール失敗

  1. Python のバージョンが 3.10 以上であるか確認してください（推奨バージョンは 3.10 - 3.14。3.14t free-threaded は GIL なしビルドで、現時点では正式サポート対象外です。フレームワークは実験的な CI スモークテストにより継続的に監視しています）
  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 venv（ensurepip に依存しない）を使用することもできます。

次のステップ