voila
v0.5.8
インタラクティブなウィジェットを備えたライブ Jupyter ノートブックのレンダリング。
これで、Jupyter ノートブックがスタンドアロンの Web アプリケーションに変わります。
通常の HTML に変換されたノートブックとは異なり、Voilà tornado アプリケーションに接続する各ユーザーは、Jupyter インタラクティブ ウィジェットの変更に対するコールバックを実行できる専用の Jupyter カーネルを取得します。
デフォルトでは、フロントエンドからの実行リクエストが許可されず、任意のコードの実行が防止されます。
デフォルトでは、Voilà は、レンダリングされたノートブックから入力セルを削除する、 strip_sourcesオプションを使用して実行されます。
conda-forge の mamba (または conda) パッケージ マネージャーを使用してインストールできます。
mamba install -c conda-forge voila
またはPyPIから
pip install voila
サイドペインにノートブックのプレビューを表示する JupyterLab 拡張機能が提供されています。
JupyterLab 3.0 以降では、 pip install voila voilaインストールした後、拡張機能が自動的にインストールされます。
拡張機能をソースからインストールする場合は、次のコマンドを実行します。
jupyter labextension install @voila-dashboards/jupyterlab-preview
bqplotサンプル ノートブックをスタンドアロン アプリとしてレンダリングするには、 voila bqplot.ipynb実行します。 jupyter ノートブックのディレクトリを提供するには、引数なしで実行すればvoila 。
たとえば、このリポジトリからサンプル ノートブックbqplot.ipynbレンダリングするには、まず、このノートブックの要件に合わせて現在の環境を更新し (この場合は conda 環境で、次のようにノートブックをレンダリングします)
mamba env update -f .binder/environment.yml cd notebooks/ voila bqplot.ipynb
さらにコマンド ライン オプション (代替ポート番号を指定するなど) を表示するには、 voila --help実行します。
notebookまたはjupyter_serverのサーバー拡張機能としてこれは、ノートブック サーバーまたは jupyter_server の両方で、Jupyter サーバー拡張機能としても使用できます。
Jupyter サーバー拡張機能をインストールするには、次のコマンドを実行します。
jupyter serverextension enable voila jupyter server extension enable voila
Jupyter サーバーを実行している場合、 voilaの接尾辞が付いているベース URL から Voilà アプリにアクセスできます。
Voilà の使用を開始するには、完全なドキュメントを確認してください。
https://voila.readthedocs.io/
次の 2 つの例は、コマンド ライン統合により、スタンドアロンの Jupyter ノートブックを別のアプリに変える方法を示しています。
オプションstrip_sourcesがFalseに設定されている場合、Jupyterノートブックのソースをアプリに表示できます。
ほら、Jupyter の標準フォーマットとプロトコルに基づいて構築されており、ノートブックのプログラミング言語に依存しません。この例では、C++ Jupyter カーネル xeus-cling と xleaflet プロジェクトを利用した完成アプリケーションの例を示します。
Voilà ギャラリーは、Voilà ウィジェットと Jupyter ウィジェットで構築されたライブ ダッシュボードとアプリケーションのコレクションです。
例のほとんどは、ipywidgets、ipyleaflet、ipyvolume、bqplot、ipympl などのウィジェット ライブラリに依存しており、完全にノートブックに基づいて複雑な Web アプリケーションを構築する方法を示しています。
新しいサンプルは、voila-gallery/gallery リポジトリにリストされている手順に従ってギャラリーに追加できます。
開発環境に貢献してセットアップする方法については、CONTRIBUTING.md を参照してください。
ほら、nbconvert と jupyter_server に依存します。
私たちは、すべての投稿者が自分の投稿の著作権を維持できる共有著作権モデルを使用しています。
このソフトウェアは、BSD-3-Clause ライセンスに基づいてライセンス供与されています。詳細については、LICENSE ファイルを参照してください。
