Quick Start JP

クイックスタート: MoleditPy のインストールと起動

ホーム · クイックスタート · 画像付き入門 · English

初めて使う場合はこのページから始めてください。Python 3.9～3.14 と GUI を表示できるデスクトップ環境が必要です。Python がまだない場合は、先に Python と pip のインストール を確認してください。

目次

• インストール方法を選ぶ
• Windows: PowerShell
• macOS / Linux: ターミナル
• インストーラーで行うこと
• 起動を確認する
• 更新と削除
• うまくいかない場合

インストール方法を選ぶ

目的	方法
Python 環境・プラグイン・パッケージ更新を使う	以下の moleditpy-installer。OS に合う本体パッケージを自動で選びます
Python を設定せず Windows で使う	Windows 単体版インストーラー
Python を設定せず Apple Silicon Mac で使う	macOS 単体版バンドル
コンテナ環境で使う	Docker。GUI の表示接続は別途必要です

Windows/macOS の単体版には Open Babel と pip が含まれません。追加の Python パッケージが必要なプラグインを使う場合は、Python を使うインストール方法を選んでください。

Windows: PowerShell

ターミナルで次の 2 行を順番に実行してください。仮想環境の作成は必須ではありません。

pip install moleditpy-installer
python -m moleditpy_installer

最初の行で本体も自動的にインストールされます。次の行でショートカット・ファイル関連付けを設定できます。

macOS / Linux: ターミナル

pip install moleditpy-installer
python -m moleditpy_installer

macOS/Linux で Python のコマンド名が python3 の場合は、2 行目を python3 -m moleditpy_installer とします。pip と python は同じ Python 環境のものを使ってください。

仮想環境は必要に応じて利用する選択肢です。Linux で externally-managed-environment と表示される場合は、Python と pip のトラブルシューティング にある仮想環境の手順を使い、その中で上の 2 行を実行してください。

Debian/Ubuntu では Qt 用に sudo apt install libxcb-cursor0 が必要な場合があります。macOS の python.org 版 Python では Install Certificates.command も実行してください。詳細は Windows、macOS、Linux のページにあります。

インストーラーで行うこと

ターミナル内の対話画面で項目を選び、Install を押します。初期値はアプリケーションメニュー オン、.pmeprj 関連付け オン、デスクトップ オフ、ユーザー単位です。Python 環境を置き換えるものではなく、その環境を使うランチャーを作成します。

インストーラーの起動には、次の両方が使えます。

python -m moleditpy_installer
moleditpy-installer

python -m moleditpy_installer を推奨します。 moleditpy-installer が PATH にない場合も、指定した Python で実行できます。インストールも同じ Python で pip install moleditpy-installer と実行します。パッケージ名はハイフン、モジュール名はアンダースコアです。複数の Python がある場合は、python -m pip install moleditpy-installer で実行する Python を指定して導入できます。

対話画面を使わない場合は --no-tui を付けます。--desktop、--check、--exe-path、--uninstall も利用できます。

python -m moleditpy_installer --check
python -m moleditpy_installer --no-tui --desktop
python -m moleditpy_installer --help

起動を確認する

環境内の moleditpy に --version を付けてバージョンを確認します。プラグインなしで本体を確認する場合は --safe で起動してください。

moleditpy --version
moleditpy --safe

仮想環境を選んで使っている場合は、その環境を有効化してから実行してください。

セーフモードはすべてのプラグインの読み込みをスキップします。標準の 2D 描画・3D 変換・測定・出力は使用できます。プラグインを使う場合は通常起動してください。起動できたら、画像付きの 最初の分子を作る に進みます。

更新と削除

同じ環境を有効化するか、その Python を明示的に指定します。

# Windows/macOS
python -m pip install --upgrade moleditpy moleditpy-installer
# Linux
python -m pip install --upgrade moleditpy-linux moleditpy-installer
# 環境やパスを変更したらランチャーを更新
python -m moleditpy_installer

環境を削除する前に、python -m moleditpy_installer --uninstall でランチャーと関連付けを解除してください。本体パッケージは削除されません。本体の削除には Windows/macOS で python -m pip uninstall moleditpy、Linux で python -m pip uninstall moleditpy-linux を使います。

うまくいかない場合

症状	対処
moleditpy-installer が認識されない	選択した Python の -m moleditpy_installer を使う
No module named moleditpy_installer	その Python の -m pip で導入する。別の Python に入っている可能性があります
本体が見つからない	--check で確認し、--exe-path に環境内の本体実行ファイルか Scripts/bin フォルダを指定する
クラッシュ・3D が空白	--safe を試し、トラブルシューティング へ。セーフモードは描画ドライバーの代わりにはなりません
Linux のパッケージ競合	moleditpy-linux を使う。インストーラーは自動選択します