Skip to main content

simple_module_cli

Standalone scaffolder for the SimpleModule framework.

Install

pip install simple_module_cli
# or, to keep the CLI in its own venv:
pipx install simple_module_cli
# or, to run it without installing:
uvx --from simple_module_cli@latest smpy new my-app

The standalone CLI depends on typer, tomlkit, packaging, and PyYAML. The Docker worker command uses PyYAML to validate Compose environment entries while preserving the original formatting.

Usage

uv run smpy new my-app                       # interactive wizard
uv run smpy new my-app --yes --preset full   # all built-in modules + background jobs
uv run smpy create-module my_feature         # scaffold a publishable module package
uv run smpy create-host bare-host            # scaffold a bare host (no opinionated wiring)

Built-in commands: uv run smpy new, uv run smpy create-host, uv run smpy create-module, uv run smpy update, and uv run smpy skills {list,add,update}.

uv run smpy update handles PyPI and git pins, syncs lockfiles and generates the frontend. package-update remains a deprecated alias until 0.0.50. Creating a module inside an app workspace also wires and installs it; then use uv run smpy migrations new <module> -m "init", review, make migrate and restart.

When other framework packages are installed, they contribute additional subcommands via the simple_module_cli.cli_plugins entry-point group:

Package Commands
simple_module_hosting uv run smpy host gen-pages, uv run smpy host sync-js-deps
simple_module_users uv run smpy users create-admin
simple_module_settings uv run smpy settings import-from-env

License

MIT — see LICENSE.

Metadata

Release files for simple-module-cli 0.0.48

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for simple-module-cli 0.0.48
File Size Uploaded Provenance Actions
simple_module_cli-0.0.48.tar.gz 255.5 kB With provenance Details for simple_module_cli-0.0.48.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for simple-module-cli 0.0.48
File Interpreter ABI Platform Actions
simple_module_cli-0.0.48-py3-none-any.whl Python 3 none any Details for simple_module_cli-0.0.48-py3-none-any.whl

Total release size: 551.2 kB

Release files / simple_module_cli-0.0.48.tar.gz

Download URL simple_module_cli-0.0.48.tar.gz
Size 255.5 kB
Tags Source
SHA-256 checksum
How to use checksums
17ce284727d179837c707973bafee12397ea6ad63d163bf3c407cc57b6ca7c0d
BLAKE2b-256 checksum
How to use checksums
83f2498c6e69b8bd44b44d6e95ec8b4ddde5f1105ba5aab83ffcbc65184fc1cf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Release files / simple_module_cli-0.0.48-py3-none-any.whl

Download URL simple_module_cli-0.0.48-py3-none-any.whl
Size 295.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0ea689d7b1a1e0f2c22735fab736c576772aae7936c09cc7d980d12562afb6c8
BLAKE2b-256 checksum
How to use checksums
0560b030edbc0189f92e1ef7b832d5088a0b1aa419919b31429b86fd9a2fa112
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

Security for simple-module-cli 0.0.48

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for simple_module_cli-0.0.48.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 19, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.0.48 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page