Providers - Pragmatiks

Provider names take the form <org>/<name>, for example pragmatiks/postgres.

Initialize

Create a new provider project from the template:

pragma providers init mycompany

With options:

pragma providers init mycompany --output ./providers/mycompany --defaults

--description, --author, and --email fill in the project metadata; --defaults skips the prompts.

Update

Merge template changes into an existing project, keeping your customizations:

pragma providers update
pragma providers update ./my-provider

Publish

Build the wheel with uv build, extract the resource schemas, and upload a new version under your organization:

pragma providers publish

Publish another directory, attach release notes, or upload a prebuilt wheel:

pragma providers publish ./my-provider --changelog NOTES.md
pragma providers publish --wheel dist/my_provider-1.0.0-py3-none-any.whl

publish reads the [tool.pragma] table in pyproject.toml. The version comes from the wheel; --version must match it. Published versions are immutable.

Install

Install a provider in your organization. The platform deploys it:

pragma providers install pragmatiks/qdrant
pragma providers install pragmatiks/postgres --version 1.2.0
pragma providers install pragmatiks/redis --upgrade-policy auto-minor
pragma providers install pragmatiks/qdrant --config SOME_KEY=some_value
pragma providers install pragmatiks/qdrant --config-file config.yaml

--upgrade-policy is manual (the default), auto-minor, or auto-patch. --yes skips the confirmation prompt.

List

List providers in the store, or only the installed ones:

pragma providers list
pragma providers list --installed
pragma providers list --query postgres
pragma providers list --scope public --tags ml,vector

Info

Show a provider’s metadata, version history, and installation status:

pragma providers info pragmatiks/qdrant

Status

Check the deployment status of an installed provider:

pragma providers status pragmatiks/postgres

Upgrade and Downgrade

Move an installed provider to another version:

pragma providers upgrade pragmatiks/postgres
pragma providers upgrade pragmatiks/postgres --version 2.0.0
pragma providers downgrade pragmatiks/postgres --version 1.2.0

upgrade without --version targets the latest version. downgrade requires --version.

Deploy

Redeploy an installed provider, at the latest version or a given one:

pragma providers deploy pragmatiks/postgres
pragma providers deploy pragmatiks/postgres --version 1.2.0

Uninstall

Uninstall a provider from your organization:

pragma providers uninstall pragmatiks/qdrant

Uninstall a provider and delete all its resources:

pragma providers uninstall pragmatiks/postgres --cascade

The --cascade flag deletes all resources managed by the provider. This action cannot be undone.

Delete

Delete a provider you authored, with all its versions, from the store:

pragma providers delete myorg/my-provider

Deleting from the store does not uninstall the provider from organizations that have it installed. --yes skips the confirmation prompt.

Next Steps

Building Providers

Learn how to build providers.

​Initialize

​Update

​Publish

​Install

​List

​Info

​Status

​Upgrade and Downgrade

​Deploy

​Uninstall

​Delete

​Next Steps

Building Providers

Initialize

Update

Publish

Install

List

Info

Status

Upgrade and Downgrade

Deploy

Uninstall

Delete

Next Steps