# purplecomputerorg/purplecomputer architecture

> Architecture diagram of the GitHub repository purplecomputerorg/purplecomputer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/purplecomputerorg/purplecomputer
- Repository: https://github.com/purplecomputerorg/purplecomputer

## Overview

Purple Computer is an offline, keyboard-driven environment for children, organized around Play, Music, and Art, with a parent menu for device settings. The main flow is keyboard input into the application, then into a room where children create, explore, or hear a result. The graph also includes speech, audio, code, and power-management layers. The README documents the product and room capabilities; source excerpts and index references support some internal links, but unsampled implementations and dynamic wiring are not asserted.

Main entry points: [`purple_tui/purple_tui.py`](https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/purple_tui.py) (Purple app), [`purple_tui/rooms/play_room.py`](https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/rooms/play_room.py) (Play room), [`purple_tui/tts.py`](https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/tts.py) (Speech synthesis), [`purple_tui/rooms/music_room.py`](https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/rooms/music_room.py) (Music room)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_app_main["Purple app<br/>[purple_tui.py]"]
  node_room_picker["Room picker<br/>[room_picker.py]"]
  node_parent_menu["Parent menu<br/>[parent_menu.py]"]
end

subgraph group_play["Play And Speech"]
  node_play_room["Play room<br/>[play_room.py]"]
  node_play_eval["Play evaluator<br/>[play_eval.py]"]
  node_code["Code runner<br/>[code_runner.py]"]
  node_content["Words and content<br/>[content.py]"]
  node_tts["Speech synthesis<br/>[tts.py]"]
  node_speech_filter["Speech filtering<br/>[speech_filter.py]"]
end

subgraph group_creative["Creative Rooms"]
  node_art_room["Art room<br/>[art_room.py]"]
  node_color_mixing["Color mixing<br/>[color_mixing.py]"]
  node_music_room["Music room<br/>[music_room.py]"]
  node_music_session["Music session<br/>[music_session.py]"]
  node_loop_station["Loop station<br/>[loop_station.py]"]
end

subgraph group_device["Device Services"]
  node_keyboard["Keyboard handling<br/>[keyboard.py]"]
  node_settings["Settings<br/>[settings.py]"]
  node_power["Power manager<br/>[power_manager.py]"]
  node_sleep["Sleep screens<br/>[sleep_screen.py]"]
  node_audio["Audio playback<br/>[audio.py]"]
  node_mixer["Audio mixer<br/>[mixer.py]"]
  node_local_tts["Local TTS engine<br/>[tts_worker.py]"]
end

node_child(("Child"))

node_child -->|"presses keys"| node_keyboard
node_keyboard -->|"emits actions"| node_app_main
node_app_main -->|"opens picker"| node_room_picker
node_app_main -->|"routes input"| node_play_room
node_app_main -->|"routes input"| node_music_room
node_app_main -->|"routes input"| node_art_room
node_app_main -->|"opens menu"| node_parent_menu
node_play_room -->|"evaluates input"| node_play_eval
node_play_room -->|"runs code"| node_code
node_play_room -->|"uses word data"| node_content
node_play_room -->|"requests speech"| node_tts
node_tts -->|"filters text"| node_speech_filter
node_tts -->|"starts worker"| node_local_tts
node_art_room -->|"mixes colors"| node_color_mixing
node_music_room -->|"uses session"| node_music_session
node_music_room -->|"controls loops"| node_loop_station
node_music_room -->|"plays sounds"| node_audio
node_parent_menu -->|"changes settings"| node_settings
node_parent_menu -.->|"manages power"| node_power
node_app_main -->|"tracks activity"| node_power
node_power -.->|"triggers sleep"| node_sleep
node_sleep -->|"requests shutdown"| node_power
node_audio -->|"recovers playback"| node_mixer
node_tts -.->|"plays speech"| node_audio

