mljar/mercury

これは何？

主な機能

• 01変更に応じてnotebookのセルを再実行するインタラクティブなウィジェット。
• 02ディレクトリ内のすべてのnotebookをWebアプリとして配信する単独のサーバー。
• 03開発中にアプリをライブプレビューできるJupyterLab拡張機能。
• 04フロントエンドのコードを書かなくてもアプリに統一感を持たせられる、あらかじめ定義されたレイアウト。
• 05パスワード保護と、閲覧者間でセッションを共有するオプション。
• 06config.tomlでタイトル、フッター、notebookのサムネイルをカスタマイズ。

ユースケース

• 既存の分析用notebookを、技術者以外の同僚向けのダッシュボードに変換する。
• notebookのコードを使ってチャットやAIエージェントのインターフェースを構築する。
• 読者が入力コントロールを使って調整できるデータレポートを公開する。
• 実行可能なアプリとして、教材用notebookを学生と共有する。

クイックスタート

1. 1

   PyPIからMercuryをインストールする

   pip install mercury
2. 2

   ノートブックがあるディレクトリでサーバーを起動する

   mercury

使う前に知っておきたいこと

• !ライブアプリのプレビューはJupyterLabとMLJAR Studioでのみ利用できます。Google ColabとVS Codeでは利用できません。
• !ユーザーごとの認証は有料オプションです。無料オプションでは共有パスワードを使用します。

収録されている特集

トピック

よくある質問

mercury とは？

Jupyter notebookを、フロントエンドを書かずに、ウィジェットとリアクティブな再実行を備えた共有可能なインタラクティブWebアプリに変換します。 Mercuryは、notebookから直接インタラクティブなWebアプリを作成できるPythonフレームワークです。テキスト入力やセレクターなどのウィジェットからnotebookに値を渡せます。ウィジェットを変更すると、その下にあるセルが再実行されるため、コールバック関数を書く必要はありません。レイアウトはあらかじめ定義されているので、UIコードを書かなくても統一感のあるアプリになります。

mercury は無料で使えますか？ライセンスは？

mercury は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

mercury は今もメンテナンスされていますか？

活発にメンテナンス中。mercury の最終コミットは 2026年10月26日 です。

mercury は何に使えますか？

既存の分析用notebookを、技術者以外の同僚向けのダッシュボードに変換する。 notebookのコードを使ってチャットやAIエージェントのインターフェースを構築する。 読者が入力コントロールを使って調整できるデータレポートを公開する。 実行可能なアプリとして、教材用notebookを学生と共有する。

mercury のインストール方法は？

PyPIからMercuryをインストールする: pip install mercury ノートブックがあるディレクトリでサーバーを起動する: mercury

mercury はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/mljar/mercury