Skip to main content

Quilt3 catalog: local development mode

Project description

Quilt3 catalog: Local development mode

Open source implementation of the Quilt3 registry that works in the local environment (not requiring AWS cloud services aside from S3 / S3 Select).

This package is not intended to be installed/used directly by end users. Instead, install quilt3[catalog] and use quilt3 catalog CLI command.



# set up venv, assuming poetry is available in the PATH
poetry install

# build catalog bundle
(cd ../catalog && npm i && npm run build && cp -r build ../quilt3_local/quilt3_local/catalog_bundle)

# run the app at http://localhost:3000
poetry run quilt3-local


Python environment set-up

First, you need poetry installed.

Then, you have to set up the virtualenv by running poetry install from the project directory -- it will create a virtualenv and install the requirements.

Catalog (node.js) environment set-up

Refer to the catalog documentation.


You can either serve a static catalog bundle (produced by npm run build) or proxy static files from a running catalog instance.

NOTE: you need valid AWS credentials available, see boto3 docs for details.

Serving a static catalog bundle

Run poetry run quilt3-local to start the app on port 3000 serving the static catalog bundle from the ./quilt3_local/catalog_bundle directory. Path to the bundle can be overriden by QUILT_CATALOG_BUNDLE env var. Port can be configured via PORT env var.

In order to serve the bundle, you should first build it by running npm run build from the catalog directory and then either copying it to ./quilt3_loca/catalog_bundle or overriding QUILT_CATALOG_BUNDLE to point to your bundle. However, this approach is not very convenient when developing catalog features, since it requires rebuilding the bundle to pick up the changes. To address this there's a "proxy" mode available.

Proxying a running catalog instance

In this mode the app proxies all the static files requests to a running catalog instance. One can be started by executing PORT=3001 npm start from the catalog directory (setting port to 3001 required to avoid conflict with the quilt3_local app's default settings).

After starting up a catalog instance, you can start the quilt3_local app and point it to that instance by running QUILT_CATALOG_URL=http://localhost:3001 poetry run quilt3-local (the app will be available at http://localhost:3000 and will serve static files from the catalog running at http://localhost:3001, catalog URL configurable via QUILT_CATALOG_URL env var).

Building and publishing

  1. Make sure you set up credentials for poetry

  2. Bump package version in pyproject.toml and update

  3. Update catalog commit hash in catalog-commit if required

  4. Commit, tag, push: git c -am "release X.Y.Z" && git tag vX.Y.Z && git push && git push --tags

  5. Build and publish the package: make publish

Project details

Download files

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

Source Distribution

quilt3_local-1.2.1.tar.gz (38.5 MB view hashes)

Uploaded Source

Built Distribution

quilt3_local-1.2.1-py3-none-any.whl (38.7 MB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page