Shipit

Shipit is a CLI that automatically detects the type of project you are trying to run, builds it and runs it using Starlark definition files (called Shipit).

It can run builds locally, inside Docker, or through Wasmer, and bundles a one-command experience for common frameworks.

Quick Start

To use shipit, you'll need to have uv installed.

Install nothing globally; use uvx shipit-cli to run Shipit from anywhere.

uvx shipit-cli .

Running in auto mode will generate the Shipit file when needed, build the project, and can also run it. Shipit picks the safest builder automatically and falls back to Docker or Wasmer when requested:

  • uvx shipit-cli . --wasmer builds locally and runs inside Wasmer.
  • uvx shipit-cli . --docker builds it with Docker (you can customize the docker client as well, eg: --docker-client depot).
  • uvx shipit-cli . --start launches the app after building.

You can combine them as needed:

uvx shipit-cli . --start --wasmer --skip-prepare

Commands

Default auto mode

Full pipeline in one command. Combine flags such as --regenerate to rewrite the Shipit file. Use --wasmer to run with Wasmer.

generate

uvx shipit-cli generate .

Create or refresh the Shipit file. Override build and run commands with --install-command, --build-command, or --start-command. Pick a exlicit provider with --use-provider.

plan

uvx shipit-cli plan --out plan.json

Evaluate the project and emit config, derived commands, and required services without building. Helpful for CI checks or debugging configuration.

build

uvx shipit-cli build

Run the build steps defined in Shipit. Append --wasmer to execute inside Wasmer, --docker to use Docker builds.

run

uvx shipit-cli run

Run explicit commands for the project. Use --start to run the start command, or pass one or more --command values. Combine with --wasmer for WebAssembly execution.

deploy

uvx shipit-cli deploy

Deploy a Wasmer package generated by shipit build --wasmer. Use --wasmer-deploy-config to write deployment metadata instead of publishing.

Supported Technologies

Shipit works with three execution environments:

  • Local builder for fast, host-native builds.
  • Docker builder when container isolation is required.
  • Wasmer runner for portable WebAssembly packaging and deployment.

Development

Clone the repository and use the uv project environment.

uv run shipit . --start

Use any other subcommand during development by prefixing with uv run shipit, for example uv run shipit build . --wasmer. This keeps changes local while matching the published CLI behaviour.

Tests

Run the test suite with:

uv run pytest

You can run the e2e tests in parallel (-n 8) with:

uv run pytest -m e2e -v "tests/test_e2e.py" -s -n 8

The e2e tests will:

  • Build the project (locally, or with docker)
  • Run the project (locally or with Wasmer)
  • Test that the project output (via http requests) is the correct one

Release Automation

Releases are automated with Release Please and PyPI Trusted Publishing.

Requirements:

  • Enable GitHub Actions workflow permissions for creating pull requests in the repository settings. Release Please uses the built-in GITHUB_TOKEN.
  • Configure PyPI Trusted Publishing for the shipit-cli project:
    • owner: wasmerio
    • repository: shipit
    • workflow: pypi-publish.yml
    • environment: pypi
  • Create a GitHub environment named pypi. Add reviewers there if releases should require manual approval before publishing.

On each push to main, Release Please opens or updates a release PR based on Conventional Commits. When that PR is merged, it creates a GitHub release with a vX.Y.Z tag and dispatches the PyPI workflow for that tag with the built-in GITHUB_TOKEN. The PyPI workflow also supports manual dispatch for reruns. It:

  • Runs regular tests, excluding e2e tests.
  • Validates that the tag version without the leading v matches:
    • project.version in pyproject.toml
    • version in src/shipit/version.py
  • Builds the package and publishes to PyPI only if all checks pass.

Project links

Data verified by PyPI on Jul 6, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.23.0)

2 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for syrusakbary from gravatar.com syrusakbary Avatar for wasmer from gravatar.com wasmer

GitHub Statistics

Data verified by PyPI on Jul 6, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

Requires

Python >=3.10

