A newer version of the Streamlit SDK is available: 1.59.1
Here is a comprehensive, structured breakdown designed to serve as a 5-minute technical presentation or interview summary. It outlines the core architecture, the engineering problems solved, and how to explain your decisions to a technical reviewer.
— The High-Level Pitch
What it is, why it matters, and the core problem it solves.
"Most developers treat Large Language Models as a 'black box'—you pass a text prompt, and you get an output, but no one knows how the model arrived at that decision. My project, the Deep Inference & Mechanistic Interpretability Engine, breaks open that black box. I engineered a decoupled, production-grade telemetry pipeline using PyTorch and TransformerLens that intercepts a model's internal computational pathways (specifically the Residual Stream) in real-time during a forward pass. It extracts, quantifies, and visualizes exactly how abstract semantic tokens evolve into concrete mathematical representations layer-by-layer, exposing the internal reasoning mechanics of the neural network before it ever generates a final word."
— Architectural Deep Dive
How the system is built and why you decoupled the codebase.
To explain the codebase to an engineer, split your explanation into the two distinct layers you designed:
+------------------------------------------------------------------------+
| INFRASTRUCTURE & UI LAYER |
| app.py (Streamlit / Plotly) |
| - Asynchronous web dashboard to visualize telemetry frames |
| - Caches weight configurations to eliminate execution latency |
+------------------------------------+-----------------------------------+
| (Invokes Telemetry Pipeline)
v
+------------------------------------------------------------------------+
| CORE ML PIPELINE ENGINE |
| pipeline.py (PyTorch / TransformerLens) |
| - Injects HookPoints into the active transformer layers |
| - Intercepts tensors from the residual stream information highway |
| - Computes spatial density metrics (L2 Vector Norms) via matrix math |
+------------------------------------------------------------------------+
- The ML Pipeline (
pipeline.py): This is the mathematical core. It instantiates the model usingTransformerLens. Instead of letting the model run blindly, it uses custom PyTorch runtime hooks (run_with_cache). This intercept layer grabs the raw multi-dimensional tensors mid-execution and isolates the specific layer's activation matrix without causing a memory overflow. - The UI Interface Layer (
app.py): Built with Streamlit and Plotly to serve as a low-latency telemetry panel. It isolates the heavy weight-loading using caching decorators (@st.cache_resource). This means the model weights stay hot in memory, allowing users to move sliders, shift through layers, and re-examine internal features interactively in under 50 milliseconds.
— The Mathematical Logic
Explaining the specific metrics your system calculates.
When an interviewer asks, "What are you actually tracking when you intercept these layers?" you walk them through these two pipeline calculations:
1. Residual Stream L2 Norms
The residual stream acts as the model's central information highway. Every attention head reads from and writes back to this highway.
- The Math: Your pipeline isolates the tensor at a target hook point and computes the L2 Vector Norm across the hidden dimension ($d_{model}$) for each token, calculating:
- The Insight: This scalar value represents the mathematical magnitude or importance of a token at that exact depth. It shows you precisely where the model is expending its computational energy to construct a concept.
2. Unembedding Softmax Projections
At the absolute end of the transformer stack, the final hidden state is multiplied by the model's un-embedding weight matrix to turn vectors back into word probabilities.
- The Insight: Your engine intercepts the raw logits at the very last token position and passes them through a Softmax layer. This exposes the top five word candidates the model is predicting next, letting you see alternative tokens the model considered but ultimately discarded.
Engineering Wins & Edge Responses
The "So What?" section that proves you are a top-tier system architect.
Conclude by highlighting your system optimization and production readiness choices:
- Offline-First & Local Compliance: The pipeline is architected to run entirely on local, constrained resources (CPUs or edge hardware) using compact transformer configurations rather than relying on brittle cloud APIs. This ensures complete data privacy and deployment portability.
- Production Decoupling: By cleanly splitting the PyTorch array manipulations away from the UI code, the engine can easily be ripped out of the Streamlit interface and embedded directly into a backend microservice or a automated CI/CD evaluation pipeline.
- Debugging Hallucinations: You can confidently state: "If this model starts hallucinating, I don't just change the prompt. I use this engine to trace the residual highway to pinpoint the exact layer where the feature representation drifted, showing whether it was an attention routing failure or a vocabulary bias."
How to use this in an interview:
When talking to recruiters, focus on Minute 0 to 1 (the pitch). When talking to a Senior ML Engineer or Lead Architect, lean heavily into Minute 1 to 3.45 (the hooks, caching, decoupled architecture, and vector norms). That balance of infrastructure and ML theory is exactly what commands high-tier engineering salaries.