Skip to main content

THE NEST

A tiny ASCII arcade shooter for the terminal, by sata.

Space dragons crawl across the sky above their nest, laying eggs as they go. The eggs warm up (white, yellow, red) and hatch into little dragons that dive straight at you. Shoot the heads, split the bodies, and don't let them hatch.

 SCORE 000200                   WAVE 1                HI-SCORE 005000
+--------------------------------------------------------------------+
|                           \,_.-~^^^~-._,/                          |
|                             \__.---.__/                            |
|                               `-----'                              |
|                                                                    |
|                             __________-^                           |
|                            {oOoOoOoOoO: o{                         |
|                                        -"                          |
|                    .-.                                             |
|                    (_)                          /o\                |
|                                                 \"/                |
|                                                                    |
|                                 /"\                                |
|                                [=0=]                               |
+--------------------------------------------------------------------+
 /"\ /"\ /"\

Pure Python and the standard library. No graphics, no extra downloads: it runs in any terminal, over SSH, and on the bare console of a Linux server.

Install

The easiest way is pipx, which installs command-line programs in their own little space:

pipx install the-nest

Then just type:

thenest

Want to try it first, without installing anything?

pipx run the-nest

You can also use plain pip inside a virtual environment: pip install the-nest.

How to play

Key Action
Arrows / A D Move
Space Fire (one shot at a time)
P Pause
Q Quit
  • Dragon head: 100 points, plus 10 for every body segment. Long dragons are worth more.
  • Dragon body: 20 points, and the dragon splits in two. The tail turns around and keeps going.
  • Egg: 10 points. Hatchling: 30 points. If a hatchling reaches the ground, you lose a life.
  • Extra life every 2000 points.
  • Every 3 waves there is a bonus stage: the hatchlings line up in formation. Shoot them all before time runs out for a PERFECT bonus.

Your top 10 is saved in ~/.the_nest_scores.

Requirements

  • Python 3.8 or newer
  • A terminal of at least 62 x 26 characters (bigger is better)
  • Linux and macOS work out of the box. On Windows, pip installs windows-curses automatically; use Windows Terminal.

On the Linux text console the game switches to a large font while you play and restores yours when you quit. Use thenest --normal-font to keep your font.

Credits

  • Game design, art direction, ASCII art and playtesting: sata
  • Programming: written with Claude, an AI assistant made by Anthropic, directed and reviewed by sata

License

MIT. Made by sata, 2026.

You're free to play it, change it and share it. If you make your own version, a credit like "original game by sata" is appreciated.

Metadata

Release files for the-nest 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for the-nest 1.0.1
File Size Uploaded Provenance
the_nest-1.0.1.tar.gz 20.2 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for the-nest 1.0.1
File Interpreter ABI Platform
the_nest-1.0.1-py3-none-any.whl Python 3 none any Details

Total release size: 39.2 kB

Release files / the_nest-1.0.1.tar.gz

Download URL the_nest-1.0.1.tar.gz
Size 20.2 kB
Tags Source
SHA-256 checksum
How to use checksums
35c1e64476d3c1b35e7b129af0a3d878f3a880767f0d0fbbbb998bef37e3a6e0
BLAKE2b-256 checksum
How to use checksums
52d760741c19baba9f243e03a83e437877d692f376dcfd34e5ea7e7137a0c184
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.15.0

Release files / the_nest-1.0.1-py3-none-any.whl

Download URL the_nest-1.0.1-py3-none-any.whl
Size 19.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
eb18ca17dea604973445ed607ba8737cf3eb3f1e0a2cd8e528348669b20fbe83
BLAKE2b-256 checksum
How to use checksums
5cad8ad1b9c4e6731deb9877f34ddb38b6d45bd0f9bb738fdeadc1715695b4a3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.15.0

Security for the-nest 1.0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page