# nickscherbakov/heinrich-the-inventing-machine architecture

> Architecture diagram of the GitHub repository nickscherbakov/heinrich-the-inventing-machine, 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/nickscherbakov/heinrich-the-inventing-machine
- Repository: https://github.com/nickscherbakov/heinrich-the-inventing-machine

## Overview

Heinrich is an AI-assisted TRIZ problem-solving engine. Its documented user workflow runs from problem input through contradiction analysis, principle selection, scientific-effects lookup, concept generation, context adaptation, and a structured report. The CLI is the sampled interactive entry point; Gemini and Ollama are available adapter implementations, but the excerpts do not establish that pipeline stages invoke them. Pipeline-stage relationships below are documented in the README; implementation details for several stages were not sampled.

Main entry points: [`heinrich_cli.py`](https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich_cli.py) (Interactive CLI), [`heinrich/pipelines/principle_selector.py`](https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/pipelines/principle_selector.py) (Principle selector), [`heinrich/llm/adapters/ollama.py`](https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/llm/adapters/ollama.py) (Ollama adapter), [`heinrich/pipelines/contradiction_identifier.py`](https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/pipelines/contradiction_identifier.py) (Contradiction identifier)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["TRIZ workflow"]
  node_cli["Interactive CLI<br/>[heinrich_cli.py]"]
  node_parser["Problem parser<br/>[problem_parser.py]"]
  node_contradiction["Contradiction identifier"]
  node_selector["Principle selector"]
  node_effects["Effects lookup<br/>[effects_lookup.py]"]
  node_concepts["Concept generator"]
  node_adaptation["Adaptation planner"]
  node_report["Report builder<br/>[report_builder.py]"]
end

subgraph group_knowledge["TRIZ knowledge"]
  node_knowledge_loader["Knowledge loader"]
  node_triz_data[("TRIZ knowledge files")]
end

subgraph group_ai["LLM and persona"]
  node_persona["Heinrich persona<br/>[persona_manager.py]"]
  node_adapter_base["LLM adapter interface<br/>[base_adapter.py]"]
  node_gemini["Gemini adapter<br/>[gemini.py]"]
  node_ollama["Ollama adapter<br/>[ollama.py]"]
end

subgraph group_support["Runtime support"]
  node_config["Configuration loader<br/>[config_loader.py]"]
  node_logging["Logging configuration<br/>[logging_config.py]"]
  node_version["Version metadata<br/>[version.py]"]
end

node_user(("Problem solver"))
node_gemini_service["Gemini service"]
node_ollama_service["Ollama service"]

node_user -->|"describes problem"| node_cli
node_cli -->|"parses input"| node_parser
node_cli -->|"identifies contradictions"| node_contradiction
node_cli -->|"selects principles"| node_selector
node_cli -->|"looks up effects"| node_effects
node_cli -->|"generates concepts"| node_concepts
node_cli -->|"adapts concepts"| node_adaptation
node_cli -->|"builds report"| node_report
node_parser -->|"provides parsed problem"| node_contradiction
node_contradiction -->|"provides contradictions"| node_selector
node_selector -->|"provides principles"| node_effects
node_effects -->|"informs concepts"| node_concepts
node_concepts -->|"provides concepts"| node_adaptation
node_adaptation -->|"provides adaptations"| node_report
node_knowledge_loader -->|"loads knowledge"| node_triz_data
node_selector -->|"reads principles and matrix"| node_triz_data
node_cli -->|"initializes persona"| node_persona
node_gemini -->|"implements interface"| node_adapter_base
node_ollama -->|"implements interface"| node_adapter_base
node_gemini -.->|"requests generation"| node_gemini_service
node_ollama -->|"sends HTTP requests"| node_ollama_service
node_ollama -->|"uses logger"| node_logging

