Skip to main content

MARIE Simulator

A Python MARIE execution engine with a retained Qt desktop application and a SvelteKit web playground. Write assembly, assemble, step or run, and inspect registers, all 4,096 memory words, and numeric input/output.

The web app uses Python for all assembly and execution. Svelte/TypeScript renders the editor and state; it does not simulate the machine. No database, paid service, or AI feature is required.

Install the Python package

The distribution is marieSimulator. Install or upgrade the headless library with:

python -m pip install --upgrade marieSimulator

The pure-Python engine has no required Qt or web dependencies. Python 3.10+ is supported; Python 3.12 is tested. The package includes the shared two-pass assembler and MARIE execution engine.

For the retained desktop GUI, install the extra instead:

python -m pip install --upgrade 'marieSimulator[desktop]'

Assemble and run source directly, without Qt or the web service:

from marieSimulator import Marie, assemble

program = assemble("Load X\nAdd X\nOutput\nHalt\nX, DEC 7")
machine = Marie(program, nonblocking=True)
machine.run()
assert machine.outputs == [14]

The wheel contains the Python engine, assembler, file reader and optional desktop modules. The Svelte web app and its FastAPI backend remain separate checkout / container applications; installing the wheel does not install or host the website. See release preparation and changes.

Run the web app locally

From this repository, in two terminals:

python3 -m venv .venv
.venv/bin/python -m pip install -r backend/requirements-dev.txt
PYTHONPATH=src:backend .venv/bin/python -m uvicorn marie_api.app:app --host 127.0.0.1 --port 8000 --workers 1
cd web
bun install --frozen-lockfile
bun run dev

Open http://127.0.0.1:5175. Requires Python 3.12 and Bun 1.3.11. See local/Docker/Coolify instructions.

Desktop and Python usage

.venv/bin/python -m pip install -r requirements.txt
PYTHONPATH=src .venv/bin/python main.py
from marieSimulator import Marie, MarieReader
machine = Marie(MarieReader('trial'))
machine.run()
machine.show()

The retained GUI imports also work: from marieSimulator import MarieGUI, app. Headless engine imports do not initialize Qt.

        Load    X
        Add     One
        Store   X
        Output
        Halt
X,      HEX     0000
One,    DEC     1

Supported instructions: JnS, Load, Store, Add, Subt, Input, Output, Halt, Skipcond, Jump, Clear, AddI, JumpI, LoadI, StoreI. Directives: HEX, DEC, ORG. Comments start with / or ;. Addresses/HEX are hexadecimal; DEC is signed decimal. Values wrap to 16 bits. See semantics and legacy fixes.

Tests and design

.venv/bin/python -m pytest -q
cd web
bun run check
bun run build
bunx playwright install chromium
bun run test:ui

Browser tests need the local servers running. Qt smoke tests skip if PySide6 is absent.

Future work: breakpoints, sharing, import/export, lessons, and history. These are outside the initial release. Original Git history and historical distributions remain. The Python package is published on PyPI; website hosting remains a separate deployment.

Metadata

Release files for marieSimulator 1.2.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 marieSimulator 1.2.1
File Size Uploaded Provenance Actions
mariesimulator-1.2.1.tar.gz 26.2 kB Without provenance Details for mariesimulator-1.2.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for marieSimulator 1.2.1
File Interpreter ABI Platform Actions
mariesimulator-1.2.1-py3-none-any.whl Python 3 none any Details for mariesimulator-1.2.1-py3-none-any.whl

Total release size: 37.6 kB

Release files / mariesimulator-1.2.1.tar.gz

Download URL mariesimulator-1.2.1.tar.gz
Size 26.2 kB
Tags Source
SHA-256 checksum
How to use checksums
5bc221f1c2bfd4e9a01d3a7a86aaac74e20cf86dbb9ba8084838db7160605fd8
BLAKE2b-256 checksum
How to use checksums
32b29748c604562a8baf6d5ea6eecde6b02c6df5789e6cda7cb4db444b5be11e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.2

Release files / mariesimulator-1.2.1-py3-none-any.whl

Download URL mariesimulator-1.2.1-py3-none-any.whl
Size 11.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
11d0cffdb334d9287eb120b5826c48679517d24720a53d865e09c24f2ef2c9ed
BLAKE2b-256 checksum
How to use checksums
fda17d0a2a3ba96b838ff23ec1438c7e5f6b8b2797fcb3f9af114b39d5f37fba
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.2

Security for marieSimulator 1.2.1

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.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page