# abd19990044-commits/pynexus architecture

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

- Interactive diagram: https://gitdiagram.com/abd19990044-commits/pynexus
- Repository: https://github.com/abd19990044-commits/pynexus

## Overview

PyNexus is a recovered Android app overlay that preserves the original Python-script runtime and adds a token-protected HTTP API. The main workflow is: a user views the token and toggles the API in the dashboard; an API client sends authenticated requests to the server, which is documented to restrict access to registered app-folder Python scripts. The tree and excerpts do not expose the smali implementations, so internal wiring is shown only where the README supports it; unverified links are dashed.

Main entry points: [`overlay/smali_classes3/com/pyscript/manager/ApiServer.smali`](https://github.com/abd19990044-commits/pynexus/blob/main/overlay/smali_classes3/com/pyscript/manager/ApiServer.smali) (HTTP API server), [`overlay/smali_classes3/com/pyscript/manager/ScriptsFragment.smali`](https://github.com/abd19990044-commits/pynexus/blob/main/overlay/smali_classes3/com/pyscript/manager/ScriptsFragment.smali) (Registered Python scripts), [`overlay/smali_classes3/com/pyscript/manager/MainActivity.smali`](https://github.com/abd19990044-commits/pynexus/blob/main/overlay/smali_classes3/com/pyscript/manager/MainActivity.smali) (Main activity), [`overlay/smali_classes3/com/pyscript/manager/ApiControl.smali`](https://github.com/abd19990044-commits/pynexus/blob/main/overlay/smali_classes3/com/pyscript/manager/ApiControl.smali) (API controls)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["App interface"]
  node_main["Main activity<br/>[MainActivity.smali]"]
  node_dashboard["Dashboard"]
  node_scripts["Scripts screen"]
end

subgraph group_api["API access"]
  node_api_control["API controls<br/>[ApiControl.smali]"]
  node_api_server["HTTP API server<br/>[ApiServer.smali]"]
end

subgraph group_runtime["Script runtime"]
  node_app["App initialization<br/>[App.smali]"]
  node_registered_scripts[("Registered Python scripts")]
  node_python_runtime["Python runtime"]
end

node_user(("App user"))
node_client(("API client"))

node_user -.->|"opens app"| node_main
node_main -.->|"shows dashboard"| node_dashboard
node_user -->|"views token"| node_dashboard
node_user -->|"toggles API"| node_api_control
node_api_control -.->|"starts or stops"| node_api_server
node_client -->|"sends requests"| node_api_server
node_api_server -->|"restricts routes to"| node_registered_scripts
node_scripts -.->|"manages scripts"| node_registered_scripts
node_registered_scripts -->|"runs scripts on"| node_python_runtime
node_app -->|"preserves runtime"| node_python_runtime

click node_main "https://github.com/abd19990044-commits/pynexus/blob/main/overlay/smali_classes3/com/pyscript/manager/MainActivity.smali"
click node_dashboard "https://github.com/abd19990044-commits/pynexus/blob/main/overlay/smali_classes3/com/pyscript/manager/DashboardFragment.smali"
click node_scripts "https://github.com/abd19990044-commits/pynexus/blob/main/overlay/smali_classes3/com/pyscript/manager/ScriptsFragment.smali"
click node_api_control "https://github.com/abd19990044-commits/pynexus/blob/main/overlay/smali_classes3/com/pyscript/manager/ApiControl.smali"
click node_api_server "https://github.com/abd19990044-commits/pynexus/blob/main/overlay/smali_classes3/com/pyscript/manager/ApiServer.smali"
click node_app "https://github.com/abd19990044-commits/pynexus/blob/main/overlay/smali_classes3/com/pyscript/manager/App.smali"
click node_registered_scripts "https://github.com/abd19990044-commits/pynexus/blob/main/overlay/smali_classes3/com/pyscript/manager/ScriptsFragment.smali"

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_main,node_dashboard,node_scripts,node_user,node_client toneBlue
class node_api_control,node_api_server toneAmber
class node_app,node_registered_scripts,node_python_runtime toneMint
```

## Components

### App interface

- [Main activity](https://github.com/abd19990044-commits/pynexus/blob/main/overlay/smali_classes3/com/pyscript/manager/MainActivity.smali): `overlay/smali_classes3/com/pyscript/manager/MainActivity.smali`
- [Dashboard](https://github.com/abd19990044-commits/pynexus/blob/main/overlay/smali_classes3/com/pyscript/manager/DashboardFragment.smali): `overlay/smali_classes3/com/pyscript/manager/DashboardFragment.smali`
- [Scripts screen](https://github.com/abd19990044-commits/pynexus/blob/main/overlay/smali_classes3/com/pyscript/manager/ScriptsFragment.smali): `overlay/smali_classes3/com/pyscript/manager/ScriptsFragment.smali`

### API access

- [API controls](https://github.com/abd19990044-commits/pynexus/blob/main/overlay/smali_classes3/com/pyscript/manager/ApiControl.smali): `overlay/smali_classes3/com/pyscript/manager/ApiControl.smali`
- [HTTP API server](https://github.com/abd19990044-commits/pynexus/blob/main/overlay/smali_classes3/com/pyscript/manager/ApiServer.smali): `overlay/smali_classes3/com/pyscript/manager/ApiServer.smali`

### Script runtime

- [App initialization](https://github.com/abd19990044-commits/pynexus/blob/main/overlay/smali_classes3/com/pyscript/manager/App.smali): `overlay/smali_classes3/com/pyscript/manager/App.smali`
- [Registered Python scripts](https://github.com/abd19990044-commits/pynexus/blob/main/overlay/smali_classes3/com/pyscript/manager/ScriptsFragment.smali): `overlay/smali_classes3/com/pyscript/manager/ScriptsFragment.smali`
- **Python runtime**

### Other components

- **App user**
- **API client**

## Connections

- App user → Main activity: opens app
- Main activity → Dashboard: shows dashboard
- App user → Dashboard: views token (evidence: `README.md`)
- App user → API controls: toggles API (evidence: `README.md`)
- API controls → HTTP API server: starts or stops
- API client → HTTP API server: sends requests (evidence: `README.md`)
- HTTP API server → Registered Python scripts: restricts routes to (evidence: `README.md`)
- Scripts screen → Registered Python scripts: manages scripts
- Registered Python scripts → Python runtime: runs scripts on (evidence: `README.md`)
- App initialization → Python runtime: preserves runtime (evidence: `README.md`)