skillware 0.1.0__tar.gz

skillware-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ARPA Hellenic Logical Systems
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

skillware-0.1.0/PKG-INFO

@@ -0,0 +1,224 @@
+Metadata-Version: 2.4
+Name: skillware
+Version: 0.1.0
+Summary: A framework for modular, self-contained AI skills.
+Author-email: ARPA Hellenic Logic Systems <skillware-os@arpacorp.net>
+License: MIT License
+        
+        Copyright (c) 2026 ARPA Hellenic Logical Systems
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://arpacorp.net
+Project-URL: Repository, https://github.com/arpahls/skillware
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: pyyaml
+Requires-Dist: anthropic
+Requires-Dist: google-generativeai
+Requires-Dist: pymupdf
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-mock; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+  <img src="assets/skillware_logo.png" alt="Skillware Logo" width="400px" />
+
+  A Python framework for modular, self-contained skill management for machines.
+</div>
+
+<br/>
+
+<div align="center">
+  <img src="https://img.shields.io/badge/License-MIT-efcefa?style=flat-square" alt="License">
+  <img src="https://img.shields.io/badge/Python-3.11+-bae6fd?style=flat-square" alt="Python Version">
+  <img src="https://img.shields.io/badge/PyPI-v0.1.0-bbf7d0?style=flat-square" alt="PyPI Version">
+</div>
+
+<br/>
+
+<div align="center">
+  <a href="#mission">Mission</a> •
+  <a href="#repository-structure">Architecture</a> •
+  <a href="#quick-start">Quick Start</a> •
+  <a href="#documentation">Documentation</a> •
+  <a href="#contributing">Contributing</a> •
+  <a href="#comparison">Comparison</a> •
+  <a href="#contact">Contact</a>
+</div>
+
+---
+
+**Skillware** is an open-source framework and registry for modular, actionable Agent capabilities. It treats **Skills** as installable content, decoupling capability from intelligence. Just as `apt-get` installs software and `pip` installs libraries, `skillware` installs *know-how* for AI agents.
+
+> "I know Kung Fu." - Neo
+
+## Mission
+
+The AI ecosystem is fragmented. Developers often re-invent tool definitions, system prompts, and safety rules for every project. **Skillware** supplies a standard to package capabilities into self-contained units that work across **Gemini**, **Claude**, **GPT**, and **Llama**.
+
+A **Skill** in this framework provides everything an Agent needs to master a domain:
+
+1.  **Logic**: Executable Python code.
+2.  **Cognition**: System instructions and "cognitive maps".
+3.  **Governance**: Constitution and safety boundaries.
+4.  **Interface**: Standardized schemas for LLM tool calling.
+
+## Repository Structure
+
+This repository is organized into a core framework, a registry of skills, and documentation.
+
+```text
+Skillware/
+├── skillware/                  # Core Framework Package
+│   └── core/
+│       ├── base_skill.py       # Abstract Base Class for skills
+│       ├── loader.py           # Universal Skill Loader & Model Adapter
+│       └── env.py              # Environment Management
+├── skills/                     # Skill Registry (Domain-driven)
+│   └── finance/
+│       └── wallet_screening/
+│           ├── skill.py        # Logic
+│           ├── manifest.yaml   # Metadata & Constitution
+│           ├── instructions.md # Cognitive Map
+│           ├── card.json       # UI Presentation
+│           ├── data/           # Integrated Knowledge Base
+│           └── maintenance/    # Maintenance Tools
+│   └── office/
+│       └── pdf_form_filler/
+│           ├── skill.py        # Logic
+│           ├── manifest.yaml   # Metadata
+│           ├── instructions.md # Cognitive Map
+│           ├── utils.py        # PDF Processing
+│           └── card.json       # UI Presentation
+├── templates/                  # New Skill Templates
+│   └── python_skill/           # Standard Python Skill Template
+├── examples/                   # Reference Implementations
+│   ├── gemini_wallet_check.py  # Google Gemini Integration
+│   ├── claude_wallet_check.py  # Anthropic Claude Integration
+│   ├── gemini_pdf_form_filler.py
+│   └── claude_pdf_form_filler.py
+├── docs/                       # Comprehensive Documentation
+│   ├── introduction.md         # Philosophy & Design
+│   ├── usage/                  # Integration Guides
+│   └── skills/                 # Skill Reference Cards
+└── COMPARISON.md               # Comparison vs. Anthropic Skills / MCP
+```
+
+## Quick Start
+
+### 1. Installation
+
+You can install Skillware directly from GitHub:
+
+```bash
+pip install git+https://github.com/arpahls/skillware.git
+```
+
+Or for development, clone the repository and install in editable mode:
+
+```bash
+git clone https://github.com/arpahls/skillware.git
+cd skillware
+pip install -e .
+```
+
+> **Note**: Individual skills may have their own dependencies. The `SkillLoader` validates `manifest.yaml` and warns of missing packages (e.g., `requests`, `pandas`) upon loading a skill.
+
+### 2. Configuration
+
+Create a `.env` file with your API keys (e.g., Google Gemini API Key):
+
+```ini
+GOOGLE_API_KEY="your_key"
+```
+
+### 3. Usage Example (Gemini)
+
+```python
+import google.generativeai as genai
+from skillware.core.loader import SkillLoader
+from skillware.core.env import load_env_file
+
+# Load Environment
+load_env_file()
+
+# 1. Load the Skill
+# The loader reads the code, manifest, and instructions automatically
+skill_bundle = SkillLoader.load_skill("finance/wallet_screening")
+
+# 2. Model & Chat Setup
+model = genai.GenerativeModel(
+    'gemini-2.5-flash',
+    tools=[SkillLoader.to_gemini_tool(skill_bundle)], # The "Adapter"
+    system_instruction=skill_bundle['instructions']   # The "Mind"
+)
+chat = model.start_chat(enable_automatic_function_calling=True)
+
+# 3. Agent Loop
+# The SDK handles the loop: model -> tool call -> execution -> result -> model reply.
+response = chat.send_message("Screen wallet 0xd8dA... for risks.")
+print(response.text)
+```
+
+## Documentation
+
+*   **[Core Logic & Philosophy](docs/introduction.md)**: Details on how Skillware decouples Logic, Cognition, and Governance.
+*   **[Usage Guide: Gemini](docs/usage/gemini.md)**: Integration with Google's GenAI SDK.
+*   **[Usage Guide: Claude](docs/usage/claude.md)**: Integration with Anthropic's SDK.
+*   **[Skill Library](docs/skills/README.md)**: Available capabilities.
+
+## Contributing
+
+We are building the "App Store" for Agents and require professional, robust, and safe skills.
+
+Please read **[CONTRIBUTING.md](CONTRIBUTING.md)** for guidelines on folder structure, manifest schemas, and safety constitutions.
+
+## Comparison
+
+Skillware differs from the Model Context Protocol (MCP) or Anthropic's Skills repository in the following ways:
+
+*   **Model Agnostic**: Native adapters for Gemini, Claude, and OpenAI.
+*   **Code-First**: Skills are executable Python packages, not just server specs.
+*   **Runtime-Focused**: Provides tools for the application, not just recipes for an IDE.
+
+[Read the full comparison here](COMPARISON.md).
+
+## Contact
+
+For questions, suggestions, or contributions, please open an issue or reach out to us:
+
+*   **Email**: [skillware-os@arpacorp.net](mailto:skillware-os@arpacorp.net)
+*   **Issues**: [GitHub Issues](https://github.com/arpahls/skillware/issues)
+
+---
+
+<div align="center">
+    <img src="assets/arpalogo.png" alt="ARPA Logo" width="50px" />
+    <br/>
+    Built & Maintained by ARPA Hellenic Logical Systems & the Community
+</div>

skillware-0.1.0/README.md

@@ -0,0 +1,177 @@
+<div align="center">
+  <img src="assets/skillware_logo.png" alt="Skillware Logo" width="400px" />
+
+  A Python framework for modular, self-contained skill management for machines.
+</div>
+
+<br/>
+
+<div align="center">
+  <img src="https://img.shields.io/badge/License-MIT-efcefa?style=flat-square" alt="License">
+  <img src="https://img.shields.io/badge/Python-3.11+-bae6fd?style=flat-square" alt="Python Version">
+  <img src="https://img.shields.io/badge/PyPI-v0.1.0-bbf7d0?style=flat-square" alt="PyPI Version">
+</div>
+
+<br/>
+
+<div align="center">
+  <a href="#mission">Mission</a> •
+  <a href="#repository-structure">Architecture</a> •
+  <a href="#quick-start">Quick Start</a> •
+  <a href="#documentation">Documentation</a> •
+  <a href="#contributing">Contributing</a> •
+  <a href="#comparison">Comparison</a> •
+  <a href="#contact">Contact</a>
+</div>
+
+---
+
+**Skillware** is an open-source framework and registry for modular, actionable Agent capabilities. It treats **Skills** as installable content, decoupling capability from intelligence. Just as `apt-get` installs software and `pip` installs libraries, `skillware` installs *know-how* for AI agents.
+
+> "I know Kung Fu." - Neo
+
+## Mission
+
+The AI ecosystem is fragmented. Developers often re-invent tool definitions, system prompts, and safety rules for every project. **Skillware** supplies a standard to package capabilities into self-contained units that work across **Gemini**, **Claude**, **GPT**, and **Llama**.
+
+A **Skill** in this framework provides everything an Agent needs to master a domain:
+
+1.  **Logic**: Executable Python code.
+2.  **Cognition**: System instructions and "cognitive maps".
+3.  **Governance**: Constitution and safety boundaries.
+4.  **Interface**: Standardized schemas for LLM tool calling.
+
+## Repository Structure
+
+This repository is organized into a core framework, a registry of skills, and documentation.
+
+```text
+Skillware/
+├── skillware/                  # Core Framework Package
+│   └── core/
+│       ├── base_skill.py       # Abstract Base Class for skills
+│       ├── loader.py           # Universal Skill Loader & Model Adapter
+│       └── env.py              # Environment Management
+├── skills/                     # Skill Registry (Domain-driven)
+│   └── finance/
+│       └── wallet_screening/
+│           ├── skill.py        # Logic
+│           ├── manifest.yaml   # Metadata & Constitution
+│           ├── instructions.md # Cognitive Map
+│           ├── card.json       # UI Presentation
+│           ├── data/           # Integrated Knowledge Base
+│           └── maintenance/    # Maintenance Tools
+│   └── office/
+│       └── pdf_form_filler/
+│           ├── skill.py        # Logic
+│           ├── manifest.yaml   # Metadata
+│           ├── instructions.md # Cognitive Map
+│           ├── utils.py        # PDF Processing
+│           └── card.json       # UI Presentation
+├── templates/                  # New Skill Templates
+│   └── python_skill/           # Standard Python Skill Template
+├── examples/                   # Reference Implementations
+│   ├── gemini_wallet_check.py  # Google Gemini Integration
+│   ├── claude_wallet_check.py  # Anthropic Claude Integration
+│   ├── gemini_pdf_form_filler.py
+│   └── claude_pdf_form_filler.py
+├── docs/                       # Comprehensive Documentation
+│   ├── introduction.md         # Philosophy & Design
+│   ├── usage/                  # Integration Guides
+│   └── skills/                 # Skill Reference Cards
+└── COMPARISON.md               # Comparison vs. Anthropic Skills / MCP
+```
+
+## Quick Start
+
+### 1. Installation
+
+You can install Skillware directly from GitHub:
+
+```bash
+pip install git+https://github.com/arpahls/skillware.git
+```
+
+Or for development, clone the repository and install in editable mode:
+
+```bash
+git clone https://github.com/arpahls/skillware.git
+cd skillware
+pip install -e .
+```
+
+> **Note**: Individual skills may have their own dependencies. The `SkillLoader` validates `manifest.yaml` and warns of missing packages (e.g., `requests`, `pandas`) upon loading a skill.
+
+### 2. Configuration
+
+Create a `.env` file with your API keys (e.g., Google Gemini API Key):
+
+```ini
+GOOGLE_API_KEY="your_key"
+```
+
+### 3. Usage Example (Gemini)
+
+```python
+import google.generativeai as genai
+from skillware.core.loader import SkillLoader
+from skillware.core.env import load_env_file
+
+# Load Environment
+load_env_file()
+
+# 1. Load the Skill
+# The loader reads the code, manifest, and instructions automatically
+skill_bundle = SkillLoader.load_skill("finance/wallet_screening")
+
+# 2. Model & Chat Setup
+model = genai.GenerativeModel(
+    'gemini-2.5-flash',
+    tools=[SkillLoader.to_gemini_tool(skill_bundle)], # The "Adapter"
+    system_instruction=skill_bundle['instructions']   # The "Mind"
+)
+chat = model.start_chat(enable_automatic_function_calling=True)
+
+# 3. Agent Loop
+# The SDK handles the loop: model -> tool call -> execution -> result -> model reply.
+response = chat.send_message("Screen wallet 0xd8dA... for risks.")
+print(response.text)
+```
+
+## Documentation
+
+*   **[Core Logic & Philosophy](docs/introduction.md)**: Details on how Skillware decouples Logic, Cognition, and Governance.
+*   **[Usage Guide: Gemini](docs/usage/gemini.md)**: Integration with Google's GenAI SDK.
+*   **[Usage Guide: Claude](docs/usage/claude.md)**: Integration with Anthropic's SDK.
+*   **[Skill Library](docs/skills/README.md)**: Available capabilities.
+
+## Contributing
+
+We are building the "App Store" for Agents and require professional, robust, and safe skills.
+
+Please read **[CONTRIBUTING.md](CONTRIBUTING.md)** for guidelines on folder structure, manifest schemas, and safety constitutions.
+
+## Comparison
+
+Skillware differs from the Model Context Protocol (MCP) or Anthropic's Skills repository in the following ways:
+
+*   **Model Agnostic**: Native adapters for Gemini, Claude, and OpenAI.
+*   **Code-First**: Skills are executable Python packages, not just server specs.
+*   **Runtime-Focused**: Provides tools for the application, not just recipes for an IDE.
+
+[Read the full comparison here](COMPARISON.md).
+
+## Contact
+
+For questions, suggestions, or contributions, please open an issue or reach out to us:
+
+*   **Email**: [skillware-os@arpacorp.net](mailto:skillware-os@arpacorp.net)
+*   **Issues**: [GitHub Issues](https://github.com/arpahls/skillware/issues)
+
+---
+
+<div align="center">
+    <img src="assets/arpalogo.png" alt="ARPA Logo" width="50px" />
+    <br/>
+    Built & Maintained by ARPA Hellenic Logical Systems & the Community
+</div>

skillware-0.1.0/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "skillware"
+version = "0.1.0"
+description = "A framework for modular, self-contained AI skills."
+readme = "README.md"
+authors = [
+  { name = "ARPA Hellenic Logic Systems", email = "skillware-os@arpacorp.net" },
+]
+urls = { "Homepage" = "https://arpacorp.net", "Repository" = "https://github.com/arpahls/skillware" }
+license = { file = "LICENSE" }
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "requests",
+    "pyyaml",
+    "anthropic",
+    "google-generativeai",
+    "pymupdf",
+]
+requires-python = ">=3.10"
+
+[project.optional-dependencies]
+dev = [
+    "pytest",
+    "pytest-mock",
+    "flake8",
+    "black",
+]
+
+[tool.setuptools.packages.find]
+include = ["skillware*", "skills*"]

skillware-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

skillware-0.1.0/skills/finance/wallet_screening/__init__.py

@@ -0,0 +1,3 @@
+from .skill import WalletScreeningSkill
+
+__all__ = ["WalletScreeningSkill"]

skillware-0.1.0/skills/finance/wallet_screening/maintenance/normalization_tool.py

@@ -0,0 +1,134 @@
+import os
+import csv
+import json
+import shutil
+from datetime import datetime
+
+# Paths relative to this script (skillware/skills/finance/wallet_screening/maintenance/)
+BASE_DIR = os.path.dirname(os.path.abspath(__file__))
+NEW_NORM_DIR = os.path.join(BASE_DIR, "new_norm")
+PAST_NORM_DIR = os.path.join(BASE_DIR, "past_norm")
+# Data goes up one level to the skill's data folder
+DATASETS_DIR = os.path.abspath(os.path.join(BASE_DIR, "..", "data"))
+LOGS_DIR = os.path.join(BASE_DIR, "norm_logs")
+
+os.makedirs(NEW_NORM_DIR, exist_ok=True)
+os.makedirs(PAST_NORM_DIR, exist_ok=True)
+os.makedirs(DATASETS_DIR, exist_ok=True)
+os.makedirs(LOGS_DIR, exist_ok=True)
+
+
+def normalize_israel_nbctf_csv(filepath):
+    norm = []
+    with open(filepath, encoding="utf-8-sig") as f:
+        reader = csv.DictReader(f)
+        for row in reader:
+            if row.get("schema", "").strip().lower() == "wallet":
+                address = row.get("account/wallet_id", "").strip().lower()
+                if not address:
+                    continue
+                norm.append(
+                    {
+                        "address": address,
+                        "network": row.get("platform", "").strip() or "Unknown",
+                        "label": "Israel NBCTF",
+                        "source": "Israel NBCTF",
+                        "source_url": row.get("order_url", "").strip(),
+                        "reason": f"Sanctions Order {row.get('order_id', '').strip()}",
+                        "jurisdiction": "IL",
+                        "extra": {
+                            k: v
+                            for k, v in row.items()
+                            if k
+                            not in [
+                                "account/wallet_id",
+                                "platform",
+                                "order_url",
+                                "order_id",
+                            ]
+                        },
+                    }
+                )
+    return norm
+
+
+def normalize_fbi_lazarus_csv(filepath):
+    norm = []
+    with open(filepath, encoding="utf-8-sig") as f:
+        reader = csv.DictReader(f)
+        for row in reader:
+            address = row.get("Address", "").strip().lower()
+            if not address:
+                continue
+            norm.append(
+                {
+                    "address": address,
+                    "network": row.get("Network", "").strip(),
+                    "label": row.get("Linked to", "").strip() or "FBI",
+                    "source": "FBI",
+                    "source_url": row.get("Source URL", "").strip(),
+                    "reason": "Sanctions/Blacklist",
+                    "jurisdiction": "US",
+                    "extra": {
+                        k: v
+                        for k, v in row.items()
+                        if k not in ["Address", "Network", "Linked to", "Source URL"]
+                    },
+                }
+            )
+    return norm
+
+
+def normalize_file(filepath):
+    filename = os.path.basename(filepath)
+    if "nbctf" in filename.lower():
+        return normalize_israel_nbctf_csv(filepath), "israel_nbctf"
+    elif "lazarus" in filename.lower():
+        return normalize_fbi_lazarus_csv(filepath), "fbi_lazarus"
+    else:
+        # Try to guess structure or skip
+        return [], None
+
+
+def main():
+    print(f"Scanning for new files in: {NEW_NORM_DIR}")
+    log_entries = []
+    if not os.path.exists(NEW_NORM_DIR):
+        print("No new_norm directory found.")
+        return
+
+    files = os.listdir(NEW_NORM_DIR)
+    if not files:
+        print("No files found to normalize.")
+        return
+
+    for fname in files:
+        fpath = os.path.join(NEW_NORM_DIR, fname)
+        if not os.path.isfile(fpath):
+            continue
+        norm_data, tag = normalize_file(fpath)
+        if norm_data and tag:
+            outname = (
+                f'normalized_{tag}_{datetime.now().strftime("%Y%m%d_%H%M%S")}.json'
+            )
+            outpath = os.path.join(DATASETS_DIR, outname)
+            with open(outpath, "w", encoding="utf-8") as outf:
+                json.dump(norm_data, outf, indent=2, ensure_ascii=False)
+            log_entries.append(
+                f"Normalized {fname} to {outname} ({len(norm_data)} entries)"
+            )
+        else:
+            log_entries.append(f"Skipped {fname} (unrecognized format or no data)")
+        # Move original to past_norm
+        shutil.move(fpath, os.path.join(PAST_NORM_DIR, fname))
+    # Write log
+    logname = f'normlog_{datetime.now().strftime("%Y%m%d_%H%M%S")}.txt'
+    logpath = os.path.join(LOGS_DIR, logname)
+    with open(logpath, "w", encoding="utf-8") as logf:
+        for entry in log_entries:
+            logf.write(entry + "\n")
+    print(f"Normalization complete. Log saved to {logpath}")
+
+
+if __name__ == "__main__":
+    main()

skillware-0.1.0/skills/finance/wallet_screening/maintenance/normalize_uniswap_trm.py

@@ -0,0 +1,80 @@
+import csv
+import json
+import os
+
+# Paths relative to this script
+BASE_DIR = os.path.dirname(os.path.abspath(__file__))
+NEW_NORM_DIR = os.path.join(BASE_DIR, "new_norm")
+# Output goes to skill's data folder
+DATASETS_DIR = os.path.abspath(os.path.join(BASE_DIR, "..", "data"))
+
+
+def get_etherscan_label(address):
+    # Optionally, use Etherscan API to get contract label
+    # For now, just return None (or use a mapping for known addresses)
+    known_labels = {
+        "0x000000000000000000000000000000000000dead": "Ethereum Dead Address (Burn Address)",
+        "0x910Cbd523D972eb0a6f4cAe4618aD62622b39DbF": "Tornado Cash",
+        # Add more known addresses here if desired
+    }
+    return known_labels.get(address.lower())
+
+
+def normalize_uniswap_trm_csv(csv_path):
+    seen = set()
+    entries = []
+    with open(csv_path, newline="", encoding="utf-8") as f:
+        reader = csv.DictReader(f)
+        for row in reader:
+            address = row["address"]
+            category = row["category"]
+            risk = row["categoryRiskScoreLevelLabel"]
+            if not address.lower().startswith("0x"):
+                continue  # skip non-Ethereum addresses
+            if (
+                category not in ["Mixer", "Sanctions", "Scam", "Hacked or Stolen Funds"]
+            ) or (risk not in ["High", "Severe"]):
+                continue
+            key = (address.lower(), category, risk)
+            if key in seen:
+                continue
+            seen.add(key)
+            label = get_etherscan_label(address) or category
+            entry = {
+                "address": address,
+                "name": label,
+                "created_at": "",  # Not available in CSV
+                "creator": "",
+                "reason": f"{category} ({risk})",
+                "source": "Uniswap-TRM Risk List",
+                "jurisdictions_blocked": [],
+                "severity": "critical" if risk == "Severe" else "high",
+                "known_victims": [],
+                "related_hashes": [],
+                "references": [],
+                "tags": [category.lower(), "uniswap-trm"],
+                "notes": (
+                    f"category: {category}, risk: {risk}, riskType: {row.get('riskType', '')}, "
+                    f"totalVolumeUsd: {row.get('totalVolumeUsd', '')}"
+                ),
+            }
+            entries.append(entry)
+    return entries
+
+
+if __name__ == "__main__":
+    if not os.path.exists(NEW_NORM_DIR):
+        print(f"Directory not found: {NEW_NORM_DIR}")
+        exit(1)
+
+    csv_path = os.path.join(NEW_NORM_DIR, "uniswap-trm.csv")
+    if not os.path.exists(csv_path):
+        print(f"File not found: {csv_path}")
+        exit(1)
+
+    output_path = os.path.join(DATASETS_DIR, "normalized_uniswap_trm.json")
+
+    normalized = normalize_uniswap_trm_csv(csv_path)
+    with open(output_path, "w", encoding="utf-8") as f:
+        json.dump(normalized, f, indent=2, ensure_ascii=False)
+    print(f"Normalized {len(normalized)} entries to {output_path}")