Installation for Windows JP

Windows へのインストール

MoleditPy は Python 3.9 〜 3.14 に対応しています（requires-python = ">=3.9, <3.15"）。Python 3.9 の場合のみ PyQt6 が <6.10 に固定されます（それ以外の対応バージョンは <6.12）。これは pip が自動的に解決するため、自分でバージョンを指定する必要はありません。

Python を使うのが初めての場合: python --version（または python3 --version）が動かないときは、先に Python と pip のインストール を済ませてください。

Windows でのインストール方法は2通りサポートされています。

• 推奨: moleditpy-installer — moleditpy パッケージのインストールに加えて、スタートメニュー/デスクトップのショートカット作成と .pmeprj ファイル関連付けの登録を行えます。下記の 方法 A を参照してください。
• Conda 環境を使う方法 — 手動で管理する環境です。依存関係のバージョンを厳密に固定したい場合や、すでに Conda を使っている場合に有用です。方法 B を参照してください。

---

方法 A: moleditpy-installer（推奨）

1. Python パッケージのインストール

   ターミナル（PowerShell、コマンドプロンプト、または Conda Prompt）を開いて実行します。

   pip install moleditpy-installer

   これにより moleditpy パッケージ（Windows/macOS 向けビルド）が依存関係として自動的にインストールされます。

2. インストーラーの実行

   moleditpy-installer

   対話的なターミナルではTUIが開き、インストールする構成要素（デスクトップショートカット、アプリケーションメニュー項目、.pmeprj ファイル関連付け）とスコープ（ユーザー単位またはシステム全体）を選んで Install を押します。既定値は、デスクトップショートカットオフ、スタートメニュー項目オン、ファイル関連付けオン、ユーザー単位スコープです。

   スクリプトからの非対話的なインストールでは、明示的なフラグを指定して TUI を回避します。

   moleditpy-installer --no-tui        # 既定値でインストール
   moleditpy-installer --desktop       # デスクトップショートカットも作成
   # 管理者として実行したプロンプトから、システム全体にインストールする場合:
   moleditpy-installer --system

3. 起動

   moleditpy

4. アップグレード

   pip install --upgrade moleditpy moleditpy-installer

5. アンインストール

   moleditpy-installer --uninstall
   pip uninstall moleditpy

   moleditpy-installer --uninstall が削除するのはショートカットとファイル関連付けだけです。アプリケーション本体は pip uninstall moleditpy で削除します。

オプションの一覧（--check、--version、--help）は moleditpy-installer の README を、ショートカットとファイル関連付けを手動で設定したい場合は Shortcut (Windows) を参照してください。

---

方法 B: Conda 環境

この手順は、開発環境と必要なライブラリのバージョンをできるだけ忠実に再現することで、GUI アプリケーションで問題になりがちなライブラリの互換性を確保することを狙ったものです。

前提条件

• Anaconda または Miniconda が PC にインストールされていること。

ステップ 1: 新しい Conda 環境の作成と有効化

まず、moleditpy 専用のクリーンな仮想環境を作成します。

1. Conda Prompt を開く
   Windows のスタートメニューから「Anaconda Prompt」または「Miniconda Prompt」を探して起動します。

2. 新しい環境を作成する
   対応する Python のバージョン（例: 3.12）を指定して、moleditpy-env という名前の環境を作成します。

   conda create -n moleditpy-env python=3.12

   • Proceed ([y]/n)? と尋ねられたら、y を入力して Enter を押します。

3. 作成した環境を有効化する
   これ以降の操作はすべてこの新しい環境の中で行います。

   conda activate moleditpy-env

   コマンドプロンプトの行頭が (moleditpy-env) で始まることを確認してください。

ステップ 2: moleditpy のインストール

必要な依存関係が揃ったら、pip で moleditpy 本体をインストールします。

1. pip で moleditpy をインストールする
   有効化した conda 環境で以下を実行します。

   pip install moleditpy

   互換性が確認済みの特定のバージョンを入れたい場合は、次のコマンドを実行してください。

   pip install numpy==2.3.3 openbabel-wheel==3.1.1.22 PyQt6==6.9.1 QtPy==2.4.3 rdkit==2025.3.6 vtk==9.5.2 pyvista==0.46.3 pyvistaqt==0.11.3 moleditpy

ステップ 3: moleditpy の起動

インストールが完了したら、GUI アプリケーションとして moleditpy を起動します。初回起動には時間がかかることがあります。

1. 起動コマンドを実行する
   （moleditpy-env を有効化した）コマンドプロンプトで以下を実行します。

   moleditpy

   moleditpy の GUI ウィンドウが表示されれば、環境構築は成功です。インストールされたバージョンは moleditpy --version で確認できます。

アップグレードとアンインストール（Conda の方法）

conda activate moleditpy-env
pip install --upgrade moleditpy

環境ごと削除する場合（moleditpy と固定したすべての依存関係も一緒に削除されます）。

conda deactivate
conda env remove -n moleditpy-env

この環境の中で moleditpy-installer を実行してショートカットやファイル関連付けを作成した場合は、先に moleditpy-installer --uninstall を実行してください。アンインストールコマンドの実行には moleditpy-installer がパス上で解決できる必要があるためです。

関連ページ

• Shortcut (Windows) — ショートカットとファイル関連付けを手動で作成する
• Installation for macOS / Linux / with Docker
• Troubleshooting Common Issues