⌨ TYPEFASTER

A terminal-first typing game inspired by MonkeyType and TypeRacer — race quotes, beat your ghost, climb leaderboards, and play live multiplayer with friends. Pure TUI, no browser, no GUI.

brew install Anoshor/typefaster/typefaster   # or: pipx install typefaster-cli
typefaster

Install

Homebrew (macOS / Linux)

brew install Anoshor/typefaster/typefaster
# or tap once, then use the short name:
brew tap anoshor/typefaster && brew install typefaster

pipx (any OS with Python 3.11+) — fastest install

pipx install typefaster-cli

Verify: typefaster version · Upgrade: brew upgrade typefaster or pipx upgrade typefaster-cli

Play (offline — no account, no internet)

Just run it:

typefaster

Keyboard-only menu:

• Quick Race — a fresh random quote each time; race your personal-best ghost.
• Time Attack — type for 30 / 60 / 120s (←/→ to change the duration inline).
• Practice — pick a mode/ghost.
• Daily Challenge — same quote for everyone each day, local leaderboard.
• 🎯 Typing Coach — see the keys you miss most, a per-key accuracy heatmap, and finger-position tips; press d to launch a drill weighted toward your weak keys. All computed locally — no account, no internet, no AI service.
• Stats / History / Profile / Leaderboard / Settings.

Practice modes (MonkeyType-style): in Settings, toggle Lowercase only or Words only (pure a–z, no punctuation or numbers) to strip the text down.

Live WPM, accuracy, progress, and an animated ghost bar. Backspace corrects mistakes (original errors still count, MonkeyType-style). All progress is saved locally in SQLite.

Direct commands too:

typefaster race                      # quote race
typefaster race --mode time --time 60
typefaster daily
typefaster stats   |   typefaster history

Play online (multiplayer lobbies)

It works out of the box against the public server — no setup. From the main menu pick Account to register/login, then Play Online:

Account      → Register / Login (password, GitHub, or Google)
Play Online  → ➕ Create a lobby  → share the join code
             → or type a friend's code + Enter to join

In the waiting room press R to ready; the server runs the countdown, sends everyone the same quote, shows live progress bars, and scores results authoritatively (with anti-cheat). Esc leaves.

Prefer the CLI?

typefaster register <name>      # or: typefaster login --github / --google
typefaster lobby create --name "Friday" --time 60
typefaster lobby join ABC123
typefaster leaderboard global   # global | daily | weekly

Self-host the server (optional)

The game ships pointing at a public server, but you can run your own:

git clone https://github.com/Anoshor/typefaster-cli && cd typefaster-cli
cp .env.example .env            # set TYPEFASTER_JWT_SECRET
make up                         # Redis + FastAPI server on :8000 (Docker)
typefaster config set-server http://localhost:8000

Deploy guides: docs/deploy-oracle.md (free 24/7 VM) · docs/deploy-fly.md · TLS + hardening in docs/SECURITY-REVIEW.md.

How it works

• Client: Python · Typer (CLI) · Textual + Rich (TUI) · SQLite (local progress) · httpx + websockets (online).
• Server: FastAPI · WebSockets · Redis · Pydantic — server-authoritative race timing and scoring.
• Deep dive: docs/DEEPDIVE.md · architecture: docs/architecture.md.

Develop

make install     # editable install + dev deps
make play        # run it
make check       # ruff + mypy + pytest  (CI parity)

Contributions welcome! main is protected — fork, branch, and open a PR; CI must pass and a maintainer review is required before merge. Full guide: CONTRIBUTING.md.

License

MIT — see LICENSE. Crafted by Anoshor Paul.