BadOS Dynamic Shell (bdsh)

Read the docs at badtechnologies.github.io/bdsh.

Quick Install

Run the following command:

python3 -m pip install bdsh
python3 -m bdsh.install

The installer creates the shell root, config directory, and first user.

Installation (Manual)

Download the latest release.

Or, install the package from PyPI.
Set up bdsh:
```
python3 -m bdsh.install
```
Follow the prompts. The setup script creates the bdsh/ directory tree and config files.
Start bdsh:
```
bdsh
```

The shell prompts for a username and password, then starts an interactive session.

Minimal boot profile

For a minimal boot prompt that does not start services or request a BadLogon login, run:

bdsh-init

The same entry point is available as python3 -m bdsh.init. It uses a fixed / starting directory and only standard-library shell commands. The exit and quit commands are disabled so the init process remains alive.

Metadata

Release files for bdsh 0.7.0

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

Source distribution (sdist)

Source distribution for bdsh 0.7.0
File	Size	Uploaded
bdsh-0.7.0.tar.gz	33.1 kB	Oct 14, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for bdsh 0.7.0
File	Interpreter	ABI	Platform	Reset
bdsh-0.7.0-py3-none-any.whl 27.0 kB Oct 14, 2026	Python 3	none	any	Details

Total release size: 60.1 kB

Release files / bdsh-0.7.0.tar.gz

Download URL	bdsh-0.7.0.tar.gz
Size	33.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`cf188bac6e2f53124235e544cc9d67302a97977f263d6c6b8524a7967bfcac5c`
BLAKE2b-256 checksum How to use checksums	`8935e44829b64816db603d567b6e8d04c300e69e7aab5d021b7f30e43543528d`
Upload date	Oct 14, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/badtechnologies/bdsh
Publishing commit: github.com/badtechnologies/bdsh/tree/7ff637c833df263e496e16421e7d4df45e24c89c

Workflow

Publishing configuration: github.com/badtechnologies/bdsh/blob/7ff637c833df263e496e16421e7d4df45e24c89c/.github/workflows/publish.yml
Publishing logs: github.com/badtechnologies/bdsh/actions/runs/38517930543/attempts/1

Artifact

Subject: bdsh-0.7.0.tar.gz
SHA-256 checksum: cf188bac6e2f53124235e544cc9d67302a97977f263d6c6b8524a7967bfcac5c Verifying attestations

Release files / bdsh-0.7.0-py3-none-any.whl

Download URL	bdsh-0.7.0-py3-none-any.whl
Size	27.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`80e548d69224796f4f7ad01fab5f120127cd3cc84507a4f8c45cf93ff1ef3e11`
BLAKE2b-256 checksum How to use checksums	`d92b4e3bb8be72ee55037cc96f0e0d653b44fa82e7c4dbbdce8ba47c41251bf6`
Upload date	Oct 14, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/badtechnologies/bdsh
Publishing commit: github.com/badtechnologies/bdsh/tree/7ff637c833df263e496e16421e7d4df45e24c89c

Workflow

Publishing configuration: github.com/badtechnologies/bdsh/blob/7ff637c833df263e496e16421e7d4df45e24c89c/.github/workflows/publish.yml
Publishing logs: github.com/badtechnologies/bdsh/actions/runs/38517930543/attempts/1

Artifact

Subject: bdsh-0.7.0-py3-none-any.whl
SHA-256 checksum: 80e548d69224796f4f7ad01fab5f120127cd3cc84507a4f8c45cf93ff1ef3e11 Verifying attestations