How nickscherbakov/heinrich-the-inventing-machine works
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 Interactive CLI · principle_selector.py Principle selector · ollama.py Ollama adapter · contradiction_identifier.py Contradiction identifier
Components 20
TRIZ workflow
- Interactive CLI
heinrich_cli.py - Problem parser
heinrich/pipelines/problem_parser.py - Contradiction identifier
heinrich/pipelines/contradiction_identifier.py - Principle selector
heinrich/pipelines/principle_selector.py - Effects lookup
heinrich/pipelines/effects_lookup.py - Concept generator
heinrich/pipelines/concept_generator.py - Adaptation planner
heinrich/pipelines/adaptation_planner.py - Report builder
heinrich/pipelines/report_builder.py
TRIZ knowledge
- Knowledge loader
heinrich/knowledge/knowledge_loader.py - TRIZ knowledge files
heinrich/knowledge
LLM and persona
- Heinrich persona
heinrich/agents/persona_manager.py - LLM adapter interface
heinrich/llm/base_adapter.py - Gemini adapter
heinrich/llm/adapters/gemini.py - Ollama adapter
heinrich/llm/adapters/ollama.py
Runtime support
- Configuration loader
heinrich/utils/config_loader.py - Logging configuration
heinrich/utils/logging_config.py - Version metadata
heinrich/version.py
Other components
- Problem solver
- Gemini service
- Ollama service
Connections 22
- Problem solver → Interactive CLI: describes problem
README.md - Interactive CLI → Problem parser: parses input
heinrich_cli.py - Interactive CLI → Contradiction identifier: identifies contradictions
heinrich_cli.py - Interactive CLI → Principle selector: selects principles
README.md - Interactive CLI → Effects lookup: looks up effects
README.md - Interactive CLI → Concept generator: generates concepts
README.md - Interactive CLI → Adaptation planner: adapts concepts
README.md - Interactive CLI → Report builder: builds report
README.md - Problem parser → Contradiction identifier: provides parsed problem
README.md - Contradiction identifier → Principle selector: provides contradictions
README.md - Principle selector → Effects lookup: provides principles
README.md - Effects lookup → Concept generator: informs concepts
README.md - Concept generator → Adaptation planner: provides concepts
README.md - Adaptation planner → Report builder: provides adaptations
README.md - Knowledge loader → TRIZ knowledge files: loads knowledge
heinrich/knowledge/knowledge_loader.py - Principle selector → TRIZ knowledge files: reads principles and matrix
heinrich/pipelines/principle_selector.py - Interactive CLI → Heinrich persona: initializes persona
heinrich_cli.py - Gemini adapter → LLM adapter interface: implements interface
heinrich/llm/adapters/gemini.py - Ollama adapter → LLM adapter interface: implements interface
heinrich/llm/adapters/ollama.py - Gemini adapter → Gemini service: requests generation
heinrich/llm/adapters/gemini.py - Ollama adapter → Ollama service: sends HTTP requests
heinrich/llm/adapters/ollama.py - Ollama adapter → Logging configuration: uses logger
heinrich/llm/adapters/ollama.py