click node_cli "https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich_cli.py"
click node_parser "https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/pipelines/problem_parser.py"
click node_contradiction "https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/pipelines/contradiction_identifier.py"
click node_selector "https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/pipelines/principle_selector.py"
click node_effects "https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/pipelines/effects_lookup.py"
click node_concepts "https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/pipelines/concept_generator.py"
click node_adaptation "https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/pipelines/adaptation_planner.py"
click node_report "https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/pipelines/report_builder.py"
click node_knowledge_loader "https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/knowledge/knowledge_loader.py"
click node_triz_data "https://github.com/nickscherbakov/heinrich-the-inventing-machine/tree/main/heinrich/knowledge"
click node_persona "https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/agents/persona_manager.py"
click node_adapter_base "https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/llm/base_adapter.py"
click node_gemini "https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/llm/adapters/gemini.py"
click node_ollama "https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/llm/adapters/ollama.py"
click node_config "https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/utils/config_loader.py"
click node_logging "https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/utils/logging_config.py"
click node_version "https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/version.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_cli,node_parser,node_contradiction,node_selector,node_effects,node_concepts,node_adaptation,node_report toneBlue
class node_knowledge_loader,node_triz_data toneAmber
class node_persona,node_adapter_base,node_gemini,node_ollama toneMint
class node_config,node_logging,node_version toneRose
class node_user,node_gemini_service,node_ollama_service toneIndigo
```

## Components

### TRIZ workflow

- [Interactive CLI](https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich_cli.py): `heinrich_cli.py`
- [Problem parser](https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/pipelines/problem_parser.py): `heinrich/pipelines/problem_parser.py`
- [Contradiction identifier](https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/pipelines/contradiction_identifier.py): `heinrich/pipelines/contradiction_identifier.py`
- [Principle selector](https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/pipelines/principle_selector.py): `heinrich/pipelines/principle_selector.py`
- [Effects lookup](https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/pipelines/effects_lookup.py): `heinrich/pipelines/effects_lookup.py`
- [Concept generator](https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/pipelines/concept_generator.py): `heinrich/pipelines/concept_generator.py`
- [Adaptation planner](https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/pipelines/adaptation_planner.py): `heinrich/pipelines/adaptation_planner.py`
- [Report builder](https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/pipelines/report_builder.py): `heinrich/pipelines/report_builder.py`

### TRIZ knowledge

- [Knowledge loader](https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/knowledge/knowledge_loader.py): `heinrich/knowledge/knowledge_loader.py`
- [TRIZ knowledge files](https://github.com/nickscherbakov/heinrich-the-inventing-machine/tree/main/heinrich/knowledge): `heinrich/knowledge`

### LLM and persona

- [Heinrich persona](https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/agents/persona_manager.py): `heinrich/agents/persona_manager.py`
- [LLM adapter interface](https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/llm/base_adapter.py): `heinrich/llm/base_adapter.py`
- [Gemini adapter](https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/llm/adapters/gemini.py): `heinrich/llm/adapters/gemini.py`
- [Ollama adapter](https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/llm/adapters/ollama.py): `heinrich/llm/adapters/ollama.py`

### Runtime support

- [Configuration loader](https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/utils/config_loader.py): `heinrich/utils/config_loader.py`
- [Logging configuration](https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/utils/logging_config.py): `heinrich/utils/logging_config.py`
- [Version metadata](https://github.com/nickscherbakov/heinrich-the-inventing-machine/blob/main/heinrich/version.py): `heinrich/version.py`

### Other components

- **Problem solver**
- **Gemini service**
- **Ollama service**

## Connections

- Problem solver → Interactive CLI: describes problem (evidence: `README.md`)
- Interactive CLI → Problem parser: parses input (evidence: `heinrich_cli.py`)
- Interactive CLI → Contradiction identifier: identifies contradictions (evidence: `heinrich_cli.py`)
- Interactive CLI → Principle selector: selects principles (evidence: `README.md`)
- Interactive CLI → Effects lookup: looks up effects (evidence: `README.md`)
- Interactive CLI → Concept generator: generates concepts (evidence: `README.md`)
- Interactive CLI → Adaptation planner: adapts concepts (evidence: `README.md`)
- Interactive CLI → Report builder: builds report (evidence: `README.md`)
- Problem parser → Contradiction identifier: provides parsed problem (evidence: `README.md`)
- Contradiction identifier → Principle selector: provides contradictions (evidence: `README.md`)
- Principle selector → Effects lookup: provides principles (evidence: `README.md`)
- Effects lookup → Concept generator: informs concepts (evidence: `README.md`)
- Concept generator → Adaptation planner: provides concepts (evidence: `README.md`)
- Adaptation planner → Report builder: provides adaptations (evidence: `README.md`)
- Knowledge loader → TRIZ knowledge files: loads knowledge (evidence: `heinrich/knowledge/knowledge_loader.py`)
- Principle selector → TRIZ knowledge files: reads principles and matrix (evidence: `heinrich/pipelines/principle_selector.py`)
- Interactive CLI → Heinrich persona: initializes persona (evidence: `heinrich_cli.py`)
- Gemini adapter → LLM adapter interface: implements interface (evidence: `heinrich/llm/adapters/gemini.py`)
- Ollama adapter → LLM adapter interface: implements interface (evidence: `heinrich/llm/adapters/ollama.py`)
- Gemini adapter → Gemini service: requests generation (evidence: `heinrich/llm/adapters/gemini.py`)
- Ollama adapter → Ollama service: sends HTTP requests (evidence: `heinrich/llm/adapters/ollama.py`)
- Ollama adapter → Logging configuration: uses logger (evidence: `heinrich/llm/adapters/ollama.py`)
