Skip to content

An artificial life / genetic programming simulation


Notifications You must be signed in to change notification settings


Folders and files

Last commit message
Last commit date

Latest commit



16 Commits

Repository files navigation


Crellinor is an Artificial Life / Genetic Programming simulation. It places creatures into a world in which they have to survive. The creatures lose one energy point per cycle, and they can eat plants to regain a number of energy points. That's the artificial life part. The creatures have individual programs that determine their behaviours. These programs are made up of simple instructions such as EAT or TUL (for turn left). When two creatures run into each other and certain criteria are met then they mate and produce offspring. The offspring's program is created from the programs of both parents. That's the genetic programming part.

You've probably ended up here because you saw my Ready for Rust talk and wanted to see more of the code. Well, here it is. The actual version used in the talk is tagged rfr-talk.

If you want to run the simulation you'll notice that there isn't much documentation. Your best bet it is to read the source code and get an idea of how the simulation works. The tests in tests/ could be a good entry point.

Once you get a feel for the simulator you should edit At the top of the file you can set how many simulations you want to run and how many threads should be used in parallel. Just below is a function named make_world(). It creates the worlds that should be simulated. The name given to the world is used as a directory name in which the individual simulation results are stored as JSON files.

You might find the scripts in the scripts directory useful to process the results. They produce CSV files which lend themselves to be loaded into spreadsheets.

Once you have identified an interesting run, you can restart the run with a web UI to observe what happened. Add the command line options to load the log file as a starting point and to run the web UI.

cargo run --release -- -wf output/<name>/log-<UUID>.json

The UI is available at http://localhost:3000.