# abhinavsingh2403/schrodinger-s-server architecture

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

- Interactive diagram: https://gitdiagram.com/abhinavsingh2403/schrodinger-s-server
- Repository: https://github.com/abhinavsingh2403/schrodinger-s-server

## Overview

Schrödinger’s Server is a research-stage, cost-aware SSH honeypot project: it studies SSH session value, then aims to route promising visitors to richer deception. The implemented workflow verifies the downloaded dataset, analyzes session base rates, and records results; a separate PoC demonstrates per-session persona selection. The README also describes planned Experiment 0, gatekeeper, visitor memory, persona configuration, cost model, and dashboard stages. Those planned components are represented at their documented directory paths; their runtime wiring is not shown in the sampled source.

Main entry points: [`analysis/s3_base_rates.py`](https://github.com/abhinavsingh2403/schrodinger-s-server/blob/main/analysis/s3_base_rates.py) (Base-rate analysis), [`sensor`](https://github.com/abhinavsingh2403/schrodinger-s-server/tree/main/sensor) (T1/T2 personas), [`sensor/spike_s1_poc.py`](https://github.com/abhinavsingh2403/schrodinger-s-server/blob/main/sensor/spike_s1_poc.py) (Persona PoC), [`analysis/verify_download.py`](https://github.com/abhinavsingh2403/schrodinger-s-server/blob/main/analysis/verify_download.py) (Download verifier)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_research["Data research"]
  node_dataset["SSH session data"]
  node_verifier["Download verifier<br/>[verify_download.py]"]
  node_base_rates["Base-rate analysis<br/>[s3_base_rates.py]"]
  node_results["Base-rate results<br/>[base_rates.json]"]
end

subgraph group_experiment["Persona experiment"]
  node_experiment0["Experiment 0<br/>[EXPERIMENT0.md]"]
  node_persona_poc["Persona PoC<br/>[spike_s1_poc.py]"]
  node_cowrie["Cowrie honeypot"]
end

subgraph group_routing["Adaptive routing"]
  node_gatekeeper["Gatekeeper features"]
  node_visitor_memory[("Visitor memory")]
  node_persona_configs["T1/T2 personas"]
end

subgraph group_operations["Cost and visibility"]
  node_cost_model["Cost model"]
  node_dashboard["Results dashboard"]
end

node_analyst(("Researcher"))

node_analyst -->|"verifies download"| node_verifier
node_verifier -->|"checks checksum"| node_dataset
node_analyst -->|"analyzes sessions"| node_base_rates
node_base_rates -->|"analyzes data"| node_dataset
node_base_rates -->|"computes rates"| node_results
node_analyst -->|"runs protocol"| node_experiment0
node_persona_poc -->|"assigns personas"| node_cowrie
node_persona_poc -->|"selects persona"| node_persona_configs
node_experiment0 -->|"evaluates features"| node_gatekeeper
node_gatekeeper -->|"uses memory"| node_visitor_memory
node_visitor_memory -->|"informs selection"| node_persona_configs
node_persona_configs -->|"informs costing"| node_cost_model
node_cost_model -->|"feeds results"| node_dashboard

click node_dataset "https://github.com/abhinavsingh2403/schrodinger-s-server/tree/main/data"
click node_verifier "https://github.com/abhinavsingh2403/schrodinger-s-server/blob/main/analysis/verify_download.py"
click node_base_rates "https://github.com/abhinavsingh2403/schrodinger-s-server/blob/main/analysis/s3_base_rates.py"
click node_results "https://github.com/abhinavsingh2403/schrodinger-s-server/blob/main/results/base_rates.json"
click node_experiment0 "https://github.com/abhinavsingh2403/schrodinger-s-server/blob/main/EXPERIMENT0.md"
click node_persona_poc "https://github.com/abhinavsingh2403/schrodinger-s-server/blob/main/sensor/spike_s1_poc.py"
click node_gatekeeper "https://github.com/abhinavsingh2403/schrodinger-s-server/tree/main/gatekeeper"
click node_visitor_memory "https://github.com/abhinavsingh2403/schrodinger-s-server/tree/main/gatekeeper"
click node_persona_configs "https://github.com/abhinavsingh2403/schrodinger-s-server/tree/main/sensor"
click node_cost_model "https://github.com/abhinavsingh2403/schrodinger-s-server/tree/main/dashboard"
click node_dashboard "https://github.com/abhinavsingh2403/schrodinger-s-server/tree/main/dashboard"

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_dataset,node_verifier,node_base_rates,node_results toneBlue
class node_experiment0,node_persona_poc,node_cowrie toneAmber
class node_gatekeeper,node_visitor_memory,node_persona_configs toneMint
class node_cost_model,node_dashboard toneRose
class node_analyst toneIndigo
```

## Components

### Data research

- [SSH session data](https://github.com/abhinavsingh2403/schrodinger-s-server/tree/main/data): `data`
- [Download verifier](https://github.com/abhinavsingh2403/schrodinger-s-server/blob/main/analysis/verify_download.py): `analysis/verify_download.py`
- [Base-rate analysis](https://github.com/abhinavsingh2403/schrodinger-s-server/blob/main/analysis/s3_base_rates.py): `analysis/s3_base_rates.py`
- [Base-rate results](https://github.com/abhinavsingh2403/schrodinger-s-server/blob/main/results/base_rates.json): `results/base_rates.json`

### Persona experiment

- [Experiment 0](https://github.com/abhinavsingh2403/schrodinger-s-server/blob/main/EXPERIMENT0.md): `EXPERIMENT0.md`
- [Persona PoC](https://github.com/abhinavsingh2403/schrodinger-s-server/blob/main/sensor/spike_s1_poc.py): `sensor/spike_s1_poc.py`
- **Cowrie honeypot**

### Adaptive routing

- [Gatekeeper features](https://github.com/abhinavsingh2403/schrodinger-s-server/tree/main/gatekeeper): `gatekeeper`
- [Visitor memory](https://github.com/abhinavsingh2403/schrodinger-s-server/tree/main/gatekeeper): `gatekeeper`
- [T1/T2 personas](https://github.com/abhinavsingh2403/schrodinger-s-server/tree/main/sensor): `sensor`

### Cost and visibility

- [Cost model](https://github.com/abhinavsingh2403/schrodinger-s-server/tree/main/dashboard): `dashboard`
- [Results dashboard](https://github.com/abhinavsingh2403/schrodinger-s-server/tree/main/dashboard): `dashboard`

### Other components

- **Researcher**

## Connections

- Researcher → Download verifier: verifies download (evidence: `README.md`)
- Download verifier → SSH session data: checks checksum (evidence: `README.md`)
- Researcher → Base-rate analysis: analyzes sessions (evidence: `README.md`)
- Base-rate analysis → SSH session data: analyzes data (evidence: `README.md`)
- Base-rate analysis → Base-rate results: computes rates (evidence: `README.md`)
- Researcher → Experiment 0: runs protocol (evidence: `README.md`)
- Persona PoC → Cowrie honeypot: assigns personas (evidence: `README.md`)
- Persona PoC → T1/T2 personas: selects persona (evidence: `README.md`)
- Experiment 0 → Gatekeeper features: evaluates features (evidence: `README.md`)
- Gatekeeper features → Visitor memory: uses memory (evidence: `README.md`)
- Visitor memory → T1/T2 personas: informs selection (evidence: `README.md`)
- T1/T2 personas → Cost model: informs costing (evidence: `README.md`)
- Cost model → Results dashboard: feeds results (evidence: `README.md`)
