Installation for macOS JP

macOS へのインストール

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

目次

• コマンドと Python 環境
• 方法 A: moleditpy-installer（推奨）
• 方法 B: Conda 環境
• 関連ページ

コマンドと Python 環境

python -m moleditpy_installer を推奨します。 moleditpy-installer も同じインストーラーを起動する有効なコマンドです。モジュール形式は実行ファイルの PATH に依存せず、指定した Python を使えます。導入も同じ環境で python -m pip install moleditpy-installer と実行してください。

以下の python は導入先の Python を指します。macOS/Linux で環境を有効化していない場合は python3 または環境内の Python を明示します。クイックスタート に導入・設定の 2 行を掲載しています。仮想環境は任意の選択肢です。

MoleditPy は Python 3.9〜3.14 に対応します。GUI は PySide6-Essentials を使い、Python 3.9 では Qt 6.9、それ以外では Qt 6.10〜6.11 を 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 パッケージのインストール

   python -m pip install moleditpy-installer

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

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

   python -m 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. アップグレード

   python -m pip install MoleditPy

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

5. アンインストール

   python -m moleditpy_installer --uninstall
   python -m 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 環境で以下を実行します。

   python -m pip install MoleditPy

   依存パッケージは MoleditPy の指定範囲に従って pip に解決させます。古い固定バージョンを別の Python に適用せず、導入後に次で整合性を確認してください。

   python -m pip check

ステップ 3: moleditpy の起動

インストールが完了したら、GUI アプリケーションとして moleditpy を起動します。

1. 起動コマンドを実行する
   （moleditpy-env を有効化した）ターミナルで以下を実行します。

   moleditpy

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

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

conda activate moleditpy-env
python -m pip install MoleditPy

環境ごと削除する場合。

conda deactivate
conda env remove -n moleditpy-env

関連ページ

• Shortcut (macOS) — ショートカットを手動で作成する
• Installation for Windows / Linux / with Docker
• Troubleshooting Common Issues