# sql-hkr/tiny8

A tiny CPU simulator written in Python

Repository: https://github.com/sql-hkr/tiny8
Canonical: https://ross.abutalabs.com/products/tiny8
Homepage: https://sql-hkr.github.io/tiny8/
Language: Python
License: MIT
License Family: permissive
Topics: 8-bit-computer, assembler, visualization
Last push: 2025-12-15T12:40:20+00:00

## Health v2 (maintenance only)
Score: 49/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 57, release rhythm 54, longevity 22
- inputs: {"age_days": 317, "days_push": 261, "days_rel": 305, "gap_med": 5.0, "n_releases_24m": 3}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1368, forks 38 (observed 2026-08-28T04:04:31.642844+00:00)

## What it is
Tiny8 is an educational 8-bit CPU simulator written in Python, featuring an AVR-inspired architecture with 32 registers, a 60+ instruction assembler, and an interactive terminal debugger. It also generates GIF/MP4 animations of program execution for learning and teaching computer architecture.

## Use cases
- learn how a cpu executes assembly instructions
- visualize algorithms like bubble sort running on a simple cpu
- step through assembly code with a debugger
- teach computer architecture fundamentals to students
- generate animated gifs of register and memory changes
- experiment with an avr-inspired 8-bit instruction set

## When to choose
- you want a lightweight, dependency-free way to learn or teach CPU fundamentals
- you need interactive step-by-step debugging with change highlighting
- you want to create visual animations of program execution for presentations

## When to avoid
- you need to simulate real AVR hardware or run actual Arduino firmware
- you require a full-featured emulator for production embedded development
- you need multi-core or 16/32/64-bit CPU simulation

## Facets
- artifact type: application
- maturity: active
- function: simulation, data-visualization, cli, interpreter, developer-tools
- domain: education, computer-vision, developer-tools
- platform: python, cli, cross-platform
- tags: cpu-simulator, 8-bit, assembler, avr, assembly-language, terminal-ui, computer-architecture, educational, algorithms, command-line

## Member repositories
- sql-hkr/tiny8 (main) score 49

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:31.642844+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:41:04.452812+00:00, confidence not recorded.
  - readme: https://github.com/sql-hkr/tiny8 (fetched 2026-08-28T04:04:31.642844+00:00, sha 4447bfa5f6b9)
  - homepage: https://sql-hkr.github.io/tiny8/ (fetched 2026-08-29T11:58:06.402968+00:00, sha 84fc800c900c)
- Data as of 2026-08-30T08:39:29.467469+00:00.