# Keygarden

A touch-typing workout studio with a garden mascot, synthesised key clicks, 20 progressive lessons, timed workouts, streaks, XP and per-key feedback.

**Status:** Private · Projects · 2026

- **Local checkout:** `/Users/simon/Developer/keygarden` (branch `main`, last commit f6c4638, 2026-10-15 — Show enlarged hand placement on Delete without erasing progress)
- **Uncommitted changes:** 2 file(s) at brief generation time
- **Repository:** https://github.com/ShimonNavon/keygarden
- **On another machine:** `git clone https://github.com/ShimonNavon/keygarden` — the paths below are Simon's Mac
- **Live:** http://ubuntu03:30090/
- **Where it runs:** namespace keygarden · NodePort 30090 · tailnet only

## Stack

Python 3.12 stdlib server, Buildless ES modules, Ollama qwen3:4b-instruct, Kubernetes, SQLite PVC

## Start here

- `server.py` — dependency-free app server and API
- `public/` — browser app: practice, lessons, progress, chat
- `learning.py` — adaptive learning engine
- `deploy/app.yaml` — studio and coach Deployments, PVCs, NodePort
- `build.py` — build step if any
- `tests/` — focused tests

## Commands

- **Development:** `see README (ACCESS_KEY and python3 server.py)`
- **Deploy:** `see README; deploy/app.yaml + build.py`

## Deploy and where it runs

- Namespace keygarden, NodePort 30090 on ubuntu03, externalTrafficPolicy Local.
- Deployments studio and coach; PVCs progress (SQLite) and models (Ollama model).
- Tailnet only, authenticated by an access key exchanged for an HttpOnly cookie.

## Current state

Live and private. Local model qwen3:4b-instruct; no paid AI provider.

## Watch out

- Requires ACCESS_KEY (at least 24 chars); the personal link and key are in .private/.
- The hand guide is instructional only; no camera or raw key-event logging. Do not add tracking.
- AI can take 30-60 s; fallbacks must stay honest and clearly labelled ai/adaptive/lesson.
- Do not expose publicly without HTTPS; the service is tailnet-only by design.

## Secrets — locations only, never print values

- .private/access-key.txt and .private/open-studio.html (keep private).

## Tags

Game, Kubernetes

---

Brief generated 2026-11-08 from `~/Developer/my-projects/context/`. Canonical URL: https://projects.navonsimon.com/context/keygarden.md
