⚗️ Research Repository

This is an experimental/research repository. Code here is exploratory and not production-ready. For production systems, see BlackRoad-OS.

---

Universal Computer

This repository contains an implementation of a universal Turing machine in Python. A universal Turing machine is a theoretical device capable of simulating any other Turing machine. In other words, it can compute anything that is computable. The implementation here is simple and educational; it demonstrates the principles of universality and emulation in a compact form.

Overview

The core of the project is a Turing machine simulator that reads a description of another machine and an input tape, then executes that machine's transition function step by step. The simulator supports tapes of unbounded length in both directions and maintains a set of states, including a halting state. The universal machine itself accepts programs encoded as tables of transitions.

Features

• Tape representation: The tape is implemented as a Python dictionary mapping integer positions to symbols. Positions not present in the dictionary are assumed to hold a blank symbol ('_').
• Transition function: Each transition is a mapping from (current_state, current_symbol) to (next_state, write_symbol, move_direction), where move_direction is 'L', 'R', or 'S' (stay).
• Machine description format: Machine descriptions are loaded from JSON files. A description includes the set of states, the input alphabet, the blank symbol, the transition function, the start state, and the halting state.
• Simulation: The simulator runs the machine until it reaches the halting state or exceeds a configurable step limit. It yields the final tape contents and the number of steps executed.

Running the simulator

To use the universal Turing machine, first prepare a JSON file describing the machine you want to simulate (see machines/ for examples), then run:

python3 utm.py machines/your_machine.json --tape "your input tape here"

For example, to run a binary incrementer:

python3 utm.py machines/incrementer.json --tape "1101"

This will increment the binary number 1101 (13) to 1110 (14).

Directory structure

• utm.py – the universal Turing machine simulator.
• machines/ – sample machine descriptions in JSON format.
• README.md – this file.

Sample machines

The repository includes a few sample machine descriptions:

• incrementer.json – a machine that increments a binary number.
• even_odd.json – a machine that decides whether a unary number has an even or odd number of symbols.

Feel free to add more machines to the machines/ directory to explore the power of Turing machines!

License

This project is released under the MIT License. See LICENSE for details.

---

📜 License & Copyright

Copyright © 2026 BlackRoad OS, Inc. All Rights Reserved.

CEO: Alexa Amundson | PROPRIETARY AND CONFIDENTIAL

This software is NOT for commercial resale. Testing purposes only.

🏢 Enterprise Scale:

• 30,000 AI Agents
• 30,000 Human Employees
• CEO: Alexa Amundson

Contact: blackroad.systems@gmail.com

See LICENSE for complete terms.