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.
- Architecture, session lifecycle, state machine, and limits
- Correctness and compatibility notes
- Deployment and configuration
- Verification results and limitations
- Existing logo provenance
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.