Report project as malware

Download files

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

Source Distribution

shipit_cli-0.21.6.tar.gz (89.5 kB view details)

Uploaded Source

Built Distribution

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

shipit_cli-0.21.6-py3-none-any.whl (81.5 kB view details)

Uploaded Python 3

File details

Details for the file shipit_cli-0.21.6.tar.gz.

File metadata

  • Download URL: shipit_cli-0.21.6.tar.gz
  • Upload date:
  • Size: 89.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for shipit_cli-0.21.6.tar.gz
Algorithm Hash digest
SHA256 d9fb81eca4353138db9e63624b2ccb57922bb540275b77edb5968a0effc67c02
MD5 05ddd6c65de2243ca581463f5ecfffde
BLAKE2b-256 d17c8b14dcaf2cf49afd4221bddd70b77d8686c32b64f3565298eda087d27ab5

See more details on using hashes here.

Provenance

The following attestation bundles were made for shipit_cli-0.21.6.tar.gz:

Publisher: pypi-publish.yml on wasmerio/shipit

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file shipit_cli-0.21.6-py3-none-any.whl.

File metadata

  • Download URL: shipit_cli-0.21.6-py3-none-any.whl
  • Upload date:
  • Size: 81.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for shipit_cli-0.21.6-py3-none-any.whl
Algorithm Hash digest
SHA256 08eb4ef2dbb5fc36aae7cfa01eb8064b62ad258e68c2c797defdeee65069d93e
MD5 df8faa466b2b8818f85083c00849ed38
BLAKE2b-256 9b17c54ce5fccd464c8a2d1855bfc0ad60f289bbc95a4c3af7a12e74fce8cae5

See more details on using hashes here.

Provenance

The following attestation bundles were made for shipit_cli-0.21.6-py3-none-any.whl:

Publisher: pypi-publish.yml on wasmerio/shipit

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.23.0

2 files

0.22.2

2 files

0.22.1

2 files

0.22.0

2 files

0.21.7

2 files

This release

0.21.6 This release

2 files

0.21.5

2 files

0.21.4

2 files

0.21.3

2 files

0.21.2

2 files

0.21.1

2 files

0.21.0

2 files

0.20.2

2 files

0.20.1

2 files

0.20.0

2 files

0.19.9

2 files

0.19.8

2 files

0.19.7

2 files

0.19.6

2 files

Pre-release

0.19.6.dev1

2 files

Pre-release

0.19.6.dev0

2 files

0.19.5

2 files

0.19.4

2 files

0.19.3

2 files

0.19.2

2 files

0.19.1

2 files

0.19.0

2 files

0.18.2

2 files

0.18.1

2 files

0.18.0

2 files

0.17.13

2 files

0.17.12

2 files

0.17.11

2 files

0.17.10

2 files

0.17.9

2 files

0.17.8

2 files

0.17.7

2 files

Pre-release

0.17.7a1

2 files

0.17.6

2 files

0.17.5

2 files

0.17.4

2 files

0.17.3

2 files

0.17.2

2 files

0.17.1

2 files

0.17.0

2 files

0.16.1

2 files

0.16.0

2 files

0.15.2

2 files

0.15.1

2 files

0.15.0

2 files

0.14.0

2 files

0.13.4

2 files

0.13.3

2 files

0.13.2

2 files

0.13.1

2 files

0.13.0

2 files

0.12.0

2 files

0.11.3

2 files

0.11.2

2 files

0.11.1

2 files

0.11.0

2 files

0.10.1

2 files

0.10.0

2 files

0.9.1

2 files

0.9.0

2 files

0.8.0

2 files

0.7.1

2 files

0.7.0

2 files

0.6.1

2 files

0.6.0

2 files

0.5.2

2 files

0.5.1

2 files

0.5.0

2 files

0.4.1

2 files

0.4.0

2 files

0.3.4

2 files

0.3.3

2 files

0.3.2

2 files

0.3.1

2 files

0.3.0

2 files

0.2.3

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page