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

You can also use plain pip inside a virtual environment (pip install the-nest), or try it without installing anything:

python3 -m the_nest      # from the source folder: PYTHONPATH=src python3 -m 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.0

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.0
File Size Uploaded Provenance
the_nest-1.0.0.tar.gz 20.2 kB Without provenance Details

Built distribution (wheel)

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

Total release size: 39.2 kB

Release files / the_nest-1.0.0.tar.gz

Download URL the_nest-1.0.0.tar.gz
Size 20.2 kB
Tags Source
SHA-256 checksum
How to use checksums
33b865006d08efb99e67adb9227d02b2b568c06a46f3f2ce1569287f6a9b2017
BLAKE2b-256 checksum
How to use checksums
935d4118d51169e920c51a77ed0fbd4b5c03a72e4133a55319c83cf4f9e76780
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.0-py3-none-any.whl

Download URL the_nest-1.0.0-py3-none-any.whl
Size 19.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7b594276f3553d84045565d6bd38f59743afe638aaaf8063c84d01ea05c744e4
BLAKE2b-256 checksum
How to use checksums
ab27ec5a1a7297ac01178abd9bee49477bfaac4b8ad295dce564692c06c2fb6f
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.0

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.0 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