blossom-cli

blossom-cli is a thin Python wrapper that makes the upstream Rust Blossom client available through uvx:

uvx blossom-cli --version
uvx blossom-cli status
uvx blossom-cli upload ./file.pdf

The wrapper preserves the upstream command-line API. It does not add, rename, or reinterpret Rust CLI commands. It resolves the upstream executable in this order:

  1. BLOSSOM_RUST_CLI_BIN, when explicitly configured.
  2. A blossom-cli executable already available on PATH.
  3. A versioned executable in the user cache.
  4. cargo install blossom-cli --version 0.5.6 --locked into the user cache.

This package does not contain or reimplement the Blossom protocol. The Rust executable and protocol implementation come from MonumentalSystems/blossom-rs, which is published under the MIT License. This project exists only to provide a convenient uvx entry point for that upstream project.

Configuration

The upstream CLI continues to own all options and environment variables, including BLOSSOM_SECRET_KEY:

export BLOSSOM_SERVER="https://blossom.example.com"
export BLOSSOM_SECRET_KEY="<your-secret-key>"

uvx blossom-cli --server "$BLOSSOM_SERVER" --format json --no-publish upload ./file.pdf

Use uvx blossom-cli --help for the complete command surface. Read the upstream documentation for Blossom protocol behavior and server compatibility.

Development

uv sync --dev
uv run pytest
uv build

To test the wrapper against a locally available Rust executable without compiling anything:

BLOSSOM_RUST_CLI_BIN=/path/to/blossom-cli uvx --from . blossom-cli --version

License

The wrapper code is released under the MIT License; see LICENSE. The upstream project has separate MIT license terms reproduced in licenses/blossom-rs-MIT.txt.

Project links

Data verified by PyPI on
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.5.6.post2)

1 maintainer

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

Credits

Author: Blossom CLI Wrapper Contributors

GitHub Statistics

Data verified by PyPI on 
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.

License

MIT License (MIT License)

Requires

Python >=3.10

Tags

blob-storage blossom cli nostr uvx

Classifiers

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

blossom_cli-0.1.0.tar.gz (13.0 kB view details)

Uploaded Source

Built Distribution

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

blossom_cli-0.1.0-py3-none-any.whl (6.9 kB view details)

Uploaded Python 3

File details

Details for the file blossom_cli-0.1.0.tar.gz.

File metadata

  • Download URL: blossom_cli-0.1.0.tar.gz
  • Upload date:
  • Size: 13.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for blossom_cli-0.1.0.tar.gz
Algorithm Hash digest
SHA256 39f71bdbb32c1036a4500d7a6eb6b7eb0720e1f61000b1dcbd10cc8e5502d955
MD5 afc731f2343494fb764ef4bb02e5749e
BLAKE2b-256 9a7f14bffb3ce3144f4585949346164141610c455e4ee3fcaa2890e2181f9a98

See more details on using hashes here.

Provenance

The following attestation bundles were made for blossom_cli-0.1.0.tar.gz:

Publisher: publish.yml on brenorb/blossom-cli

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

File details

Details for the file blossom_cli-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: blossom_cli-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 6.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for blossom_cli-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6b6a6c532631435c262b2c478aac60906929f28f2849492c2eb5ad27d29a08bf
MD5 fcb2397a2e41f8ff28b9f53e63fd4147
BLAKE2b-256 bedb38fd73b47a4e38472104325f1329b0dbe99ce3539d99e83b20b8b8818474

See more details on using hashes here.

Provenance

The following attestation bundles were made for blossom_cli-0.1.0-py3-none-any.whl:

Publisher: publish.yml on brenorb/blossom-cli

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

Supported by

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