quilt3 CLI

catalog
usage: quilt3 catalog [-h] [--detailed_help] [navigation_target]
​
Run Quilt catalog locally
​
positional arguments:
  navigation_target  Which page in the local catalog to open. Leave blank to
                     go to the catalog landing page, pass in an s3 url (e.g.
                     's3://bucket/myfile.txt') to go to file viewer, or pass
                     in a package name in the form 'BUCKET:USER/PKG' to go to
                     the package viewer.
​
optional arguments:
  -h, --help         show this help message and exit
  --detailed_help    Display detailed information about this command and then
                     exit
Run the Quilt catalog on your machine (requires Docker). Running quilt3 catalog launches a webserver on your local machine using Docker and a Python microservice that supplies temporary AWS credentials to the catalog. Temporary credentials are derived from your default AWS credentials (or active AWS_PROFILE) using boto3.sts.get_session_token. For more details about configuring and using AWS credentials in boto3, see the AWS documentation: https://boto3.amazonaws.com/v1/documentation/api/latest/guide/configuration.html​
Previewing files in S3
The Quilt catalog allows users to preview files in S3 without downloading. It relies on a API Gateway and AWS Lambda to generate certain previews in the cloud. The catalog launched by quilt3 catalog sends preview requests to https://open.quiltdata.com. Preview requests contain short-lived signed URLs generated using your AWS credentials. Data is encrypted in transit and no data is retained by Quilt. Nevertheless, it is recommended that you use quilt3 catalog only for public data. We strongly encourage users with sensitive data in S3 to run a private Quilt deployment. Visit https://quiltdata.com for more information.
install
usage: quilt3 install [-h] [--registry REGISTRY] [--top-hash TOP_HASH]
                      [--dest DEST] [--dest-registry DEST_REGISTRY]
                      name
​
Install a package
​
positional arguments:
  name                  Name of package, in the USER/PKG[/PATH] format
​
optional arguments:
  -h, --help            show this help message and exit
  --registry REGISTRY   Registry where package is located, usually s3://MY-
                        BUCKET. Defaults to the default remote registry.
  --top-hash TOP_HASH   Hash of package to install. Defaults to latest.
  --dest DEST           Local path to download files to.
  --dest-registry DEST_REGISTRY
                        Registry to install package to. Defaults to local
                        registry.
verify
usage: quilt3 verify [-h] --registry REGISTRY --top-hash TOP_HASH --dir DIR
                     [--extra-files-ok]
                     name
​
Verify that package contents matches a given directory
​
positional arguments:
  name                 Name of package, in the USER/PKG format
​
optional arguments:
  -h, --help           show this help message and exit
  --registry REGISTRY  Registry where package is located, usually s3://MY-
                       BUCKET
  --top-hash TOP_HASH  Hash of package to verify
  --dir DIR            Directory to verify
  --extra-files-ok     Whether extra files in the directory should cause a
                       failure
login
usage: quilt3 login [-h]
​
Log in to configured Quilt server
​
optional arguments:
  -h, --help  show this help message and exit
logout
usage: quilt3 logout [-h]
​
Log out of current Quilt server
​
optional arguments:
  -h, --help  show this help message and exit
config
usage: quilt3 config [-h] [--set KEY=VALUE [KEY=VALUE ...]] [catalog_url]
​
Configure Quilt
​
positional arguments:
  catalog_url           URL of catalog to config with, or empty string to
                        reset the config
​
optional arguments:
  -h, --help            show this help message and exit
  --set KEY=VALUE [KEY=VALUE ...]
                        Set a number of key-value pairs for config_values(do
                        not put spaces before or after the = sign). If a value
                        contains spaces, you should define it with double
                        quotes: foo="this is a sentence". Note that values are
                        always treated as strings.
disable-telemetry
usage: quilt3 disable-telemetry [-h]
​
Disable anonymous usage metrics
​
optional arguments:
  -h, --help  show this help message and exit
list-packages
usage: quilt3 list-packages [-h] registry
​
List all packages in a registry
​
positional arguments:
  registry    Registry for packages, e.g. s3://quilt-example
​
optional arguments:
  -h, --help  show this help message and exit
push
usage: quilt3 push [-h] --dir DIR [--registry REGISTRY] [--dest DEST]
                   [--message MESSAGE]
                   name
​
Pushes the new package to the remote registry
​
positional arguments:
  name                 Name of package, in the USER/PKG format
​
optional arguments:
  -h, --help           show this help message and exit
  --dir DIR            Directory to add to the new package
  --registry REGISTRY  Registry where to create the new package. Defaults to
                       the default remote registry.
  --dest DEST          Where to copy the objects in the package
  --message MESSAGE    The commit message for the new package
API Reference - Previous
quilt3.Bucket
Next - References
Frequently Asked Questions
Last updated 5 days ago
quilt3 CLI

`catalog`

Previewing files in S3

`install`

`verify`

`logout`

`config`

`disable-telemetry`

`list-packages`

`push`
