# franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026 architecture

> Architecture diagram of the GitHub repository franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026
- Repository: https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026

## Overview

This repository is an experimental ABA-mining toolkit. Its main runtime workflow runs three LLM-assisted tasks: Task 1 extracts topic, span, and sentiment annotations; Task 2 generates body literals from gold or Task 1 outputs; Task 3 classifies contrary relations between phrase pairs. Separate evaluator scripts assess task outputs, while finetune scripts support Task 1 model experiments. The README gives little product detail, so these capabilities are inferred from the source tree and sampled task code; most evaluator and finetune internals were not inspected.

Main entry points: [`ABA_mining/src/llm.py`](https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/src/llm.py) (LLM client), [`ABA_mining/src/config.py`](https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/src/config.py) (Runtime configuration), [`ABA_mining/src/task2.py`](https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/src/task2.py) (Body literals), [`ABA_mining/src/task1.py`](https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/src/task1.py) (Topic span sentiment)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runners["Task runners"]
  node_task1_runner["Task 1 runner<br/>[run_task1.py]"]
  node_task2_runner["Task 2 runner<br/>[run_task2.py]"]
  node_task3_runner["Task 3 runner<br/>[run_task3.py]"]
end

subgraph group_mining["Mining pipeline"]
  node_task1["Topic span sentiment<br/>[task1.py]"]
  node_task2["Body literals<br/>[task2.py]"]
  node_task3["Contrary classification<br/>[task3.py]"]
  node_prompts["Prompt assembly<br/>[prompts.py]"]
  node_llm["LLM client<br/>[llm.py]"]
  node_config["Runtime configuration<br/>[config.py]"]
  node_json_utils["JSON normalization<br/>[utils.py]"]
end

subgraph group_evaluation["Evaluation"]
  node_task_evaluators["Task evaluators"]
  node_results["Result summaries<br/>[results.py]"]
  node_candidate_builder["Task 3 candidates"]
  node_dataset_prep["Dataset preparation<br/>[prepare_dataset.py]"]
end

subgraph group_finetuning["Task 1 finetuning"]
  node_finetune_prep["Training data prep"]
  node_lora_training["LoRA training"]
  node_finetune_inference["Finetuned inference"]
  node_finetune_eval["Finetune evaluation<br/>[eval_task1_2_ft.py]"]
end

node_user(("Experiment operator"))
node_api_models["LLM providers"]

node_user -->|"starts"| node_task1_runner
node_user -->|"starts"| node_task2_runner
node_user -->|"starts"| node_task3_runner
node_task1_runner -->|"assembles prompt"| node_prompts
node_task1_runner -->|"imports client"| node_llm
node_task2_runner -->|"runs"| node_task2
node_task2_runner -->|"imports client"| node_llm
node_task3_runner -.->|"runs"| node_task3
node_task1 -->|"uses"| node_config
node_task1 -->|"uses"| node_llm
node_task1 -->|"uses"| node_prompts
node_task1 -->|"uses"| node_json_utils
node_task2 -->|"uses"| node_config
node_task2 -->|"uses"| node_llm
node_task2 -->|"uses"| node_prompts
node_task2 -->|"uses"| node_json_utils
node_task3 -->|"uses"| node_config
node_task3 -->|"uses"| node_llm
node_task3 -->|"uses"| node_prompts
node_llm -->|"calls provider"| node_api_models
node_task1_runner -.->|"loads settings"| node_config
node_task2_runner -->|"loads settings"| node_config
node_task3_runner -.->|"loads settings"| node_config
node_task_evaluators -.->|"summarizes outputs"| node_results
node_candidate_builder -.->|"prepares inputs"| node_task3
node_dataset_prep -.->|"prepares data"| node_task1
node_finetune_prep -.->|"prepares training data"| node_lora_training
node_lora_training -.->|"trains model for"| node_finetune_inference
node_finetune_inference -.->|"evaluated by"| node_finetune_eval

