____________  ______  ______
  / ____/ __ \ \/ / __ \/_  __/
 / /   / /_/ /\  / /_/ / / /
/ /___/ _, _/ / / ____/ / /
\____/_/ |_| /_/_/     /_/

   __________  ___ _       ____    __________
  / ____/ __ \/   | |     / / /   / ____/ __ \
 / /   / /_/ / /| | | /| / / /   / __/ / /_/ /
/ /___/ _, _/ ___ | |/ |/ / /___/ /___/ _, _/
\____/_/ |_/_/  |_|__/|__/_____/_____/_/ |_|

A terminal roguelike where every room is narrated live.
No two runs are ever the same.

---

What is this?

CryptCrawler is a text roguelike where the dungeon is generated in real time — rooms, monsters, atmosphere, and loot are all narrated on the fly by Gemini. Every playthrough is unique. No prewritten templates, no repeated descriptions.

Think Zork, but the dungeon master never sleeps and never runs out of ideas.

  ▓ DEPTH 4

  A former library, its shelves long since collapsed. Tomes lie
  scattered across the floor, their pages turned to black mulch.
  Something has nested in the far corner — recently.

  ╰─ You hear the rustle of pages turning, though there is no wind.

  ⚔  A Shadow Wraith stands before you!  [9 HP]
  ◆  You spot: silver dagger

  Exits: NORTH │ EAST
  ♥ [████████░░░░] 12/20  ATK:6  Items:3

  [north / east]  [i] inventory  [q] quit
  › 

---

Features

• Live narration — each room description is generated fresh, shaped by your depth, HP, and inventory
• Contextual generation — the dungeon master remembers recent rooms and avoids repetition
• Scaling danger — monsters grow stronger the deeper you go
• Loot that matters — weapons boost your attack, potions restore health
• Graceful fallback — if Gemini is unavailable, hand-crafted rooms keep the game running
• Zero dependencies — pure Python stdlib, no packages to install

---

Requirements

• Python 3.8+
• Gemini CLI installed and authenticated

# verify Gemini CLI is ready
gemini -p "say hello"

---

Install & Run

git clone https://github.com/serhiizghama/cryptcrawler.git
cd cryptcrawler

CryptCrawler ships in two flavours — both pure stdlib, no pip install.

2D mode (browser, top-down) — a procedurally generated map drawn on a canvas, rooms and tunnels built in code, each room narrated live by Gemini:

python3 server.py
# then open http://localhost:8000

Classic mode (terminal, text) — the original text crawler:

python3 cryptcrawler.py

Use python3, not python — on machines where python is unset (e.g. a bare pyenv install) the plain command won't resolve.

---

How to Play

2D mode — walk with the arrow keys or WASD. Bump into a monster to attack it. Pick up loot by stepping onto it (weapons add +2 ATK, potions heal). Find the > stairs to descend to a deeper, deadlier level. Fog of war hides what you haven't explored yet.

Classic (terminal) mode:

Input	Action
north / n	Move north
south / s	Move south
east / e	Move east
west / w	Move west
i	Open inventory
q	Quit
ENTER	Advance combat round

Combat is turn-based — you and the monster trade blows until one falls. Weapons found in rooms increase your damage permanently.

---

Architecture

server.py         — stdlib HTTP server: serves the 2D client, bridges narration
web/              — canvas client: procedural map, top-down renderer, combat (JS)
cryptcrawler.py   — classic terminal game loop, combat, renderer
dungeon.py        — Gemini integration, room parsing, fallback logic (shared)

Both modes share dungeon.py: Gemini receives the current game state (HP, depth, recent rooms, inventory) and returns a JSON room object — description, atmosphere, monster, and loot. The 2D client generates the layout (rooms, tunnels, fog) itself in code, and uses Gemini purely for the prose and the creatures that fill each room. If the call fails or times out, a hand-written fallback room is used instead — the game never breaks.

---

Roadmap

• Save / load runs
• Boss encounters at depth milestones
• Named artifacts with lore
• Map of explored rooms (2D mode)
• Multiple dungeon themes (catacombs, ruins, abyssal deep)

---

License

MIT — do whatever you want with it.