# nishant-13006/code_breaker architecture

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

- Interactive diagram: https://gitdiagram.com/nishant-13006/code_breaker
- Repository: https://github.com/nishant-13006/code_breaker

## Overview

Code Breaker is a Streamlit tool that turns uploaded source files into chunk-by-chunk explanations and a project overview using a local Ollama model. The user uploads files, reviews or changes suggested dependency order, selects an explanation level, and starts analysis; results appear in the UI and can be downloaded as Markdown. Analysis validates limits, chunks files, builds context from earlier explanations, and requests model output. The excerpts show the main calls and data flow; unsampled implementation details are not inferred.

Main entry points: [`code_breaker/backend/pipeline.py`](https://github.com/nishant-13006/code_breaker/blob/main/code_breaker/backend/pipeline.py) (Analysis workflow), [`code_breaker/app.py`](https://github.com/nishant-13006/code_breaker/blob/main/code_breaker/app.py) (Upload and results UI), [`code_breaker/backend/explainer.py`](https://github.com/nishant-13006/code_breaker/blob/main/code_breaker/backend/explainer.py) (Explanation generation), [`code_breaker/backend/context.py`](https://github.com/nishant-13006/code_breaker/blob/main/code_breaker/backend/context.py) (Cross-file context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User interface"]
  node_streamlit_app["Upload and results UI<br/>[app.py]"]
  node_markdown_export["Markdown export<br/>[export.py]"]
end

subgraph group_analysis["Code analysis"]
  node_order_suggester["Dependency ordering<br/>[ordering.py]"]
  node_analyzer["Analysis workflow<br/>[pipeline.py]"]
  node_limits["Analysis limits<br/>[config.py]"]
  node_chunker["Code chunking<br/>[chunker.py]"]
  node_project_context["Cross-file context<br/>[context.py]"]
end

subgraph group_ai["Local AI"]
  node_explainer["Explanation generation<br/>[explainer.py]"]
  node_prompt_templates["Tutor prompts<br/>[prompts.py]"]
end

node_user(("User"))
node_ollama{{"Local Ollama model"}}

node_user -->|"uploads files"| node_streamlit_app
node_streamlit_app -->|"suggests order"| node_order_suggester
node_user -->|"sets order and level"| node_streamlit_app
node_streamlit_app -->|"starts analysis"| node_analyzer
node_analyzer -->|"reads limits"| node_limits
node_analyzer -->|"chunks files"| node_chunker
node_analyzer -->|"gets context"| node_project_context
node_analyzer -->|"explains chunks"| node_explainer
node_analyzer -->|"adds notes"| node_project_context
node_analyzer -->|"generates overview"| node_explainer
node_explainer -->|"formats prompts"| node_prompt_templates
node_explainer -->|"sends prompts"| node_ollama
node_analyzer -->|"returns results"| node_streamlit_app
node_streamlit_app -->|"formats download"| node_markdown_export
node_streamlit_app -->|"shows explanations"| node_user
node_streamlit_app -->|"offers Markdown"| node_user

click node_streamlit_app "https://github.com/nishant-13006/code_breaker/blob/main/code_breaker/app.py"
click node_order_suggester "https://github.com/nishant-13006/code_breaker/blob/main/code_breaker/backend/ordering.py"
click node_analyzer "https://github.com/nishant-13006/code_breaker/blob/main/code_breaker/backend/pipeline.py"
click node_limits "https://github.com/nishant-13006/code_breaker/blob/main/code_breaker/backend/config.py"
click node_chunker "https://github.com/nishant-13006/code_breaker/blob/main/code_breaker/backend/chunker.py"
click node_project_context "https://github.com/nishant-13006/code_breaker/blob/main/code_breaker/backend/context.py"
click node_explainer "https://github.com/nishant-13006/code_breaker/blob/main/code_breaker/backend/explainer.py"
click node_prompt_templates "https://github.com/nishant-13006/code_breaker/blob/main/code_breaker/backend/prompts.py"
click node_markdown_export "https://github.com/nishant-13006/code_breaker/blob/main/code_breaker/backend/export.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_streamlit_app,node_markdown_export,node_user toneBlue
class node_order_suggester,node_analyzer,node_limits,node_chunker,node_project_context toneAmber
class node_explainer,node_prompt_templates toneMint
class node_ollama toneIndigo
```

## Components

### User interface

- [Upload and results UI](https://github.com/nishant-13006/code_breaker/blob/main/code_breaker/app.py): `code_breaker/app.py`
- [Markdown export](https://github.com/nishant-13006/code_breaker/blob/main/code_breaker/backend/export.py): `code_breaker/backend/export.py`

### Code analysis

- [Dependency ordering](https://github.com/nishant-13006/code_breaker/blob/main/code_breaker/backend/ordering.py): `code_breaker/backend/ordering.py`
- [Analysis workflow](https://github.com/nishant-13006/code_breaker/blob/main/code_breaker/backend/pipeline.py): `code_breaker/backend/pipeline.py`
- [Analysis limits](https://github.com/nishant-13006/code_breaker/blob/main/code_breaker/backend/config.py): `code_breaker/backend/config.py`
- [Code chunking](https://github.com/nishant-13006/code_breaker/blob/main/code_breaker/backend/chunker.py): `code_breaker/backend/chunker.py`
- [Cross-file context](https://github.com/nishant-13006/code_breaker/blob/main/code_breaker/backend/context.py): `code_breaker/backend/context.py`

### Local AI

- [Explanation generation](https://github.com/nishant-13006/code_breaker/blob/main/code_breaker/backend/explainer.py): `code_breaker/backend/explainer.py`
- [Tutor prompts](https://github.com/nishant-13006/code_breaker/blob/main/code_breaker/backend/prompts.py): `code_breaker/backend/prompts.py`

### Other components

- **User**
- **Local Ollama model**

## Connections

- User → Upload and results UI: uploads files (evidence: `code_breaker/app.py`)
- Upload and results UI → Dependency ordering: suggests order (evidence: `code_breaker/app.py`)
- User → Upload and results UI: sets order and level (evidence: `code_breaker/app.py`)
- Upload and results UI → Analysis workflow: starts analysis (evidence: `code_breaker/app.py`)
- Analysis workflow → Analysis limits: reads limits (evidence: `code_breaker/backend/pipeline.py`)
- Analysis workflow → Code chunking: chunks files (evidence: `code_breaker/backend/pipeline.py`)
- Analysis workflow → Cross-file context: gets context (evidence: `code_breaker/backend/pipeline.py`)
- Analysis workflow → Explanation generation: explains chunks (evidence: `code_breaker/backend/pipeline.py`)
- Analysis workflow → Cross-file context: adds notes (evidence: `code_breaker/backend/pipeline.py`)
- Analysis workflow → Explanation generation: generates overview (evidence: `code_breaker/backend/pipeline.py`)
- Explanation generation → Tutor prompts: formats prompts (evidence: `code_breaker/backend/explainer.py`)
- Explanation generation → Local Ollama model: sends prompts (evidence: `code_breaker/backend/explainer.py`)
- Analysis workflow → Upload and results UI: returns results (evidence: `code_breaker/app.py`)
- Upload and results UI → Markdown export: formats download (evidence: `code_breaker/app.py`)
- Upload and results UI → User: shows explanations (evidence: `code_breaker/app.py`)
- Upload and results UI → User: offers Markdown (evidence: `code_breaker/app.py`)
