Show HN: An ASCII cell aquarium for your terminal
Comments
A living microscope slide in your terminal. Immune cells chase bacteria, cells divide, and bacteriophages occasionally cause trouble. Inspired by cbonsai and asciiquarium. This is a biological illustration with exaggerated sizes and timing.
Python 3.10+ on Linux or macOS, with curses; Windows users can use WSL. No third-party runtime dependencies.
Install with pipx:
pipx install terminal-cells
cells
If pipx or cells is not found, see Installation and PATH.
On Ubuntu 24.04 or 26.04:
sudo add-apt-repository ppa:bogobogosort/cells
sudo apt update
sudo apt install terminal-cells
cells
With Homebrew on macOS or Linux:
brew install kborer/cells/terminal-cells
cells
The package is terminal-cells; the command is cells. From a source checkout, run ./cells. See Ubuntu packages for .deb downloads and builds, or terminal troubleshooting if colors, glyphs, or curses fail.
Use a terminal at least 80×24; 120×40 or larger gives organisms more room. Press q to quit, Space to pause, + / - to change speed, r for a new slide, and ? for help and the species legend.
cells --scene microbial --observe # Microbes, with lifecycle captions
cells --scene blood # A blood-inspired community
cells --calm --theme light # Slower movement on a light background
cells --ascii # Plain ASCII glyphs
cells --screensaver # Exit on any key
Macrophages, neutrophils, red blood cells, nine microbial forms, fungi, and phages share the slide. Watch engulfment, mitosis, budding, viral replication, and rare visitors. Periodic arrivals keep populations varied during long runs.
cells --interactive
Choose 1 Inspect, 2 Lyse, 3 Feed, or 4 Stir, then click to apply. Keyboard targeting also works: arrows or hjkl to aim, Tab to select, Enter to apply. Tools act while the slide keeps moving.
- Command reference: controls, options, and repeatable snapshots.
- Biology: organisms, illustrated life cycles, and simplifications.
- Interactive tools, rare sightings, and colors.
- Terminal compatibility and troubleshooting.
- Changelog and releases.
The GIF uses rendered simulation frames. The 12-second terminal recording captures the curses app; replay it with asciinema play docs/demo.cast after cloning.
Biology suggestions, microscope references, screenshots, and terminal testing are welcome; programming experience is not required. For code or documentation changes, start with the first-change guide and starter issues.
Zero-Clause BSD (0BSD): use, modify, and redistribute for any purpose, without an attribution requirement.
Comments
No comments yet. Start the discussion.