Python 3 library and CLI for SporeStack .onion

Changelog

Requirements

• Python 3.7-3.11 (or maybe newer)

Installation

• pip install sporestack
• Recommended: Create a virtual environment, first, and use it inside there.

Running without installing

• Make sure pipx is installed.
• pipx run sporestack
• Make sure you're on the latest stable version comparing sporestack version with git tags in this repository, or releases on PyPI.

Usage

• sporestack token create --dollars 20 --currency xmr # Can use btc as well.
• sporestack token list
• sporestack token balance
• sporestack server launch SomeHostname --operating-system debian-11 --days 1 # Will use ~/.ssh/id_rsa.pub as your SSH key, by default (You may also want to consider passing --region to have a non-random region. This will use the "primary" token by default, which is the default when you run sporestack token create.)
• sporestack server stop SomeHostname
• sporestack server start SomeHostname
• sporestack server list
• sporestack server remove SomeHostname # If expired

Notes

• If you want to communicate with SporeStack APIs using Tor, set this environment variable: SPORESTACK_USE_TOR_ENDPOINT=1

Developing

• pipenv install --deploy --dev
• pipenv run make test (If you don't have make, use almake)
• pipenv run make format to format files and apply ruff fixes.

Licence

Unlicense/Public domain