Name		Name	Last commit message	Last commit date
Latest commit History 34 Commits
benches		benches
examples		examples
src		src
.gitignore		.gitignore
Cargo.lock		Cargo.lock
Cargo.toml		Cargo.toml
LICENSE		LICENSE
README.md		README.md

Repository files navigation

Cranefuck

🚧 PROTOTYPE – NOT PRODUCTION READY! 🚧
(But let's be honest: Brainfuck is never ready for production.)

Cranefuck is a high-performance Just-In-Time (JIT) Brainfuck runtime powered by Cranelift. Designed with speed, simplicity, and elegance in mind, this project is the brainchild of a single developer.

Features

🚀 High-Speed JIT Compilation powered by Cranelift
🧩 Minimalist Design for maximum efficiency
🖥️ Cross-Platform Compatibility (currently tested on Windows)
📦 Lightweight Dependencies without sacrificing performance
🛠️ Optimized Execution Pipeline for running Brainfuck programs

Installation

Via Cargo

Install directly from GitHub:

cargo install --git https://github.com/skyne98/cranefuck

Building from Source

Clone the repository and build the release version:

git clone https://github.com/skyne98/cranefuck.git
cd cranefuck
cargo build --release

Usage

Running a Brainfuck File

Execute a Brainfuck program from a file:

cranefuck --file examples/hello.bf

Running from Standard Input

Pipe Brainfuck code directly into Cranefuck:

echo "+[----->+++<]>++." | cranefuck

Running interpreter mode

Disable JIT compilation and run in interpreter mode:

cranefuck --file examples/hello.bf --mode "interpreter"

Contributing

🚨 FEEDBACK WANTED! 🚨

As a solo developer, I welcome you guys to turn this project into a fun community playground for performant brainfuck! Please share your feedback and submit PRs! GitHub.

License

This project is distributed under the MIT License.

Made with ❤️ by skyne98