Skip to main content

Fileglancer

Github Actions Status

Fileglancer is a web application designed to allow researchers to easily browse, share, and manage large scientific imaging data using OME-NGFF (i.e. OME-Zarr). Our goal is to reduce the friction experienced by users who want to easily share their data with colleagues at their institution. Simply browse to your data, click on the Neuroglancer link, and send that link to your collaborator.

Core features:

  • Browse and manage files on network file shares (NFS) using an intuitive web UI
  • Create shareable Data Links for any file share path, allowing web-based anonymous access to your data
  • Shareable links to Neuroglancer and other viewers
  • Run Apps (compute jobs) on any infrastructure supported by py-cluster-api
  • Integration with the x2s3 proxy service, to easily share data on the internet

See the documentation for more information.

Fileglancer screenshot

Installation

Personal Deployment

Fileglancer can be run in a manner similar to Jupyter notebooks, by starting a web server from the command-line:

# Install from PyPI
pip install fileglancer

# Start the server
fileglancer start

This will start your personal server locally and open a web browser with Fileglancer loaded. By default, only your home directory (~/) will be browsable. You can browse and view your own data this way, but links to data will only work as long as your server is running. To share data reliably with others, you will need a persistent shared deployment.

Shared Deployments

Fileglancer is primarily intended for shared deployments on an intranet. This allows groups of users to share data easily. If you are on the internal Janelia network navigate to "fileglancer.int.janelia.org" in your web browser and login with your Okta credentials. If you are outside of Janelia, you'll need to ask your System Administrator to install Fileglancer on a server on your institution's network.

Software Architecture

Fileglancer has a React front-end and a FastAPI backend. Uvicorn is used to manage the set of FastAPI workers. Each FastAPI worker manages a worker pool of user-specific worker processes that run as the user, inspired by JupyterHub's method of spinning up individual user servers using setuid. This allows each logged in user to access their resources on the network file systems and submit jobs to a compute cluster. The backend database access is managed by SQLAlchemy, which supports many databases including Sqlite and Postgresql.

Fileglancer architecture diagram

Documentation

Related repositories

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fileglancer-3.1.0.tar.gz (9.1 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fileglancer-3.1.0-py3-none-any.whl (8.3 MB view details)

Uploaded Python 3

File details

Details for the file fileglancer-3.1.0.tar.gz.

File metadata

  • Download URL: fileglancer-3.1.0.tar.gz
  • Upload date:
  • Size: 9.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.6

File hashes

Hashes for fileglancer-3.1.0.tar.gz
Algorithm Hash digest
SHA256 797647aa8ccfc0bfb9c769e516c8d27650b6ff4d02cc0666cc5b90d306a6b785
MD5 11750faa99d7d8fc87c0e32367e5872b
BLAKE2b-256 96ff3c52efc6f33d417573dc1b387ea17cff45a8152a6698a142996d279ce37c

See more details on using hashes here.

File details

Details for the file fileglancer-3.1.0-py3-none-any.whl.

File metadata

  • Download URL: fileglancer-3.1.0-py3-none-any.whl
  • Upload date:
  • Size: 8.3 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.6

File hashes

Hashes for fileglancer-3.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 abd8fc493cecc0350525e23521d267dcf231dbdf99a541d6836869cd04eb1f82
MD5 3e141a7058be11a68cfac9075a1c0af2
BLAKE2b-256 65fb877bae58359e8137e9a0b3cbc89480b93956b1ce03a7841affa694e213c0

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

3.1.0 This release

2 files

3.0.0

2 files

2.9.1

2 files

2.9.0

2 files

2.8.1

2 files

2.8.0

2 files

2.7.0

2 files

2.6.0

2 files

2.5.0

2 files

2.4.0

2 files

2.3.2

2 files

2.3.1

2 files

2.3.0

2 files

2.2.0

2 files

2.1.2

2 files

2.1.1

2 files

2.1.0

2 files

2.0.2

2 files

2.0.1

2 files

2.0.0

2 files

1.1.1

2 files

1.1.0

2 files

1.0.0

2 files

0.8.0

2 files

0.7.2

2 files

0.7.1

2 files

0.7.0

2 files

0.6.1

2 files

0.6.0

2 files

0.5.1

2 files

0.5.0

2 files

0.4.0

2 files

0.3.1

2 files

0.3.0

2 files

0.2.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page