Wrangler Support
Wrangler is our command-line tool for configuring, building and deploying applications with Cloudflare developer products. Use Wrangler to manipulate your Constellation projects and machine-learning models or search for verified models in our catalog.
Installation
Wrangler for Constellation is still in Beta. To install Wrangler for Constellation, run:
Test Wrangler with npx:
$ npx wrangler constellationwrangler constellation
🤖 Interact with Constellation models
Commands: wrangler constellation project Manage your projects wrangler constellation model Manage your models wrangler constellation catalog Check the curated model catalog wrangler constellation runtime Check the suported runtimes
Flags: -j, --experimental-json-config Experimental: Support wrangler.json [boolean] -c, --config Path to .toml configuration file [string] -e, --env Environment to use for operations and .env files [string] -h, --help Show help [boolean] -v, --version Show version number [boolean]
Commands
Manage projects
Use Wrangler to list, create or delete your projects.
$ npx wrangler constellation project --helpwrangler constellation project
Manage your projects
Commands: wrangler constellation project list List your projects wrangler constellation project create <name> <runtime> Create project wrangler constellation project delete <name> Delete project
Create a project
Create a Constellation project.
$ npx wrangler constellation project create "<YOUR_PROJECT_NAME>" ONNX
List your projects
List your Constellation project.
$ npx wrangler constellation project list
Delete a project
Delete a Constellation project.
$ npx wrangler constellation project delete "<YOUR_PROJECT_NAME"
Manage models
You can use Wrangler to list, create or delete your models.
$ npx wrangler constellation model --helpwrangler constellation model
Manage your models
Commands: wrangler constellation model upload <projectName> <modelName> <modelFile> Upload a model for an existing project wrangler constellation model list <projectName> List models of a project wrangler constellation model delete <projectName> <modelName> Delete a model of a project
Upload a model
To upload the SqueezeNet1.1 CNN model to your project, run:
$ npx wrangler constellation model upload "<YOUR_PROJECT_NAME>" "squeezenet11" squeezenet1.1.onnx
List models
List the models in your Constellation project.
$ npx wrangler constellation model list "<YOUR_PROJECT_NAME>"
Delete model
Delete a model in your Constellation project.
$ npx wrangler constellation model delete "<YOUR_PROJECT_NAME>" "squeezenet11"
Access the catalog
The catalog has ready-to-use pre-verified models for our supported runtimes that you can start using in any script without additional configurations. Review the following commands on how you interact with the catalog from Wrangler.
List catalog models
List the models in the catalog.
$ npx wrangler constellation catalog list
Bindings
To deploy a Constellation Worker, you must declare one or more bindings for the Constellation projects you want to use in your wrangler.toml
configuration file.
wrangler.toml# Top-level configuration
name = "my-worker"
main = "src/index.js"
compatibility_date = "2022-07-12"
workers_dev = false
route = { pattern = "example.org/*", zone_name = "example.org" }
constellation = [ {binding = 'AI', project_id = '9d478427-dea6-4988-9b16-f6f8888d974c'}, {binding = 'SENTIMENT_AI', project_id = '8128ac62-0010-5441-beaf-c001e1ee5939'}
]