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.1

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.1
File	Size	Uploaded
bdsh-0.7.1.tar.gz	33.1 kB	Oct 14, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for bdsh 0.7.1
File	Interpreter	ABI	Platform	Reset
bdsh-0.7.1-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.1.tar.gz

Download URL	bdsh-0.7.1.tar.gz
Size	33.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`c5a91fcdcabaaf907445b1bad727e3ddc9be4da20b3e3c1cfa4ddaba4a1d35e3`
BLAKE2b-256 checksum How to use checksums	`6a49063249b67b852860428f7b6bd31343e2602258f1fc994ad57fbc240aebc4`
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/11ece792cef6a460a63896e6b008745b9af7b5bf

Workflow

Publishing configuration: github.com/badtechnologies/bdsh/blob/11ece792cef6a460a63896e6b008745b9af7b5bf/.github/workflows/publish.yml
Publishing logs: github.com/badtechnologies/bdsh/actions/runs/38519269616/attempts/1

Artifact

Subject: bdsh-0.7.1.tar.gz
SHA-256 checksum: c5a91fcdcabaaf907445b1bad727e3ddc9be4da20b3e3c1cfa4ddaba4a1d35e3 Verifying attestations

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

Download URL	bdsh-0.7.1-py3-none-any.whl
Size	27.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`3c22557dfe17420ebef99e08cc08256d2062d309db77c834fafa27e541cefe3f`
BLAKE2b-256 checksum How to use checksums	`aaa325a23d094d6f831f59639961678dee4eecf806c29355cbaa9f0aed50d23b`
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/11ece792cef6a460a63896e6b008745b9af7b5bf

Workflow

Publishing configuration: github.com/badtechnologies/bdsh/blob/11ece792cef6a460a63896e6b008745b9af7b5bf/.github/workflows/publish.yml
Publishing logs: github.com/badtechnologies/bdsh/actions/runs/38519269616/attempts/1

Artifact

Subject: bdsh-0.7.1-py3-none-any.whl
SHA-256 checksum: 3c22557dfe17420ebef99e08cc08256d2062d309db77c834fafa27e541cefe3f Verifying attestations