click node_task1_runner "https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/run_task1.py"
click node_task2_runner "https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/run_task2.py"
click node_task3_runner "https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/run_task3.py"
click node_task1 "https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/src/task1.py"
click node_task2 "https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/src/task2.py"
click node_task3 "https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/src/task3.py"
click node_prompts "https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/src/prompts.py"
click node_llm "https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/src/llm.py"
click node_config "https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/src/config.py"
click node_json_utils "https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/src/utils.py"
click node_task_evaluators "https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/tree/main/ABA_mining/evaluator"
click node_results "https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/results.py"
click node_candidate_builder "https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/build_task3_candidates.py"
click node_dataset_prep "https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/prepare_dataset.py"
click node_finetune_prep "https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/finetune/prepare_task1_data.py"
click node_lora_training "https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/finetune/train_task1_lora.py"
click node_finetune_inference "https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/finetune/run_task1_finetuned.py"
click node_finetune_eval "https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/finetune/eval_task1_2_ft.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_task1_runner,node_task2_runner,node_task3_runner toneBlue
class node_task1,node_task2,node_task3,node_prompts,node_llm,node_config,node_json_utils toneAmber
class node_task_evaluators,node_results,node_candidate_builder,node_dataset_prep toneMint
class node_finetune_prep,node_lora_training,node_finetune_inference,node_finetune_eval toneRose
class node_user,node_api_models toneIndigo
```

## Components

### Task runners

- [Task 1 runner](https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/run_task1.py): `ABA_mining/run_task1.py`
- [Task 2 runner](https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/run_task2.py): `ABA_mining/run_task2.py`
- [Task 3 runner](https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/run_task3.py): `ABA_mining/run_task3.py`

### Mining pipeline

- [Topic span sentiment](https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/src/task1.py): `ABA_mining/src/task1.py`
- [Body literals](https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/src/task2.py): `ABA_mining/src/task2.py`
- [Contrary classification](https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/src/task3.py): `ABA_mining/src/task3.py`
- [Prompt assembly](https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/src/prompts.py): `ABA_mining/src/prompts.py`
- [LLM client](https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/src/llm.py): `ABA_mining/src/llm.py`
- [Runtime configuration](https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/src/config.py): `ABA_mining/src/config.py`
- [JSON normalization](https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/src/utils.py): `ABA_mining/src/utils.py`

### Evaluation

- [Task evaluators](https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/tree/main/ABA_mining/evaluator): `ABA_mining/evaluator`
- [Result summaries](https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/results.py): `ABA_mining/results.py`
- [Task 3 candidates](https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/build_task3_candidates.py): `ABA_mining/build_task3_candidates.py`
- [Dataset preparation](https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/prepare_dataset.py): `ABA_mining/prepare_dataset.py`

### Task 1 finetuning

- [Training data prep](https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/finetune/prepare_task1_data.py): `ABA_mining/finetune/prepare_task1_data.py`
- [LoRA training](https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/finetune/train_task1_lora.py): `ABA_mining/finetune/train_task1_lora.py`
- [Finetuned inference](https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/finetune/run_task1_finetuned.py): `ABA_mining/finetune/run_task1_finetuned.py`
- [Finetune evaluation](https://github.com/franzerz/aba-mining-tasks-llms-group-kmitl-internship-2026/blob/main/ABA_mining/finetune/eval_task1_2_ft.py): `ABA_mining/finetune/eval_task1_2_ft.py`

### Other components

- **Experiment operator**
- **LLM providers**

## Connections

- Experiment operator → Task 1 runner: starts
- Experiment operator → Task 2 runner: starts
- Experiment operator → Task 3 runner: starts
- Task 1 runner → Prompt assembly: assembles prompt (evidence: `ABA_mining/run_task1.py`)
- Task 1 runner → LLM client: imports client (evidence: `ABA_mining/run_task1.py`)
- Task 2 runner → Body literals: runs (evidence: `ABA_mining/run_task2.py`)
- Task 2 runner → LLM client: imports client (evidence: `ABA_mining/run_task2.py`)
- Task 3 runner → Contrary classification: runs
- Topic span sentiment → Runtime configuration: uses (evidence: `ABA_mining/src/task1.py`)
- Topic span sentiment → LLM client: uses (evidence: `ABA_mining/src/task1.py`)
- Topic span sentiment → Prompt assembly: uses (evidence: `ABA_mining/src/task1.py`)
- Topic span sentiment → JSON normalization: uses (evidence: `ABA_mining/src/task1.py`)
- Body literals → Runtime configuration: uses (evidence: `ABA_mining/src/task2.py`)
- Body literals → LLM client: uses (evidence: `ABA_mining/src/task2.py`)
- Body literals → Prompt assembly: uses (evidence: `ABA_mining/src/task2.py`)
- Body literals → JSON normalization: uses (evidence: `ABA_mining/src/task2.py`)
- Contrary classification → Runtime configuration: uses (evidence: `ABA_mining/src/task3.py`)
- Contrary classification → LLM client: uses (evidence: `ABA_mining/src/task3.py`)
- Contrary classification → Prompt assembly: uses (evidence: `ABA_mining/src/task3.py`)
- LLM client → LLM providers: calls provider (evidence: `ABA_mining/src/llm.py`)
- Task 1 runner → Runtime configuration: loads settings
- Task 2 runner → Runtime configuration: loads settings (evidence: `ABA_mining/run_task2.py`)
- Task 3 runner → Runtime configuration: loads settings
- Task evaluators → Result summaries: summarizes outputs
- Task 3 candidates → Contrary classification: prepares inputs
- Dataset preparation → Topic span sentiment: prepares data
- Training data prep → LoRA training: prepares training data
- LoRA training → Finetuned inference: trains model for
- Finetuned inference → Finetune evaluation: evaluated by
