# lokesh-poreddy/research_modelfinal architecture

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

- Interactive diagram: https://gitdiagram.com/lokesh-poreddy/research_modelfinal
- Repository: https://github.com/lokesh-poreddy/research_modelfinal

## Overview

ResearchForge-ECRM is an autonomous model-evolution and algorithm-discovery system. Its principal workflow takes a task and dataset through the ResearchController: choose a strategy, evolve a model genome, evaluate experiments, diagnose failures, and update research memory and policy. RF-2 adds transfer prediction, gating, and counterfactual sampling; RF-3 evolves and registers new strategies. The repository also contains an earlier controller and a REST interface. Arrows follow README-documented relationships or shown calls; unsampled subsystems are included only where documented.

Main entry points: [`researchforge/pipeline/controller.py`](https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/pipeline/controller.py) (Research Controller), [`researchforge/discovery/meta_controller.py`](https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/discovery/meta_controller.py) (Discovery Meta-Controller), [`agents/controller_agent.py`](https://github.com/lokesh-poreddy/research_modelfinal/blob/main/agents/controller_agent.py) (Earlier Research Controller), [`researchforge/transfer/counterfactual.py`](https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/transfer/counterfactual.py) (Counterfactual Arbitrator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_research["Research Loop"]
  node_controller["Research Controller<br/>[controller.py]"]
  node_genome["Model Genomes<br/>[model_genome.py]"]
  node_operators["Genome Operators<br/>[operators.py]"]
  node_evaluator["Model Evaluator"]
  node_diagnosis["Failure Diagnosis"]
  node_rdg[("Research Graph<br/>[graph.py]")]
  node_legacy_controller["Earlier Research Controller"]
  node_legacy_rdg[("Earlier Research Graph<br/>[graph.py]")]
end

subgraph group_policy["Policy And Transfer"]
  node_bandit["Contextual Bandit"]
  node_utility["Transfer Utility<br/>[utility_learner.py]"]
  node_transfer_gate["Utility Transfer Gate<br/>[utility_gate.py]"]
  node_arbitrator["Counterfactual Arbitrator<br/>[counterfactual.py]"]
  node_sampling["Counterfactual Sampling<br/>[sampling.py]"]
end

subgraph group_memory["Research Memory"]
  node_ecrm[("ECRM Memory<br/>[ecrm.py]")]
  node_posterior[("Posterior Memory<br/>[posterior.py]")]
  node_trajectory[("Adaptive Trajectory Memory")]
  node_legacy_memory[("Earlier ECRM Store<br/>[memory_store.py]")]
end

subgraph group_discovery["Algorithm Discovery"]
  node_meta["Discovery Meta-Controller<br/>[meta_controller.py]"]
  node_operator_genome["Operator Genomes<br/>[operator_genome.py]"]
  node_compiler["DSL Compiler<br/>[dsl_compiler.py]"]
end

subgraph group_interfaces["Interfaces"]
  node_api["REST API<br/>[server.py]"]
  node_service["Application Service<br/>[services.py]"]
end

node_task(("Task And Dataset"))
node_caller(("API Caller"))

node_task -->|"provides task"| node_controller
node_controller -->|"selects strategy"| node_bandit
node_controller -->|"synthesizes genome"| node_genome
node_controller -->|"runs evaluation"| node_evaluator
node_controller -->|"diagnoses failures"| node_diagnosis
node_controller -->|"updates memory"| node_ecrm
node_controller -->|"uses posterior"| node_posterior
node_controller -->|"uses trajectory memory"| node_trajectory
node_controller -->|"records research"| node_rdg
node_controller -->|"predicts transfer utility"| node_utility
node_controller -->|"gates transfer"| node_transfer_gate
node_controller -->|"arbitrates counterfactuals"| node_arbitrator
node_arbitrator -->|"uses sampling policy"| node_sampling
node_controller -->|"evolves genomes"| node_operators
node_meta -->|"evolves candidates"| node_operator_genome
node_meta -->|"compiles candidates"| node_compiler
node_meta -->|"pilots strategies"| node_controller
node_meta -->|"registers strategy arms"| node_bandit
node_caller -->|"sends requests"| node_api
node_api -->|"dispatches requests"| node_service
node_legacy_controller -->|"updates graph"| node_legacy_rdg
node_legacy_controller -->|"uses memory"| node_legacy_memory
node_legacy_controller -->|"uses genomes"| node_genome

click node_controller "https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/pipeline/controller.py"
click node_genome "https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/genome/model_genome.py"
click node_operators "https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/genome/operators.py"
click node_evaluator "https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/evaluators/sklearn_evaluator.py"
click node_diagnosis "https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/diagnosis/failure_taxonomy.py"
click node_rdg "https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/rdg/graph.py"
click node_bandit "https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/policy/contextual_bandit.py"
click node_utility "https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/transfer/utility_learner.py"
click node_transfer_gate "https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/policy/utility_gate.py"
click node_arbitrator "https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/transfer/counterfactual.py"
click node_sampling "https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/transfer/sampling.py"
click node_ecrm "https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/memory/ecrm.py"
click node_posterior "https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/memory/posterior.py"
click node_trajectory "https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/memory/adaptive_trajectory.py"
click node_meta "https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/discovery/meta_controller.py"
click node_operator_genome "https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/discovery/operator_genome.py"
click node_compiler "https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/discovery/dsl_compiler.py"
click node_api "https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/api/server.py"
click node_service "https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/api/services.py"
click node_legacy_controller "https://github.com/lokesh-poreddy/research_modelfinal/blob/main/agents/controller_agent.py"
click node_legacy_memory "https://github.com/lokesh-poreddy/research_modelfinal/blob/main/ecrm/memory_store.py"
click node_legacy_rdg "https://github.com/lokesh-poreddy/research_modelfinal/blob/main/rdg/graph.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_controller,node_genome,node_operators,node_evaluator,node_diagnosis,node_rdg,node_legacy_controller,node_legacy_rdg toneBlue
class node_bandit,node_utility,node_transfer_gate,node_arbitrator,node_sampling toneAmber
class node_ecrm,node_posterior,node_trajectory,node_legacy_memory,node_caller toneMint
class node_meta,node_operator_genome,node_compiler,node_task toneRose
class node_api,node_service toneIndigo
```

## Components

### Research Loop

- [Research Controller](https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/pipeline/controller.py): `researchforge/pipeline/controller.py`
- [Model Genomes](https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/genome/model_genome.py): `researchforge/genome/model_genome.py`
- [Genome Operators](https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/genome/operators.py): `researchforge/genome/operators.py`
- [Model Evaluator](https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/evaluators/sklearn_evaluator.py): `researchforge/evaluators/sklearn_evaluator.py`
- [Failure Diagnosis](https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/diagnosis/failure_taxonomy.py): `researchforge/diagnosis/failure_taxonomy.py`
- [Research Graph](https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/rdg/graph.py): `researchforge/rdg/graph.py`
- [Earlier Research Controller](https://github.com/lokesh-poreddy/research_modelfinal/blob/main/agents/controller_agent.py): `agents/controller_agent.py`
- [Earlier Research Graph](https://github.com/lokesh-poreddy/research_modelfinal/blob/main/rdg/graph.py): `rdg/graph.py`

### Policy And Transfer

- [Contextual Bandit](https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/policy/contextual_bandit.py): `researchforge/policy/contextual_bandit.py`
- [Transfer Utility](https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/transfer/utility_learner.py): `researchforge/transfer/utility_learner.py`
- [Utility Transfer Gate](https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/policy/utility_gate.py): `researchforge/policy/utility_gate.py`
- [Counterfactual Arbitrator](https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/transfer/counterfactual.py): `researchforge/transfer/counterfactual.py`
- [Counterfactual Sampling](https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/transfer/sampling.py): `researchforge/transfer/sampling.py`

### Research Memory

- [ECRM Memory](https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/memory/ecrm.py): `researchforge/memory/ecrm.py`
- [Posterior Memory](https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/memory/posterior.py): `researchforge/memory/posterior.py`
- [Adaptive Trajectory Memory](https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/memory/adaptive_trajectory.py): `researchforge/memory/adaptive_trajectory.py`
- [Earlier ECRM Store](https://github.com/lokesh-poreddy/research_modelfinal/blob/main/ecrm/memory_store.py): `ecrm/memory_store.py`

### Algorithm Discovery

- [Discovery Meta-Controller](https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/discovery/meta_controller.py): `researchforge/discovery/meta_controller.py`
- [Operator Genomes](https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/discovery/operator_genome.py): `researchforge/discovery/operator_genome.py`
- [DSL Compiler](https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/discovery/dsl_compiler.py): `researchforge/discovery/dsl_compiler.py`

### Interfaces

- [REST API](https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/api/server.py): `researchforge/api/server.py`
- [Application Service](https://github.com/lokesh-poreddy/research_modelfinal/blob/main/researchforge/api/services.py): `researchforge/api/services.py`

### Other components

- **Task And Dataset**
- **API Caller**

## Connections

- Task And Dataset → Research Controller: provides task (evidence: `README.md`)
- Research Controller → Contextual Bandit: selects strategy (evidence: `README.md`)
- Research Controller → Model Genomes: synthesizes genome (evidence: `researchforge/pipeline/controller.py`)
- Research Controller → Model Evaluator: runs evaluation (evidence: `README.md`)
- Research Controller → Failure Diagnosis: diagnoses failures (evidence: `README.md`)
- Research Controller → ECRM Memory: updates memory (evidence: `README.md`)
- Research Controller → Posterior Memory: uses posterior (evidence: `README.md`)
- Research Controller → Adaptive Trajectory Memory: uses trajectory memory (evidence: `researchforge/pipeline/controller.py`)
- Research Controller → Research Graph: records research (evidence: `researchforge/pipeline/controller.py`)
- Research Controller → Transfer Utility: predicts transfer utility (evidence: `README.md`)
- Research Controller → Utility Transfer Gate: gates transfer (evidence: `README.md`)
- Research Controller → Counterfactual Arbitrator: arbitrates counterfactuals (evidence: `README.md`)
- Counterfactual Arbitrator → Counterfactual Sampling: uses sampling policy (evidence: `README.md`)
- Research Controller → Genome Operators: evolves genomes (evidence: `researchforge/pipeline/controller.py`)
- Discovery Meta-Controller → Operator Genomes: evolves candidates (evidence: `researchforge/discovery/meta_controller.py`)
- Discovery Meta-Controller → DSL Compiler: compiles candidates (evidence: `researchforge/discovery/meta_controller.py`)
- Discovery Meta-Controller → Research Controller: pilots strategies (evidence: `researchforge/discovery/meta_controller.py`)
- Discovery Meta-Controller → Contextual Bandit: registers strategy arms (evidence: `README.md`)
- API Caller → REST API: sends requests (evidence: `researchforge/api/server.py`)
- REST API → Application Service: dispatches requests (evidence: `researchforge/api/server.py`)
- Earlier Research Controller → Earlier Research Graph: updates graph (evidence: `agents/controller_agent.py`)
- Earlier Research Controller → Earlier ECRM Store: uses memory (evidence: `agents/controller_agent.py`)
- Earlier Research Controller → Model Genomes: uses genomes (evidence: `agents/controller_agent.py`)
