explaingit

cvetkovicdamjan/neurilium

Analysis updated 2026-05-18

43RustAudience · researcherComplexity · 4/5Setup · hard

TLDR

A Rust program that simulates the electrical firing of real neurons using actual brain wiring data, like the fruit fly connectome, and renders it live in 3D.

Mindmap

mindmap
  root((repo))
    What it does
      Simulates real neuron firing
      Uses connectome data
      Renders neurons in 3D
    Tech stack
      Rust codebase
      wgpu GPU library
      Izhikevich model
    Use cases
      Simulate fruit fly brain
      Explore other datasets
      Study neuron firing patterns
    Audience
      Researchers
      Neuroscience learners
      Rust and GPU tinkerers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Load the FlyWire fruit fly connectome dataset and watch simulated neurons fire in real time

USE CASE 2

Explore other public brain datasets like mouse cortex or roundworm nervous system data

USE CASE 3

Study how Izhikevich neuron models behave when driven by real connection data

USE CASE 4

Modify the small, seven-file codebase to experiment with new neural simulation ideas

What is it built with?

RustwgpuGPU compute

How does it compare?

cvetkovicdamjan/neuriliumsermuns/is-it-slopfuninkina/openeffects
Stars434344
LanguageRustRustRust
Setup difficultyhardeasymoderate
Complexity4/52/54/5
Audienceresearcherdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires downloading connectome CSV datasets and a GPU capable of running wgpu compute.

In plain English

Neurilium is a small program that simulates the electrical activity of neurons and their connections, rendered visually in real time. The primary example in the README is the fruit fly brain, which is currently the most complete whole-brain neural map available to researchers. You feed it real connectome data (the wiring diagram of a brain) and watch the simulated neurons fire. Getting started means downloading three CSV files from the FlyWire project's public dataset: one listing neurons, one listing connections between them, and one with spatial coordinates. You place those files in a data folder, clone the repository, and run the program with a single Cargo command. Navigation in the 3D view uses mouse and keyboard controls described in the README. The simulation uses a model called Izhikevich neurons, which the README explains are simple to compute while still producing realistic neuron firing behavior. The GPU work runs through wgpu, a Rust library that abstracts over graphics and compute APIs. The author notes this combination replaces the more traditional C++ plus CUDA plus Vulkan stack in a more unified way. The codebase is intentionally small: around seven files handling loading, rendering, camera, and simulation. The README also points to other publicly available brain datasets you could adapt the code to simulate, including a small region of human brain tissue, a mouse cortex sample, a zebrafish whole-brain reconstruction, and the full nervous system of a roundworm. No dataset download links are provided for those, but the README notes they can be found with some searching. This project is open to experimentation. The README frames it as code that is easy to modify rather than a finished product, and acknowledges the FlyWire team for making the fruit fly data publicly available.

Copy-paste prompts

Prompt 1
Walk me through downloading the FlyWire CSV files and running this simulator with Cargo
Prompt 2
Explain how the Izhikevich neuron model used here differs from a full biophysical neuron model
Prompt 3
Help me adapt this project's loading code to simulate the mouse cortex dataset mentioned in the README
Prompt 4
Explain what wgpu is doing in this project and why the author chose it over CUDA and Vulkan

Frequently asked questions

What is neurilium?

A Rust program that simulates the electrical firing of real neurons using actual brain wiring data, like the fruit fly connectome, and renders it live in 3D.

What language is neurilium written in?

Mainly Rust. The stack also includes Rust, wgpu, GPU compute.

How hard is neurilium to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is neurilium for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.