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.

Python package 1.2.0 (prepared, not yet published)

The PyPI distribution remains marieSimulator. The GitHub repository and web app can use marie-simulator, but PyPI rejected that proposed distribution name as too similar to an existing project. Existing installation and import names stay compatible; no uninstall or package-name migration is needed.

This release packages the updated two-pass assembler and corrected MARIE engine. The pure-Python engine has no required Qt or web dependencies. Python 3.10+ is supported; Python 3.12 is tested. The optional desktop app requires PySide6.

After 1.2.0 is published, install the headless library with:

python -m pip install --upgrade 'marieSimulator==1.2.0'

For the retained desktop GUI, install the extra instead:

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

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. Updated 1.2.0 distributions are prepared locally; publishing to PyPI and hosted deployment are separate actions.

Metadata

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

Built distribution (wheel)

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

Total release size: 37.6 kB

Release files / mariesimulator-1.2.0.tar.gz

Download URL mariesimulator-1.2.0.tar.gz
Size 26.1 kB
Tags Source
SHA-256 checksum
How to use checksums
f78d9e74d2fd56b7d897955c0b74f1722127124fa678b54534df24fb118ac421
BLAKE2b-256 checksum
How to use checksums
3c25104a6a56025f1e5ac38e9a7d58ceb56440ad5ede2c79f3506ae08206ee4c
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.0-py3-none-any.whl

Download URL mariesimulator-1.2.0-py3-none-any.whl
Size 11.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
786663e41a2eb6b0abf5829dbdbe1cb50e7e036e3f6aeefaef38015978e4d6d1
BLAKE2b-256 checksum
How to use checksums
c76fc7eaed06c50d17f527d8afd590b90b7ea173326fd59917b82041418c89ff
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.0

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