From e5a72a6a0974cb643e611e724aa425df2ba77e81 Mon Sep 17 00:00:00 2001
From: Maxime PERALTA <maxime.peralta@cea.fr>
Date: Fri, 20 Feb 2026 17:42:36 +0100
Subject: [PATCH 1/4] (feature) Panel classes can be decleared in external
 scripts

---
 apparun/gui/modules.py                       | 44 ++++++++----
 apparun/gui/panels/base.py                   | 62 +++++++++++++++-
 apparun/gui/panels/output_dynamic.py         |  8 ++-
 apparun/gui/panels/output_static.py          |  3 +-
 samples/conf/custom_gui.yaml                 | 20 ++++++
 samples/conf/parameters_sets/scenario_A.yaml |  3 +
 samples/conf/parameters_sets/scenario_B.yaml |  3 +
 samples/scripts/custom_gui.py                | 74 ++++++++++++++++++++
 8 files changed, 200 insertions(+), 17 deletions(-)
 create mode 100644 samples/conf/custom_gui.yaml
 create mode 100644 samples/conf/parameters_sets/scenario_A.yaml
 create mode 100644 samples/conf/parameters_sets/scenario_B.yaml
 create mode 100644 samples/scripts/custom_gui.py

diff --git a/apparun/gui/modules.py b/apparun/gui/modules.py
index 74f1130..cd21706 100644
--- a/apparun/gui/modules.py
+++ b/apparun/gui/modules.py
@@ -1,15 +1,21 @@
 from __future__ import annotations
 
 import subprocess
-from typing import Annotated, Callable, List, Optional, TypeVar, Union
+from typing import Annotated, Any, Callable, Dict, List, Optional, TypeVar, Union
 
 import pandas as pd
 import streamlit as st
-from pydantic import BaseModel, Field
+from pydantic import BaseModel, Field, field_validator
 
-from apparun.gui.panels.base import InputScenarioFormPanel
-from apparun.gui.panels.output_dynamic import ScenarioComparisonDynamicOutputPanel
-from apparun.gui.panels.output_static import Markdown
+from apparun.gui.panels.base import *
+from apparun.gui.panels.base import (
+    InputPanel,
+    OutputPanel,
+    get_input_panel,
+    get_output_panel,
+)
+from apparun.gui.panels.output_dynamic import *
+from apparun.gui.panels.output_static import *
 from apparun.impact_model import ImpactModel
 
 PandasDataFrame = TypeVar("pd.core.frame.DataFrame")
@@ -19,19 +25,29 @@ class Module(BaseModel):
     name: Optional[str] = None
     lca_data_path: Optional[str] = None
     impact_model_path: Optional[str] = None
-    input_panel: Optional[
-        Annotated[InputScenarioFormPanel, Field(discriminator="type")]
-    ] = None
-    output_panels: List[
-        Annotated[
-            Union[ScenarioComparisonDynamicOutputPanel, Markdown],
-            Field(discriminator="type"),
-        ]
-    ]
+    input_panel: Optional[InputPanel] = None
+    output_panels: List[OutputPanel]
     cols: Optional[Callable] = None
     lca_data: Optional[PandasDataFrame] = None
     impact_model: Optional[ImpactModel] = None
 
