Create README.md
Browse files
README.md
ADDED
|
@@ -0,0 +1,56 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
language: en
|
| 3 |
+
license: apache-2.0
|
| 4 |
+
tags:
|
| 5 |
+
- token-classification
|
| 6 |
+
- named-entity-recognition
|
| 7 |
+
- ner
|
| 8 |
+
- esg
|
| 9 |
+
- sustainability
|
| 10 |
+
- financial-ner
|
| 11 |
+
- xbrl
|
| 12 |
+
datasets:
|
| 13 |
+
- custom
|
| 14 |
+
metrics:
|
| 15 |
+
- precision
|
| 16 |
+
- recall
|
| 17 |
+
- f1
|
| 18 |
+
model-index:
|
| 19 |
+
- name: esg-ner-sb253
|
| 20 |
+
results: []
|
| 21 |
+
---
|
| 22 |
+
|
| 23 |
+
# ESG/Financial NER Model (sb253)
|
| 24 |
+
|
| 25 |
+
A custom Named Entity Recognition (NER) model trained for extracting key entities from ESG (Environmental, Social, and Governance) reports, sustainability documents, and financial statements.
|
| 26 |
+
|
| 27 |
+
## Model Description
|
| 28 |
+
|
| 29 |
+
This model identifies and classifies entities relevant to ESG reporting and financial analysis, supporting automated data extraction from sustainability reports, XBRL filings, and financial documents.
|
| 30 |
+
|
| 31 |
+
**Model Architecture**: XLM-RoBERTa-based Token Classification
|
| 32 |
+
**Model Size**: ~800MB
|
| 33 |
+
**Training Domain**: ESG/Sustainability/Financial Reports
|
| 34 |
+
**Inference**: Optimized for CPU deployment on Google Cloud Run
|
| 35 |
+
|
| 36 |
+
## Supported Entity Types
|
| 37 |
+
|
| 38 |
+
| Entity Type | Description | Examples |
|
| 39 |
+
|------------|-------------|----------|
|
| 40 |
+
| **CONCEPT** | ESG concepts, metrics, and terminology | "carbon emissions", "renewable energy", "employee satisfaction" |
|
| 41 |
+
| **VALUE** | Numerical values and amounts | "15%", "2.5 million", "50 tons" |
|
| 42 |
+
| **UNIT** | Units of measurement | "CO2e", "USD", "percent", "GWh" |
|
| 43 |
+
| **PERIOD** | Time periods and reporting dates | "Q4 2024", "fiscal year 2023", "January-March" |
|
| 44 |
+
| **ENTITY** | Organizations, companies, subsidiaries | "Acme Corporation", "European Union", "Board of Directors" |
|
| 45 |
+
| **CHANGE** | Change indicators and trends | "increased", "decreased", "reduced by", "grew" |
|
| 46 |
+
|
| 47 |
+
## Usage
|
| 48 |
+
|
| 49 |
+
### Deployment on Google Cloud Run
|
| 50 |
+
|
| 51 |
+
The model is deployed as a FastAPI service with the following endpoints:
|
| 52 |
+
|
| 53 |
+
**Base URL**: `https://ner-backend-171009084156.europe-west1.run.app`
|
| 54 |
+
|
| 55 |
+
#### Endpoints
|
| 56 |
+
```bash
|