click node_keyboard "https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/keyboard.py"
click node_app_main "https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/purple_tui.py"
click node_room_picker "https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/room_picker.py"
click node_play_room "https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/rooms/play_room.py"
click node_play_eval "https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/play_eval.py"
click node_code "https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/code_runner.py"
click node_content "https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/content.py"
click node_tts "https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/tts.py"
click node_speech_filter "https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/speech_filter.py"
click node_art_room "https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/rooms/art_room.py"
click node_color_mixing "https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/color_mixing.py"
click node_music_room "https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/rooms/music_room.py"
click node_music_session "https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/music_session.py"
click node_loop_station "https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/loop_station.py"
click node_parent_menu "https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/rooms/parent_menu.py"
click node_settings "https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/settings.py"
click node_power "https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/power_manager.py"
click node_sleep "https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/rooms/sleep_screen.py"
click node_audio "https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/audio.py"
click node_mixer "https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/mixer.py"
click node_local_tts "https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/tts_worker.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app_main,node_room_picker,node_parent_menu toneBlue
class node_play_room,node_play_eval,node_code,node_content,node_tts,node_speech_filter toneAmber
class node_art_room,node_color_mixing,node_music_room,node_music_session,node_loop_station toneMint
class node_keyboard,node_settings,node_power,node_sleep,node_audio,node_mixer,node_local_tts toneRose
class node_child toneIndigo
```

## Components

### Application

- [Purple app](https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/purple_tui.py): `purple_tui/purple_tui.py`
- [Room picker](https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/room_picker.py): `purple_tui/room_picker.py`
- [Parent menu](https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/rooms/parent_menu.py): `purple_tui/rooms/parent_menu.py`

### Play And Speech

- [Play room](https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/rooms/play_room.py): `purple_tui/rooms/play_room.py`
- [Play evaluator](https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/play_eval.py): `purple_tui/play_eval.py`
- [Code runner](https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/code_runner.py): `purple_tui/code_runner.py`
- [Words and content](https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/content.py): `purple_tui/content.py`
- [Speech synthesis](https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/tts.py): `purple_tui/tts.py`
- [Speech filtering](https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/speech_filter.py): `purple_tui/speech_filter.py`

### Creative Rooms

- [Art room](https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/rooms/art_room.py): `purple_tui/rooms/art_room.py`
- [Color mixing](https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/color_mixing.py): `purple_tui/color_mixing.py`
- [Music room](https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/rooms/music_room.py): `purple_tui/rooms/music_room.py`
- [Music session](https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/music_session.py): `purple_tui/music_session.py`
- [Loop station](https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/loop_station.py): `purple_tui/loop_station.py`

### Device Services

- [Keyboard handling](https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/keyboard.py): `purple_tui/keyboard.py`
- [Settings](https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/settings.py): `purple_tui/settings.py`
- [Power manager](https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/power_manager.py): `purple_tui/power_manager.py`
- [Sleep screens](https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/rooms/sleep_screen.py): `purple_tui/rooms/sleep_screen.py`
- [Audio playback](https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/audio.py): `purple_tui/audio.py`
- [Audio mixer](https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/mixer.py): `purple_tui/mixer.py`
- [Local TTS engine](https://github.com/purplecomputerorg/purplecomputer/blob/release/1.x/purple_tui/tts_worker.py): `purple_tui/tts_worker.py`

### Other components

- **Child**

## Connections

- Child → Keyboard handling: presses keys
- Keyboard handling → Purple app: emits actions (evidence: `purple_tui/purple_tui.py`)
- Purple app → Room picker: opens picker (evidence: `purple_tui/purple_tui.py`)
- Purple app → Play room: routes input (evidence: `purple_tui/purple_tui.py`)
- Purple app → Music room: routes input (evidence: `purple_tui/purple_tui.py`)
- Purple app → Art room: routes input (evidence: `purple_tui/purple_tui.py`)
- Purple app → Parent menu: opens menu (evidence: `purple_tui/purple_tui.py`)
- Play room → Play evaluator: evaluates input (evidence: `purple_tui/rooms/play_room.py`)
- Play room → Code runner: runs code (evidence: `purple_tui/rooms/play_room.py`)
- Play room → Words and content: uses word data (evidence: `purple_tui/rooms/play_room.py`)
- Play room → Speech synthesis: requests speech (evidence: `purple_tui/rooms/play_room.py`)
- Speech synthesis → Speech filtering: filters text (evidence: `purple_tui/tts.py`)
- Speech synthesis → Local TTS engine: starts worker (evidence: `purple_tui/tts.py`)
- Art room → Color mixing: mixes colors (evidence: `purple_tui/rooms/art_room.py`)
- Music room → Music session: uses session (evidence: `purple_tui/rooms/music_room.py`)
- Music room → Loop station: controls loops (evidence: `purple_tui/rooms/music_room.py`)
- Music room → Audio playback: plays sounds (evidence: `purple_tui/rooms/music_room.py`)
- Parent menu → Settings: changes settings (evidence: `purple_tui/rooms/parent_menu.py`)
- Parent menu → Power manager: manages power
- Purple app → Power manager: tracks activity (evidence: `purple_tui/purple_tui.py`)
- Power manager → Sleep screens: triggers sleep (evidence: `purple_tui/rooms/sleep_screen.py`)
- Sleep screens → Power manager: requests shutdown (evidence: `purple_tui/rooms/sleep_screen.py`)
- Audio playback → Audio mixer: recovers playback (evidence: `purple_tui/audio.py`)
- Speech synthesis → Audio playback: plays speech (evidence: `purple_tui/tts.py`)