+    @field_validator("input_panel", mode="before")
+    @classmethod
+    def build_input_panel(
+        cls, panel: Optional[Dict[Any]] = None
+    ) -> Optional[InputPanel]:
+        if panel is None:
+            return None
+        return get_input_panel(panel["type"])(**panel)
+
+    @field_validator("output_panels", mode="before")
+    @classmethod
+    def build_output_panels(cls, panels: List[Dict[Any]]) -> List[OutputPanel]:
+        return [
+            get_output_panel(output_panel["type"])(**output_panel)
+            for output_panel in panels
+        ]
+
     def __init__(self, **args):
         super().__init__(**args)
         self.lca_data = (
diff --git a/apparun/gui/panels/base.py b/apparun/gui/panels/base.py
index 9fe7627..e101b0a 100644
--- a/apparun/gui/panels/base.py
+++ b/apparun/gui/panels/base.py
@@ -11,6 +11,65 @@
 ACTION_ADD = "add"
 ACTION_CLEAR = "clear"
 
+INPUT_PANELS = {}
+OUTPUT_PANELS = {}
+
+
+def register_panel(panel_type: str):
+    """
+    This decorator registers a new Panel class in PANELS registry.
+    :param panel_type: new Panel's type name
+    :return: new Panel class
+    """
+
+    def decorator(decorated_class):
+        if issubclass(decorated_class, OutputPanel):
+            if panel_type not in OUTPUT_PANELS:
+                OUTPUT_PANELS[panel_type] = decorated_class
+            return decorated_class
+        if issubclass(decorated_class, InputPanel):
+            if panel_type not in INPUT_PANELS:
+                INPUT_PANELS[panel_type] = decorated_class
+            return decorated_class
+        msg = f"Custom panel {panel_type} must inherit from InputPanel or OutputPanel."
+        raise TypeError(msg)
+
+    return decorator
+
+
+def get_input_panel(panel_type: str):
+    """
+    Get a registered InputPanel class by type.
+    :param panel_type: type of the desired input panel.
+    :return: registered InputPanel class corresponding to the type.
+    """
+    return INPUT_PANELS[panel_type]
+
+
+def get_output_panel(panel_type: str):
+    """
+    Get a registered OutputPanel class by type.
+    :param panel_type: type of the desired output panel.
+    :return: registered OutputPanel class corresponding to the type.
+    """
+    return OUTPUT_PANELS[panel_type]
+
+
+def registered_input_panels() -> List[str]:
+    """
+    Get a list of registered InputPanel types.
+    :return: list of registered InputPanel types.
+    """
+    return list(INPUT_PANELS.keys())
+
+
+def registered_output_panels() -> List[str]:
+    """
+    Get a list of registered OutputPanel types.
+    :return: list of registered OutputPanel types.
+    """
+    return list(OUTPUT_PANELS.keys())
+
 
 class Panel(BaseModel):
     _state: Dict[Any, Any] = {}
@@ -76,8 +135,9 @@ def submit(self):
         return
 
 
+@register_panel("input_scenario_form_panel")
 class InputScenarioFormPanel(InputPanel):
-    fields: List[Dict[str, Any]]
+    fields: Optional[List[Dict[str, Any]]] = []
     type: Literal["input_scenario_form_panel"]
 
     def __init__(self, **args):
diff --git a/apparun/gui/panels/output_dynamic.py b/apparun/gui/panels/output_dynamic.py
index 1bc1428..339db36 100644
--- a/apparun/gui/panels/output_dynamic.py
+++ b/apparun/gui/panels/output_dynamic.py
@@ -3,11 +3,17 @@
 import pandas as pd
 import streamlit as st
 
-from apparun.gui.panels.base import ACTION_ADD, ACTION_CLEAR, DynamicOutputPanel
+from apparun.gui.panels.base import (
+    ACTION_ADD,
+    ACTION_CLEAR,
+    DynamicOutputPanel,
+    register_panel,
+)
 from apparun.impact_model import ImpactModel
 from apparun.results import ImpactModelResult, ScenarioComparisonResult
 
 
+@register_panel("scenario_comparison_dynamic_output_panel")
 class ScenarioComparisonDynamicOutputPanel(DynamicOutputPanel):
     type: Literal["scenario_comparison_dynamic_output_panel"]
     result: Optional[ImpactModelResult] = None
diff --git a/apparun/gui/panels/output_static.py b/apparun/gui/panels/output_static.py
index 212a181..1c7d2c0 100644
--- a/apparun/gui/panels/output_static.py
+++ b/apparun/gui/panels/output_static.py
@@ -2,10 +2,11 @@
 
 import streamlit as st
 
-from apparun.gui.panels.base import StaticOutputPanel
+from apparun.gui.panels.base import StaticOutputPanel, register_panel
 from apparun.results import ImpactModelResult
 
 
+@register_panel("markdown")
 class Markdown(StaticOutputPanel):
     type: Literal["markdown"]
     message: str
diff --git a/samples/conf/custom_gui.yaml b/samples/conf/custom_gui.yaml
new file mode 100644
index 0000000..a4e3226
--- /dev/null
+++ b/samples/conf/custom_gui.yaml
@@ -0,0 +1,20 @@
+name: "GUI with custom panels"
+modules:
+  - name: "Rude markdown"
+    output_panels:
+      - type: markdown
+        message: "This is using a panel built in Appa Run."
+  - name: "Polite markdown"
+    output_panels:
+      - type: polite_markdown
+        message: "This is using a panel built in an external script."
+  - name: "Scenario comparison by phase"
+    impact_model_path: "samples/impact_models/nvidia_ai_gpu_chip.yaml"
+    input_panel:
+      type: input_scenario_from_file_panel
+      name: "GPU parameters"
+    output_panels:
+      - type: batch_scenario_comparison_dynamic_output_panel
+        y: EFV3_CLIMATE_CHANGE
+        hue: phase
+        by_property: "phase"
\ No newline at end of file
diff --git a/samples/conf/parameters_sets/scenario_A.yaml b/samples/conf/parameters_sets/scenario_A.yaml
new file mode 100644
index 0000000..23dab9d
--- /dev/null
+++ b/samples/conf/parameters_sets/scenario_A.yaml
@@ -0,0 +1,3 @@
+lifespan: 3
+architecture: Maxwell
+cuda_core: 2048
\ No newline at end of file
diff --git a/samples/conf/parameters_sets/scenario_B.yaml b/samples/conf/parameters_sets/scenario_B.yaml
new file mode 100644
index 0000000..3c90075
--- /dev/null
+++ b/samples/conf/parameters_sets/scenario_B.yaml
@@ -0,0 +1,3 @@
+lifespan: 3
+architecture: Pascal
+cuda_core: 1024
\ No newline at end of file
diff --git a/samples/scripts/custom_gui.py b/samples/scripts/custom_gui.py
new file mode 100644
index 0000000..a0afbc6
--- /dev/null
+++ b/samples/scripts/custom_gui.py
@@ -0,0 +1,74 @@
+from typing import Literal
+
+import pandas as pd
+import streamlit as st
+import yaml
+
+from apparun.cli.main import generate_gui
+from apparun.gui.panels.base import (
+    ACTION_ADD,
+    InputScenarioFormPanel,
+    StaticOutputPanel,
+    register_panel,
+)
+from apparun.gui.panels.output_dynamic import ScenarioComparisonDynamicOutputPanel
+from apparun.impact_model import ImpactModel
+
+
+@register_panel("polite_markdown")
+class PoliteMarkdown(StaticOutputPanel):
+    type: Literal["polite_markdown"]
+    message: str
+
+    def run(self):
+        st.markdown(f"{self.message}\n\nKind regards.")
+
+
+@register_panel("batch_scenario_comparison_dynamic_output_panel")
+class BatchScenarioComparisonDynamicOutputPanel(ScenarioComparisonDynamicOutputPanel):
+    type: Literal["batch_scenario_comparison_dynamic_output_panel"]
+
+    def __init__(self, **args):
+        super().__init__(**args)
+        self._state["scenarios"] = {}
+
+    def run(
+        self,
+        entry_data,
+        impact_model: ImpactModel = None,
+        lca_data: pd.DataFrame = None,
+    ):
+        if entry_data["action"] == ACTION_ADD:
+            scenario_scores = self.get_results(
+                entry_data["parameters"], impact_model, lca_data
+            )
+            fig = self.result.get_figure(scenario_scores)
+            st.plotly_chart(fig)
+
+
+@register_panel("input_scenario_from_file_panel")
+class ScenarioFromFilePanel(InputScenarioFormPanel):
+    type: Literal["input_scenario_from_file_panel"]
+
+    def run(self):
+        self.st_component = st.form(self._uuid)
+
+        if self.name is not None:
+            self.st_component.markdown(f"### {self.name}")
+
+        uploaded_files = self.st_component.file_uploader(
+            "Upload parameters", accept_multiple_files="directory", type="yaml"
+        )
+        for uploaded_file in uploaded_files:
+            scenario_name = uploaded_file.name.split("/")[-1].split(".")[:-1][0]
+            self._state["parameters"][scenario_name] = yaml.safe_load(
+                uploaded_file.getvalue()
+            )
+
+        scenarios_add = self.st_component.form_submit_button("Compute")
+
+        if scenarios_add and len(uploaded_files) > 0:
+            self._state["action"] = ACTION_ADD
+
+
+generate_gui("samples/conf/custom_gui.yaml")

From e271bcc6e9e51f66ea391dfc60201f60e31028fa Mon Sep 17 00:00:00 2001
From: Maxime PERALTA <maxime.peralta@cea.fr>
Date: Mon, 2 Mar 2026 13:55:09 +0100
Subject: [PATCH 2/4] (update) LCA data and impact model can be accessed by
 static panels

---
 apparun/gui/modules.py              | 4 +++-
 apparun/gui/panels/base.py          | 2 +-
 apparun/gui/panels/output_static.py | 4 +++-
 samples/scripts/custom_gui.py       | 2 +-
 4 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/apparun/gui/modules.py b/apparun/gui/modules.py
index cd21706..15c6298 100644
--- a/apparun/gui/modules.py
+++ b/apparun/gui/modules.py
@@ -93,7 +93,9 @@ def run(self):
         else:
             with self.output_col:
                 for output_panel in self.output_panels:
-                    output_panel.run()
+                    output_panel.run(
+                        impact_model=self.impact_model, lca_data=self.lca_data
+                    )
 
 
 class GUI(BaseModel):
diff --git a/apparun/gui/panels/base.py b/apparun/gui/panels/base.py
index e101b0a..79bf1d1 100644
--- a/apparun/gui/panels/base.py
+++ b/apparun/gui/panels/base.py
@@ -119,7 +119,7 @@ def get_results(
 class StaticOutputPanel(OutputPanel):
     type: Literal["static_output_panel"]
 
-    def run(self):
+    def run(self, impact_model: ImpactModel = None, lca_data: pd.DataFrame = None):
         return
 
 
diff --git a/apparun/gui/panels/output_static.py b/apparun/gui/panels/output_static.py
index 1c7d2c0..9e7b48c 100644
--- a/apparun/gui/panels/output_static.py
+++ b/apparun/gui/panels/output_static.py
@@ -1,8 +1,10 @@
 from typing import Literal
 
+import pandas as pd
 import streamlit as st
 
 from apparun.gui.panels.base import StaticOutputPanel, register_panel
+from apparun.impact_model import ImpactModel
 from apparun.results import ImpactModelResult
 
 
@@ -11,5 +13,5 @@ class Markdown(StaticOutputPanel):
     type: Literal["markdown"]
     message: str
 
-    def run(self):
+    def run(self, impact_model: ImpactModel = None, lca_data: pd.DataFrame = None):
         st.markdown(f"{self.message}")
diff --git a/samples/scripts/custom_gui.py b/samples/scripts/custom_gui.py
index a0afbc6..ec48a6c 100644
--- a/samples/scripts/custom_gui.py
+++ b/samples/scripts/custom_gui.py
@@ -20,7 +20,7 @@ class PoliteMarkdown(StaticOutputPanel):
     type: Literal["polite_markdown"]
     message: str
 
-    def run(self):
+    def run(self, impact_model: ImpactModel = None, lca_data: pd.DataFrame = None):
         st.markdown(f"{self.message}\n\nKind regards.")
 
 

From cdd2dd350980809f2583b40f9aa775277cb6d90d Mon Sep 17 00:00:00 2001
From: Maxime PERALTA <maxime.peralta@cea.fr>
Date: Tue, 3 Mar 2026 11:26:09 +0100
Subject: [PATCH 3/4] (feature) Add GUI title page and favicon support

---
 apparun/gui/modules.py                        | 14 ++++++++++
 samples/conf/custom_gui.yaml                  |  1 +
 samples/conf/sample_gui.yaml                  |  1 +
 tests/data/conf/functional_gui.yaml           |  1 +
 .../data/conf/functional_gui_local_logo.yaml  |  7 +++++
 tests/end_to_end/test_gui.py                  | 28 +++++++++++++++++++
 6 files changed, 52 insertions(+)
 create mode 100644 tests/data/conf/functional_gui_local_logo.yaml

diff --git a/apparun/gui/modules.py b/apparun/gui/modules.py
index 15c6298..c340904 100644
--- a/apparun/gui/modules.py
+++ b/apparun/gui/modules.py
@@ -1,10 +1,14 @@
 from __future__ import annotations
 
+import io
+import re
 import subprocess
 from typing import Annotated, Any, Callable, Dict, List, Optional, TypeVar, Union
 
 import pandas as pd
+import requests
 import streamlit as st
+from PIL import Image
 from pydantic import BaseModel, Field, field_validator
 
 from apparun.gui.panels.base import *
@@ -100,9 +104,19 @@ def run(self):
 
 class GUI(BaseModel):
     name: Optional[str] = None
+    favicon_path: Optional[str] = None
     modules: List[Module]
 
     def setup_layout(self):
+        favicon = None
+        if self.favicon_path is not None:
+            if re.match(r"https?://.*", self.favicon_path):
+                favicon = Image.open(
+                    io.BytesIO(requests.get(self.favicon_path, stream=True).content)
+                )
+            else:
+                favicon = Image.open(self.favicon_path)
+        st.set_page_config(page_title=self.name, page_icon=favicon)
         st.html(
             """
             <style>
diff --git a/samples/conf/custom_gui.yaml b/samples/conf/custom_gui.yaml
index a4e3226..67b06f9 100644
--- a/samples/conf/custom_gui.yaml
+++ b/samples/conf/custom_gui.yaml
@@ -1,4 +1,5 @@
 name: "GUI with custom panels"
+favicon_path: "https://www.cea.fr/PublishingImages/cea.jpg"
 modules:
   - name: "Rude markdown"
     output_panels:
diff --git a/samples/conf/sample_gui.yaml b/samples/conf/sample_gui.yaml
index c52994d..49a4083 100644
--- a/samples/conf/sample_gui.yaml
+++ b/samples/conf/sample_gui.yaml
@@ -1,4 +1,5 @@
 name: "Preconfigured tool for NVIDIA AI GPU"
+favicon_path: "https://www.cea.fr/PublishingImages/cea.jpg"
 modules:
   - impact_model_path: "samples/impact_models/nvidia_ai_gpu_chip.yaml"
     name: "Scenario comparison by phase"
diff --git a/tests/data/conf/functional_gui.yaml b/tests/data/conf/functional_gui.yaml
index abdba25..eef0065 100644
--- a/tests/data/conf/functional_gui.yaml
+++ b/tests/data/conf/functional_gui.yaml
@@ -1,4 +1,5 @@
 name: "Preconfigured tool for NVIDIA AI GPU"
+favicon_path: "https://www.cea.fr/PublishingImages/cea.jpg"
 modules:
   - name: "Random explanation"
     output_panels:
diff --git a/tests/data/conf/functional_gui_local_logo.yaml b/tests/data/conf/functional_gui_local_logo.yaml
new file mode 100644
index 0000000..8c34495
--- /dev/null
+++ b/tests/data/conf/functional_gui_local_logo.yaml
@@ -0,0 +1,7 @@
+name: "Preconfigured tool for NVIDIA AI GPU"
+favicon_path: "tests/data/cea.jpg"
+modules:
+  - name: "Random explanation"
+    output_panels:
+      - type: markdown
+        message: "**Lorem ipsum** dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum."
diff --git a/tests/end_to_end/test_gui.py b/tests/end_to_end/test_gui.py
index 1c44a90..613092a 100644
--- a/tests/end_to_end/test_gui.py
+++ b/tests/end_to_end/test_gui.py
@@ -2,8 +2,13 @@
 This module contains the tests related to the gui command.
 """
 
+import pytest
+from PIL import UnidentifiedImageError
 from streamlit.testing.v1 import AppTest
 
+from apparun.cli.main import load_yaml
+from apparun.gui.modules import GUI
+
 
 def run_test_gui():
     from apparun.cli.main import generate_gui
@@ -20,3 +25,26 @@ def test_streamlit_app_is_deploying():
     at.run()
     # This app should generate three md widgets: one title, one header, one text block.
     assert len(at.markdown) == 3
+
+
+def test_favicons():
+    """
+    Check that local and remote favicon can be loaded.
+    """
+    remote_logo_gui_config = load_yaml("tests/data/conf/functional_gui.yaml", "r")
+    gui = GUI(**remote_logo_gui_config)
+    try:
+        gui.setup_layout()
+    except UnidentifiedImageError:
+        msg = f"Cannot load remote favicon {gui.favicon_path}"
+        pytest.fail(msg)
+
+    local_logo_gui_config = load_yaml(
+        "tests/data/conf/functional_gui_local_logo.yaml", "r"
+    )
+    gui = GUI(**local_logo_gui_config)
+    try:
+        gui.setup_layout()
+    except UnidentifiedImageError:
+        msg = f"Cannot load local favicon {gui.favicon_path}"
+        pytest.fail(msg)

From 5c42d7b5c394feecb300a31241872a199dc8eafc Mon Sep 17 00:00:00 2001
From: Maxime PERALTA <maxime.peralta@cea.fr>
Date: Thu, 5 Mar 2026 10:00:10 +0100
Subject: [PATCH 4/4] (fix) Add missing test logo

---
 tests/data/cea.jpg | Bin 0 -> 16588 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 tests/data/cea.jpg

diff --git a/tests/data/cea.jpg b/tests/data/cea.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..84c1b5ec804ff2b1710f31910289305ef7279dab
GIT binary patch
literal 16588
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

literal 0
HcmV?d00001