English | Dansk
An experimental programming language, assembler, and 3D crystal-storage simulator built around colour channels, voxels, and lossless exponent–remainder number representation.
- Open the ChromaPlex 3D browser demo
- PRISME repository — spectral storage and optical routing
- Open the live PRISME glass-plate demo
- Detailed CPL and CPA guide (Danish)
- Compact implementation specification
- Press and technical FAQ
ChromaPlex OS has two programming layers:
| Layer | Name | Purpose |
|---|---|---|
| High level | CPL — ChromaPlex Language | Describes values, voxel coordinates, colour channels, storage, and output. |
| Low level | CPA — ChromaPlex Assembly | Defines the instructions assembled and executed by the crystal simulator. |
The repository includes:
- a CPL-to-CPA compiler;
- a validated CPA assembler;
- a sparse Python 3D crystal simulator;
- five logical colour channels: red, green, blue, violet, and UV;
- a Brainfuck-to-CPA compiler;
- browser and Python demonstrations;
- 49 unit and integration tests.
ChromaPlex OS is currently a software and simulation project. It does not claim to be a finished physical storage product, and the repository does not contain verified optical-hardware performance measurements.
PRISME is the companion project for the spectral and optical layer. It explores mapping bytes across red, green, blue, violet, and UV channels, UV error control, an optical routing simulator, and a browser-based glass-plate visualisation.
The relationship is:
CPL source
↓
ChromaPlex compiler and CPA instruction set
↓
ChromaPlex crystal simulator
↓
PRISME spectral encoding and optical-routing model
Try the live PRISME demo, or inspect the PRISME source and documentation.
For values from 2 upward, the default base-2 representation is:
n = 2^e + remainder
e is the largest exponent for which 2^e <= n. Zero and one use distinct
canonical pairs:
| Value | Pair |
|---|---|
| 0 | (0, 0) |
| 1 | (0, 1) |
| 1,234,567 | (20, 185,991) |
The representation is lossless when the complete remainder is retained. It is not universal compression: whether it reduces storage depends on the data and the concrete serialisation format.
The utilities also support other bases. The verified base-3 example is:
1,234,567 = 3^12 + 703,126
var data = 1234567;
store data at (5, 5, 5) colour GREEN;
load result from (5, 5, 5) colour GREEN;
print result;
Compile and run it directly:
cpl-run examples/store_green.cplExpected output:
Output: [1234567]
Export textual CPA and run it separately:
cplc examples/store_green.cpl -o store_green.cpa
cpa-run store_green.cpaRequires Python 3.9 or newer.
git clone https://github.com/Janus5G/chromaplex-os.git
cd chromaplex-os
python -m pip install -e ".[test]"
python -m unittest discover -s tests -vThe verified suite contains 49 tests covering:
- zero/one distinction and base-2 roundtrips;
- the base-3 representation;
- compact and specification-oriented CPL;
- CPL → CPA → simulator integration;
- documented CPA opcode parity;
- Brainfuck loops, I/O, and voxel-backed tape cells.
| Command | Purpose |
|---|---|
cpl-run FILE.cpl |
Compile CPL and execute it in the simulator. |
cplc FILE.cpl -o FILE.cpa |
Compile CPL to textual CPA. |
cpa-run FILE.cpa |
Assemble and execute textual CPA. |
bf2cpa FILE.bf |
Translate Brainfuck to CPA. |
chromaplex-ai "prompt" |
Optional AI-assisted CPL generation. |
On Windows, if the commands are not found after installation, add Python's
Scripts directory to PATH.
The repository root contains the static ChromaPlex demo:
The connected PRISME project provides:
The ChromaPlex demo is deployed automatically through GitHub Pages when
index.html, demo/, or the Pages workflow changes.
chromaplex-os/
├── chromaplex/ # Compiler, assembler, simulator, and utilities
├── examples/ # CPL, CPA, Brainfuck, image, and plane demos
├── tests/ # Unit and integration tests
├── docs/ # Language and architecture documentation
├── demo/ # Browser-demo files
├── index.html # GitHub Pages entry point
├── README.md # English documentation
└── README.da.md # Danish documentation
- Language specification
- Programming-language guide
- Storage-capacity model and limitations
- Brainfuck translation argument
- Security policy
- Security audit
- PRISME — spectral encoding and optical-routing model
- Cplex — editor for ChromaPlex/CPL
- ChromaPlex v2.0 Specification & Architecture
MIT — see LICENSE.