octopus-invaders

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

octopus-invaders

★ 98 Open GitHub ↗

A pixel art space shooter built entirely by a 9B AI model on a single RTX 3060. Zero hand-written code.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Octopus Invaders

A pixel art space shooter built entirely by a 9B parameter AI model running locally on a single RTX 3060.

## The Experiment

One prompt. One GPU. Zero hand-written code.

- **Model:** Qwen 3.5 9B Q4_K_M
- **Hardware:** RTX 3060 12GB
- **Agent:** Hermes Agent by NousResearch
- **Inference:** llama.cpp at 35-50 tok/s
- **Context:** 128K tokens
- **Iterations:** 4 phases, ~6 prompts total
- **Lines of code:** 3,263 across 13 files

## What the AI Built

- Pixel art octopus enemies (4 types + boss)
- Particle effects and screen shake
- Procedural audio (no audio files)
- 4-layer parallax background
- Combo system and score tracking
- Level progression with wave clearing
- Boss fights at level 5+
- Power-up drops (health + weapon boost)
- Upgrade tier system
- Full game loop: menu > play > pause > game over > restart

## How to Run

```bash
cd space-shooter
python3 -m http.server 8000
```

Open `localhost:8000` in your browser.

## Controls

- **Mouse** - Move ship
- **Click** - Shoot
- **ESC** - Pause/Resume

## The Stack

```
RTX 3060 12GB ($250 used on ebay)
  └── llama.cpp (CUDA, flash attention, q4_0 KV cache)
      └── Qwen 3.5 9B Q4_K_M (5.3GB GGUF)
          └── Hermes Agent (31 tools, 11 model-specific parsers)
              └── This game
```

## Iteration History

| Phase | What | Bugs Found | Result |
|-------|------|------------|--------|
| Initial | Full game from single prompt | Blank screen | 3,263 lines, 13 files |
| Iteration 2 | Bug fixes from bug list | 9 bugs | Game playable |
| Iteration 3 Phase 0 | Enemies array fix | Variable mismatch | Enemies appear |
| Iteration 3 Phase 1 | Start flow fix | Dual start system | Clean game entry |
| Iteration 3 Phase 3+4 | Levels + bullets | Level stuck at 1, 32px bullets | Progression works |
| Final | Spawn timing fix | initEnemies called too early | Game complete |

## Prompts

See `prompts/octopus_invaders_prompt.md` for the exact prompt used to generate the initial game.

See `prompts/iteration3_plan.md` for all iteration prompts and tracking.

## License

MIT

## Built by

[@sudoingX](https://x.com/sudoingX) using Hermes Agent by [@NousResearch](https://x.com/NousResearch)

octopus-invaders

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README