beebium-server

What is Beebium?

Beebium is a headless, cycle-accurate BBC Micro emulator with a client-server architecture. The emulator runs as a server process -- one per machine variant (Model B, B+, B+ 128K, B with ROM/RAM board) -- and is driven over gRPC, so front-ends and automation talk to it across a well-defined protocol rather than being wired into the emulation core.

What is this package?

beebium-server is that emulator, shipped as platform wheels. Each wheel carries the built server binaries, the ROMs, the presets and the bundled extensions, so a complete, working BBC Micro emulator installs straight from PyPI -- no system package manager, no compiler, no ROM files to locate by hand:

pip install beebium-server

Installing it also puts the four server binaries on PATH (beebium-model-b and its variants), so the package is useful on its own.

Relationship to `beebium`

beebium is the Python client that drives a server over gRPC. The two are independent packages -- neither depends on the other -- but they complement each other: with both installed, the client finds this wheel automatically and Beebium.launch() needs no arguments.

pip install beebium beebium-server

Supported platforms

A wheel is published for each of these; pip selects the one matching your machine.

Platform	Wheel tag
Linux x86-64 (glibc 2.36+)	`manylinux_2_36_x86_64`
Linux ARM64 / aarch64 (glibc 2.36+)	`manylinux_2_36_aarch64`
macOS Apple Silicon (arm64, macOS 11+)	`macosx_11_0_arm64`
macOS Intel (x86-64, macOS 12+)	`macosx_12_0_x86_64`
Windows x64	`win_amd64`

Installation

With uv:

uv add beebium-server            # add to your project
# or, into a plain virtualenv:
uv pip install beebium-server

With pip:

pip install beebium-server

Usually you install it alongside the client, pip install beebium beebium-server.

Usage

Run a server from the command line

Installing the wheel puts one console script per machine variant on PATH. Each starts a headless server that listens for gRPC clients:

# Run a BBC Model B server. Variants: beebium-model-b, beebium-model-b-plus,
# beebium-model-b-plus-128k, beebium-model-b-romram.
beebium-model-b --port 48875
# Initializing BBC Model B...
# Listening on port 48875
# BBC Model B ready. Press Ctrl+C to stop.

With no --port the server picks its default port. Run beebium-model-b --help for the other subcommands (listing extensions, describing presets, capturing a screenshot, and more).

Locate the binaries and data from Python

A tiny, dependency-free API reports where the bundled binaries and data live -- useful for launching a server yourself or pointing other tooling at the ROMs:

import beebium.server

# Where the bundled server binary lives (ensured executable), and its kin.
executable = beebium.server.executable_filepath()        # the model-b binary
print(executable)
print(beebium.server.variants())                         # the four variants
print(beebium.server.rom_dirpath())                      # the bundled ROMs
print(beebium.server.preset_dirpath())                   # the bundled presets
print(beebium.server.__version__)

Drive a server from Python

To control a server programmatically -- type at the keyboard, read the screen, inspect memory, drive the debugger -- install the beebium client and see its documentation. With both packages installed, Beebium.launch() starts one of these servers with no arguments.

Contributing

Development happens in the Beebium repository. This wheel is not built from source here: build_wheel.py repackages a release bundle that the monorepo already builds and validates, so the server binaries are byte-identical to those on the GitHub Release.

This README is generated -- do not edit README.md directly. See CONTRIBUTING.md.

License

GPL-3.0-or-later. See COPYING.txt.

Metadata

Release files for beebium-server 0.10.1

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

Built distributions (wheels)

Table of built distributions (wheels) for beebium-server 0.10.1
File	Interpreter	ABI	Platform	Reset
beebium_server-0.10.1-py3-none-win_amd64.whl 53.1 MB Oct 18, 2026 Without provenance	Python 3	none	Windows x86-64	Details
beebium_server-0.10.1-py3-none-manylinux_2_36_x86_64.whl 91.2 MB Oct 18, 2026 Without provenance	Python 3	none	Linux glibc 2.36+ x86-64	Details
beebium_server-0.10.1-py3-none-manylinux_2_36_aarch64.whl 89.8 MB Oct 18, 2026 Without provenance	Python 3	none	Linux glibc 2.36+ ARM64	Details
beebium_server-0.10.1-py3-none-macosx_12_0_x86_64.whl 74.9 MB Oct 18, 2026 Without provenance	Python 3	none	macOS 12.0+ x86-64	Details
beebium_server-0.10.1-py3-none-macosx_11_0_arm64.whl 71.4 MB Oct 18, 2026 Without provenance	Python 3	none	macOS 11.0+ ARM64	Details

Total release size: 380.5 MB

Release files / beebium_server-0.10.1-py3-none-win_amd64.whl

Download URL	beebium_server-0.10.1-py3-none-win_amd64.whl
Size	53.1 MB
Tags	Python 3 Windows x86-64
SHA-256 checksum How to use checksums	`8c907198628e27bc00810f4edb198fd5d9dc55a7d2f9b8762ee127f836617835`
BLAKE2b-256 checksum How to use checksums	`06d6c2dda9163ab69ddb0978f59b22b3e577a33cbe1fe5e5340344cdb6152586`
Upload date	Oct 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / beebium_server-0.10.1-py3-none-manylinux_2_36_x86_64.whl

Download URL	beebium_server-0.10.1-py3-none-manylinux_2_36_x86_64.whl
Size	91.2 MB
Tags	Linux glibc 2.36+ x86-64 Python 3
SHA-256 checksum How to use checksums	`52bae719eb73360c8306e98e3839f41b1b5027517e4953ee10b791a8b021e549`
BLAKE2b-256 checksum How to use checksums	`8301d8b71bbe95d4b73f9ce993526d7a31ee002ebf21faafb64a92a049439feb`
Upload date	Oct 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / beebium_server-0.10.1-py3-none-manylinux_2_36_aarch64.whl

Download URL	beebium_server-0.10.1-py3-none-manylinux_2_36_aarch64.whl
Size	89.8 MB
Tags	Linux glibc 2.36+ ARM64 Python 3
SHA-256 checksum How to use checksums	`8a2355fcf459016fb0991f216edfba691908482feb6c0ae2ab63e0b2c47f775e`
BLAKE2b-256 checksum How to use checksums	`25547dc05ddef539ca0a76a779d968247e245cdbd17fc0f9dfc17f568dd1c784`
Upload date	Oct 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / beebium_server-0.10.1-py3-none-macosx_12_0_x86_64.whl

Download URL	beebium_server-0.10.1-py3-none-macosx_12_0_x86_64.whl
Size	74.9 MB
Tags	Python 3 macOS 12.0+ x86-64
SHA-256 checksum How to use checksums	`e98735e94da1936e0b32bc7d488e0c39d834363580dd5dff9c58ec80dc8c3817`
BLAKE2b-256 checksum How to use checksums	`a9234b3e10d03f5f6b07b151582f082632a82e58eaf9729d41e2bc840c606584`
Upload date	Oct 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / beebium_server-0.10.1-py3-none-macosx_11_0_arm64.whl

Download URL	beebium_server-0.10.1-py3-none-macosx_11_0_arm64.whl
Size	71.4 MB
Tags	Python 3 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`2d8ce30f9f0c6eb3b4ca7f57aaa7433a7eba3d759ded0eb3ae508f2990c87077`
BLAKE2b-256 checksum How to use checksums	`0df87eb91cde542c6cd1188554f6ecb825de98936698dbbe5e879ad9019cf665`
Upload date	Oct 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Security for beebium-server 0.10.1

Report project as malware

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

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.