Repolode
jpmorganchase

jpmorganchase/jupyter-fs

ローカルやS3、Samba共有などのストレージにつながる複数のファイルブラウザーを追加するJupyterLab拡張機能。

スター
249
フォーク
57
未解決の Issue
32
最終コミット
6 日前

これは何?

jupyter-fsは、必要な数だけファイルブラウザーのパネルを設定でき、それぞれをローカルディレクトリやリモートのファイルシステム型リソースに接続できるJupyterLabプラグインです。Jupyterサーバーの単一の作業ディレクトリに制限されず、サイドバーで複数のストレージを並べて表示し、操作できます。

サーバー側はPyFilesystemとfsspecをベースとしており、ローカルディレクトリにはosfs://、Amazon S3バケットにはs3://、Samba共有にはsmb://といったURLでリソースを指定します。リソースはJupyterLabの設定エディターから追加するか、サーバー側の設定ファイルで定義でき、ユーザー設定と統合されます。URL内の{{VAR}}プレースホルダーで認証情報をテンプレート化でき、必要に応じてJupyterLabで入力を求められます。

フロントエンドではtree-finderを使用しています。PyPIとnpmからインストールでき、READMEによると、CIでは特にS3とSambaのバックエンドをテストしています。その他のPyFilesystemおよびfsspecバックエンドも動作する想定ですが、検証は限定的です。

主な機能

  • 01JupyterLabのサイドバーに、独立したファイルブラウザーパネルを複数追加できます。
  • 02ローカルディレクトリ、Amazon S3バケット、Samba共有に接続できます。
  • 03リソースごとに選択できる、PyFilesystemとfsspecの両バックエンドに対応しています。
  • 04URL内で認証情報をテンプレート化でき、リソースの読み込み時に入力を求められます。
  • 05JupyterLabの設定エディターまたはサーバー側の設定ファイルから構成できます。

ユースケース

  • ノートブック環境から共有ネットワークドライブやSamba共有を参照する。
  • ローカルのプロジェクトファイルと並べて、S3バケット内のデータを扱う。
  • 1つのJupyterLabセッションで、チームが複数の共有ストレージにアクセスできるようにする。

クイックスタート

  1. 1

    pipでパッケージをインストールする

    pip install jupyter-fs
  2. 2

    MetaManagerと拡張機能の設定をjupyter_server_config.jsonに追加する

  3. 3

    JupyterLabで「設定」→「設定エディター」からファイルシステムリソースを追加する

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

  • CIでテストされているPyFilesystemバックエンドはS3とSamba(smb)のみです。他のバックエンドは期待どおりに動作しない可能性があります。
  • リモートリソースの認証にはテンプレート化されたURLと環境変数を使用するため、手動で設定する必要があります。

トピック

#jupyter#jupyterlab#file-browser#s3#samba#fsspec#pyfilesystem#jupyter-lab#jupyter-notebook#jupyterlab-extension

よくある質問

jupyter-fs とは?
ローカルやS3、Samba共有などのストレージにつながる複数のファイルブラウザーを追加するJupyterLab拡張機能。 jupyter-fsは、必要な数だけファイルブラウザーのパネルを設定でき、それぞれをローカルディレクトリやリモートのファイルシステム型リソースに接続できるJupyterLabプラグインです。Jupyterサーバーの単一の作業ディレクトリに制限されず、サイドバーで複数のストレージを並べて表示し、操作できます。
jupyter-fs は無料で使えますか?ライセンスは?
jupyter-fs は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
jupyter-fs は今もメンテナンスされていますか?
活発にメンテナンス中。jupyter-fs の最終コミットは 2026年10月31日 です。
jupyter-fs は何に使えますか?
ノートブック環境から共有ネットワークドライブやSamba共有を参照する。 ローカルのプロジェクトファイルと並べて、S3バケット内のデータを扱う。 1つのJupyterLabセッションで、チームが複数の共有ストレージにアクセスできるようにする。
jupyter-fs のインストール方法は?
pipでパッケージをインストールする: pip install jupyter-fs MetaManagerと拡張機能の設定をjupyter_server_config.jsonに追加する JupyterLabで「設定」→「設定エディター」からファイルシステムリソースを追加する
jupyter-fs はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/jpmorganchase/jupyter-fs

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト