Skip to content

Latest commit

 

History

History
50 lines (33 loc) · 1.63 KB

File metadata and controls

50 lines (33 loc) · 1.63 KB

License: MIT Repo Size Last Commit Language GitHub stars

🧠 Brainfuck CLI Interpreter

A minimalist yet powerful CLI-based interpreter for the Brainfuck esoteric language, built in Python. Designed to help developers understand how low-level interpreters work while offering a clean and professional tool for executing .bf programs.


📂 Project Structure

brainfuck-cli/ │ ├── brainfuck.py # Interpreter logic ├── cli.py # Command-line interface ├── examples/ # Sample .bf programs │ └── hello_world.bf ├── README.md # You're here ├── LICENSE # Open source MIT license └── requirements.txt # Dependencies (optional)


🚀 How to Use

🐍 Run from Python CLI

python cli.py examples/hello_world.bf

Example Output:
Hello World!



📥 Installation (Optional if you want to make it pip-installable)

git clone git@github.com:TechWithHer/brainfuck-cli.git
cd brainfuck-cli
python cli.py examples/hello_world.bf

Brainfuck isn’t practical.
But understanding this means you truly get how machines think—memory, pointers, loops, and side effects.