Skip to content

Installation for macOS JP

Jump to bottom
Hiromichi Yokoyama edited this page Oct 6, 2026 · 3 revisions

macOS へのインストール

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 のインストール を済ませてください。

python.org から Python をインストールした場合は、そのあと Install Certificates.command を実行してください。実行しないと、MoleditPy 本体は動いても、インターネットに接続するプラグイン（Plugin Installer、PubChem 検索、AI チャットなど）が [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed で失敗します。

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

  • 推奨: moleditpy-installer — moleditpy パッケージのインストールに加えて、MoleditPy.app ランチャー（~/Applications または /Applications）と .pmeprj ファイル関連付けを作成します。下記の 方法 A を参照してください。
  • Conda 環境を使う方法 — 手動で管理する環境です。方法 B を参照してください。

方法 A: moleditpy-installer（推奨）

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

    pip install moleditpy-installer

    これにより moleditpy パッケージが依存関係として自動的にインストールされます。

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

    moleditpy-installer

    対話的なターミナルではTUIが開き、インストールする構成要素（デスクトップショートカット、.pmeprj ファイル関連付け）とスコープ（ユーザー単位の ~/Applications か、システム全体の /Applications）を選んで Install を押します。スクリプトから使う場合は、moleditpy-installer --no-tui（既定値）、moleditpy-installer --desktop（デスクトップにもコピーを作成）、sudo moleditpy-installer --system（システム全体）を使います。

    生成される MoleditPy.app は、moleditpy スクリプトとその環境の Python インタープリタ（隣接するインタープリタ、またはスクリプトの shebang から検出）を組み合わせたもので、設定後に ad-hoc コード署名されます。これは Apple Silicon でアプリを起動するために必要な処理です。MoleditPy は Python の出力やエラーが見えるように、常にターミナルウィンドウの中で起動します。初回起動時には macOS の確認ダイアログ（「"MoleditPy" が "ターミナル" を制御するアクセスを求めています」）が一度だけ表示されるので、OK をクリックしてください。

  3. 起動

    アプリケーションフォルダの MoleditPy.app をダブルクリックするか、ターミナルから起動します。

    moleditpy

  4. アップグレード

    pip install --upgrade moleditpy moleditpy-installer
moleditpy-installer          # 必要に応じて再実行し、アプリバンドル/署名を更新する

  5. アンインストール

    moleditpy-installer --uninstall
pip uninstall moleditpy

オプションの一覧は moleditpy-installer の README を、Automator で .app ランチャーを手動で作る方法は Shortcut (macOS) を参照してください。

方法 B: Conda 環境

この手順は、GUI アプリケーションで問題になりがちなライブラリの互換性を確保することを狙ったものです。

前提条件

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

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

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

  1. ターミナルを開く
  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

環境ごと削除する場合。

conda deactivate
conda env remove -n moleditpy-env

関連ページ

Clone this wiki locally