# numworks/epsilon architecture

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

- Interactive diagram: https://gitdiagram.com/numworks/epsilon
- Repository: https://github.com/numworks/epsilon

## Overview

Epsilon is a graphing-calculator operating system with curriculum-focused apps and a browser simulator. The main user journey is entering the calculator, opening an app, supplying mathematical or programming input, and viewing results. The tree shows distinct calculation, graphing, statistics, finance, and coding capabilities; sampled source confirms app-container snapshot management and Python toolbox code, but does not expose most app-to-app or app-to-math-engine wiring. Dashed links mark those unverified transitions.

Main entry points: [`epsilon/apps/home/controller.cpp`](https://github.com/numworks/epsilon/blob/master/epsilon/apps/home/controller.cpp) (Home launcher), [`epsilon/apps/code/app.cpp`](https://github.com/numworks/epsilon/blob/master/epsilon/apps/code/app.cpp) (Python coding), [`poincare/src`](https://github.com/numworks/epsilon/tree/master/poincare/src) (Poincare engine), [`epsilon/apps/apps_container_storage.cpp`](https://github.com/numworks/epsilon/blob/master/epsilon/apps/apps_container_storage.cpp) (App container)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Calculator runtime"]
  node_runtime["App container"]
  node_home["Home launcher<br/>[controller.cpp]"]
  node_hardware["Hardware checkup<br/>[app.cpp]"]
  node_settings["Settings"]
end

subgraph group_math["Math applications"]
  node_calculator["Calculation<br/>[app.cpp]"]
  node_graph["Graphing<br/>[app.cpp]"]
  node_solver["Equation solver"]
  node_mathengine["Poincare engine"]
end

subgraph group_analysis["Analysis applications"]
  node_distributions["Distributions<br/>[app.cpp]"]
  node_inference["Statistical inference<br/>[app.cpp]"]
  node_regression["Regression"]
  node_finance["Finance<br/>[app.cpp]"]
  node_elements["Periodic elements<br/>[app.cpp]"]
end

subgraph group_tools["Tools and coding"]
  node_code["Python coding<br/>[app.cpp]"]
  node_toolbox["Python toolbox"]
  node_console["Code console"]
  node_scripts[("Script management<br/>[script_store.cpp]")]
  node_externalapps["External apps"]
end

node_user(("Calculator user"))

node_user -->|"uses"| node_runtime
node_runtime -->|"includes snapshot"| node_home
node_home -.->|"opens app"| node_calculator
node_home -.->|"opens app"| node_graph
node_home -.->|"opens app"| node_solver
node_home -.->|"opens app"| node_distributions
node_home -.->|"opens app"| node_inference
node_home -.->|"opens app"| node_regression
node_home -.->|"opens app"| node_finance
node_home -.->|"opens app"| node_elements
node_home -.->|"opens app"| node_code
node_home -.->|"opens app"| node_hardware
node_home -.->|"opens app"| node_settings
node_calculator -.->|"uses math"| node_mathengine
node_graph -.->|"uses math"| node_mathengine
node_solver -.->|"uses math"| node_mathengine
node_code -.->|"provides toolbox"| node_toolbox
node_code -.->|"runs console"| node_console
node_code -.->|"manages scripts"| node_scripts

click node_runtime "https://github.com/numworks/epsilon/blob/master/epsilon/apps/apps_container_storage.cpp"
click node_home "https://github.com/numworks/epsilon/blob/master/epsilon/apps/home/controller.cpp"
click node_calculator "https://github.com/numworks/epsilon/blob/master/epsilon/apps/calculation/app.cpp"
click node_graph "https://github.com/numworks/epsilon/blob/master/epsilon/apps/graph/app.cpp"
click node_solver "https://github.com/numworks/epsilon/blob/master/epsilon/apps/solver/solutions_controller.cpp"
click node_mathengine "https://github.com/numworks/epsilon/tree/master/poincare/src"
click node_distributions "https://github.com/numworks/epsilon/blob/master/epsilon/apps/distributions/app.cpp"
click node_inference "https://github.com/numworks/epsilon/blob/master/epsilon/apps/inference/app.cpp"
click node_regression "https://github.com/numworks/epsilon/tree/master/epsilon/apps/regression"
click node_finance "https://github.com/numworks/epsilon/blob/master/epsilon/apps/finance/app.cpp"
click node_elements "https://github.com/numworks/epsilon/blob/master/epsilon/apps/elements/app.cpp"
click node_code "https://github.com/numworks/epsilon/blob/master/epsilon/apps/code/app.cpp"
click node_toolbox "https://github.com/numworks/epsilon/blob/master/epsilon/apps/code/python_toolbox_controller.cpp"
click node_console "https://github.com/numworks/epsilon/blob/master/epsilon/apps/code/console_controller.cpp"
click node_scripts "https://github.com/numworks/epsilon/blob/master/epsilon/apps/code/script_store.cpp"
click node_externalapps "https://github.com/numworks/epsilon/tree/master/epsilon/external_apps"
click node_hardware "https://github.com/numworks/epsilon/blob/master/epsilon/apps/hardware_checkup/app.cpp"
click node_settings "https://github.com/numworks/epsilon/blob/master/epsilon/apps/settings/main_controller.cpp"

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_runtime,node_home,node_hardware,node_settings,node_user toneBlue
class node_calculator,node_graph,node_solver,node_mathengine toneAmber
class node_distributions,node_inference,node_regression,node_finance,node_elements toneMint
class node_code,node_toolbox,node_console,node_scripts,node_externalapps toneRose
```

## Components

### Calculator runtime

- [App container](https://github.com/numworks/epsilon/blob/master/epsilon/apps/apps_container_storage.cpp): `epsilon/apps/apps_container_storage.cpp`
- [Home launcher](https://github.com/numworks/epsilon/blob/master/epsilon/apps/home/controller.cpp): `epsilon/apps/home/controller.cpp`
- [Hardware checkup](https://github.com/numworks/epsilon/blob/master/epsilon/apps/hardware_checkup/app.cpp): `epsilon/apps/hardware_checkup/app.cpp`
- [Settings](https://github.com/numworks/epsilon/blob/master/epsilon/apps/settings/main_controller.cpp): `epsilon/apps/settings/main_controller.cpp`

### Math applications

- [Calculation](https://github.com/numworks/epsilon/blob/master/epsilon/apps/calculation/app.cpp): `epsilon/apps/calculation/app.cpp`
- [Graphing](https://github.com/numworks/epsilon/blob/master/epsilon/apps/graph/app.cpp): `epsilon/apps/graph/app.cpp`
- [Equation solver](https://github.com/numworks/epsilon/blob/master/epsilon/apps/solver/solutions_controller.cpp): `epsilon/apps/solver/solutions_controller.cpp`
- [Poincare engine](https://github.com/numworks/epsilon/tree/master/poincare/src): `poincare/src`

### Analysis applications

- [Distributions](https://github.com/numworks/epsilon/blob/master/epsilon/apps/distributions/app.cpp): `epsilon/apps/distributions/app.cpp`
- [Statistical inference](https://github.com/numworks/epsilon/blob/master/epsilon/apps/inference/app.cpp): `epsilon/apps/inference/app.cpp`
- [Regression](https://github.com/numworks/epsilon/tree/master/epsilon/apps/regression): `epsilon/apps/regression`
- [Finance](https://github.com/numworks/epsilon/blob/master/epsilon/apps/finance/app.cpp): `epsilon/apps/finance/app.cpp`
- [Periodic elements](https://github.com/numworks/epsilon/blob/master/epsilon/apps/elements/app.cpp): `epsilon/apps/elements/app.cpp`

### Tools and coding

- [Python coding](https://github.com/numworks/epsilon/blob/master/epsilon/apps/code/app.cpp): `epsilon/apps/code/app.cpp`
- [Python toolbox](https://github.com/numworks/epsilon/blob/master/epsilon/apps/code/python_toolbox_controller.cpp): `epsilon/apps/code/python_toolbox_controller.cpp`
- [Code console](https://github.com/numworks/epsilon/blob/master/epsilon/apps/code/console_controller.cpp): `epsilon/apps/code/console_controller.cpp`
- [Script management](https://github.com/numworks/epsilon/blob/master/epsilon/apps/code/script_store.cpp): `epsilon/apps/code/script_store.cpp`
- [External apps](https://github.com/numworks/epsilon/tree/master/epsilon/external_apps): `epsilon/external_apps`

### Other components

- **Calculator user**

## Connections

- Calculator user → App container: uses
- App container → Home launcher: includes snapshot (evidence: `epsilon/apps/apps_container_storage.cpp`)
- Home launcher → Calculation: opens app
- Home launcher → Graphing: opens app
- Home launcher → Equation solver: opens app
- Home launcher → Distributions: opens app
- Home launcher → Statistical inference: opens app
- Home launcher → Regression: opens app
- Home launcher → Finance: opens app
- Home launcher → Periodic elements: opens app
- Home launcher → Python coding: opens app
- Home launcher → Hardware checkup: opens app
- Home launcher → Settings: opens app
- Calculation → Poincare engine: uses math
- Graphing → Poincare engine: uses math
- Equation solver → Poincare engine: uses math
- Python coding → Python toolbox: provides toolbox
- Python coding → Code console: runs console
- Python coding → Script management: manages scripts
