gitwtfhub

wtf is inertia?

aclfe/inertia — explained in plain English

Analysis updated 2026-05-18

101RustAudience · developerComplexity · 2/5LicenseSetup · easy

TL;DR

A terminal only 3D physics sandbox with rigid bodies, gravity, cloth, and fluid simulations, rendered as text with no graphics card needed.

Mindmap

mindmap
  root((Inertia))
    What it does
      Rigid body physics
      N-body gravity
      Cloth simulation
      Fluid simulation
    Tech stack
      Rust
      rapier3d
      ratatui
      Braille rendering
    Use cases
      Explore physics in a terminal
      Run demos over SSH
      Build custom scenes
    Audience
      Developers
      Hobbyists
      Terminal enthusiasts

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

Why would anyone build with this?

REASON 1

Run a real time physics sandbox entirely over an SSH terminal session.

REASON 2

Simulate stacking rigid bodies, orbiting stars, cloth, or fluid for fun or demos.

REASON 3

Study how 3D projection and depth sorting can be done in text based rendering.

REASON 4

Build a headless physics demo for a machine with no display or GPU.

What's in the stack?

Rustrapier3dratatuiCargo

How it stacks up

aclfe/inertiaaimino-tech/opendocswork-mcpcloudflare/sliceslice-rs
Stars101100102
LanguageRustRustRust
Last pushed2026-04-23
MaintenanceMaintained
Setup difficultyeasymoderatemoderate
Complexity2/53/52/5
Audiencedeveloperdeveloperdeveloper

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

How do you spin it up?

Difficulty · easy Time to first run · 5min
You may use this project under either the MIT license or the Apache License 2.0, whichever you prefer.

Wtf does this do

Inertia is a physics playground that runs entirely inside your terminal, with no graphical window and no graphics card required. It draws a full 3D scene using text characters, specifically braille patterns, so it can run anywhere a terminal works, including over a remote SSH connection, inside a container, or on a machine with no screen at all. The project bundles four separate simulations that share one camera and one interface. Rigid bodies let you spawn boxes and spheres, stack them, launch them, and watch them bounce and settle using a physics engine called rapier3d. N-body gravity simulates stars pulling on each other, with fading orbit trails and a built in three body figure eight demo. Cloth simulation uses a custom spring and mass mesh that you can pin, drag, drape over other objects, and blow around with wind. Fluid simulation lets you pour, splash, and drop solid objects into a particle based liquid. You can run up to nine of these sandboxes side by side and switch between them while the program is running. To install it, you clone the repository and run it with cargo, the Rust build tool, or install the published binary called inertia-tui and run the inertia command. A terminal that supports true color and mouse input gives the best experience, and you can either pick a ready made demo from the start menu or begin with an empty scene and build your own. Under the hood, every object is transformed from its position in the 3D world through a virtual camera and projected down onto the terminal grid, correcting for the fact that terminal characters are taller than they are wide. Physics updates run on a fixed time step separate from rendering, so if a scene gets too heavy for the hardware, it slows down smoothly instead of freezing. The project is dual licensed under the MIT license and the Apache License 2.0, and you may choose either one.

Yoink these prompts

Prompt 1
Show me how to install and run Inertia using cargo on my machine.
Prompt 2
Explain how Inertia projects a 3D scene onto a terminal using braille characters.
Prompt 3
Walk me through building a custom scene that mixes cloth and rigid bodies in Inertia.
Prompt 4
Help me understand the fixed timestep physics loop used in this project.
Prompt 5
Show me how the n-body gravity simulation and its solvers work in Inertia.

Frequently asked questions

wtf is inertia?

A terminal only 3D physics sandbox with rigid bodies, gravity, cloth, and fluid simulations, rendered as text with no graphics card needed.

What language is inertia written in?

Mainly Rust. The stack also includes Rust, rapier3d, ratatui.

What license does inertia use?

You may use this project under either the MIT license or the Apache License 2.0, whichever you prefer.

How hard is inertia to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is inertia for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.