hbf: An optimizing Brainfuck compiler and evaluator

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.


hbf is a compiler and executor of Brainfuck programs. It provides two executables: hbfc the Brainfuck compiler, and hbf the virtual machine that executes compiled Brainfuck programs.

[Skip to ReadMe]


Change logChangeLog.md
Dependenciesbase (>= && <4.13), binary (>=, bytestring (>=, deepseq (>=, filepath (>=, hbf, optparse-applicative (>=, parsec (>=, primitive (>=, text (>=, transformers (>=, vector (>= [details]
CopyrightSebastian Galkin, 2018
AuthorSebastian Galkin
Home pagehttps://gitlab.com/paraseba/hbf
Bug trackerhttps://gitlab.com/paraseba/hbf/issues
Source repositoryhead: git clone git@gitlab.com:paraseba/hbf.git
Executableshbfc, hbf
UploadedMon Jun 25 22:11:59 UTC 2018 by paraseba





Dump stg and core files


Enable profiling in benchmarks


Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info


Maintainers' corner

For package maintainers and hackage trustees

Readme for hbf-

[back to package description]

HBF Build Status

An unoptimized Brainfuck optimizing compiler and evaluator.

HBF can compile standard Brainfuck code into an optimized Intermediate Representation (IR). This IR can later be executed for faster Brainfuck program evaluation.

Getting Started


Use your preferred method for installing HBF from Hackage. If you prefer to build from source you can use cabal.


Let's say you have a Brainfuck program in the file mandelbrot.bf, for example, you can get one here

You can compile the program to the Intermediate Representation using the hbfc executable provided by this project:

hbfc mandelbrot.bf

That will create a file mandelbrot.bfc in the same directory. If you want the output in a different path you cane use --output option to hbfc

Now, you can run the compiled program:

hbf mandelbrot.bfc

and get something like:


There are several options to both the compiler and the evaluator, to modify levels of optimization, output and others. Try --help to learn more.


HBF has heavily documented code. Take a look at the documentation on Hackage.

Running the tests

cabal test

Test coverage report for the last build can be found here.

Running the benchmarks

cabal bench

Benchmark report for the last build can be found here.


This project is licensed under the GPL-3 License - see the LICENSE file for details

Copyright 2018 Sebastian Galkin.


This work is based on the excellent project bfoptimization by matslina: