Skip to content
BELLE site

BELLE - The Big Endian, Low Level Emulator

Demo

Quickstart

On x86 Linux systems, run

Terminal window
curl -s https://raw.githubusercontent.com/BlueGummi/belle/refs/heads/master/examples/binstall.sh | bash

On macOS and other Unix systems, run

Terminal window
git clone https://github.com/BlueGummi/belle --depth=1 && cd belle && ./build.sh -w && ./install.sh -c
AUR Installation - Binary
Terminal window
yay -S belle-cpu

And on Windows, run

Terminal window
irm ('https://raw.githubusercontent.com/BlueGummi/belle/refs/heads/master/examples/binstall.ps1') | iex

The binaries can be run by calling basm, belle, or bdump.

Further Documentation

ISA (Instruction set) - docs/isa

Assembler - docs/basm.md

Emulator - docs/belle.md

Disassembler - docs/bdump.md

Utilities - docs/btils.md

BELLE and the BELLE utilities in action:

Naming

BELLE is the emulator, whilst BELLE-ISA/ISABELLE is the instruction set.

Statuses:

Linux Build

Deploy Astro site to Pages

Demo

Inspiration

The Little Computer 3 - Inspired some of the design aspects of the BELLE-ISA and BELLE, particularly word-addressed memory and the 16-bit nature of the machine (it’s why “BELLE” has two L’s - it’s to honor the LC3)

Intel x86 assembly - Inspired the syntax for the assembly.