コンテンツにスキップ

RDEToolKitをインストールする方法

目的

このガイドでは、RDEToolKitをPython環境にインストールする手順を説明します。開発環境とプロダクション環境の両方に対応した複数のインストール方法を提供します。

前提条件

RDEToolKitをインストールする前に、以下の要件を満たしていることを確認してください:

  • Python: バージョン 3.9 以上
  • pip: 最新版を推奨
  • インターネット接続: PyPIからのパッケージダウンロードに必要

Python環境の確認

現在のPython環境を確認するには、以下のコマンドを実行してください:

1
2
python --version
pip --version

手順

1. 標準インストール

最も一般的なインストール方法です。PyPIからの安定版をインストールします。

terminal
1
pip install rdetoolkit
command_prompt
1
pip install rdetoolkit

2. MinIOサポート付きインストール

オブジェクトストレージ(MinIO)機能を使用する場合は、追加の依存関係をインストールします。

terminal
1
pip install rdetoolkit[minio]
command_prompt
1
pip install rdetoolkit[minio]

3. 開発版インストール

最新の開発版を使用する場合は、GitHubリポジトリから直接インストールします。

terminal
1
pip install git+https://github.com/nims-dpfc/rdetoolkit.git
command_prompt
1
pip install git+https://github.com/nims-dpfc/rdetoolkit.git

開発版の注意事項

開発版は不安定な場合があります。プロダクション環境では安定版の使用を推奨します。

4. 仮想環境でのインストール

プロジェクトごとに独立した環境を作成する場合の手順です。

terminal
1
2
3
4
5
6
7
8
9
# 仮想環境を作成
python -m venv rde_env

# 仮想環境を有効化
source rde_env/bin/activate  # Unix/macOS
# rde_env\Scripts\activate  # Windows

# RDEToolKitをインストール
pip install rdetoolkit
terminal
1
2
3
4
5
6
7
8
# 新しい環境を作成
conda create -n rde_env python=3.9

# 環境を有効化
conda activate rde_env

# RDEToolKitをインストール
pip install rdetoolkit

結果の確認

インストールが正常に完了したかを確認します。

インストール確認

python_console
1
2
import rdetoolkit
print(rdetoolkit.__version__)

期待される出力例:

1
1.2.3

基本機能テスト

test_installation.py
1
2
3
4
5
from rdetoolkit import workflows
from rdetoolkit.models.rde2types import RdeInputDirPaths, RdeOutputResourcePath

# 基本的なインポートが成功することを確認
print("RDEToolKit installation successful!")

トラブルシューティング

よくある問題と解決方法

権限エラー

1
ERROR: Could not install packages due to an EnvironmentError

解決方法: ユーザーレベルでインストールする

terminal
1
pip install --user rdetoolkit

依存関係の競合

1
ERROR: pip's dependency resolver does not currently take into account all the packages

解決方法: 仮想環境を使用する

terminal
1
2
3
python -m venv clean_env
source clean_env/bin/activate
pip install rdetoolkit

Python バージョン非対応

1
ERROR: Package 'rdetoolkit' requires a different Python

解決方法: Python 3.9以上にアップグレードする

サポート情報

インストールに関する問題が解決しない場合は、GitHubのIssuesで報告してください。

関連情報

インストール完了後の次のステップ: