| --- |
| license: apache-2.0 |
| library_name: transformers |
| pipeline_tag: text-classification |
| base_model: answerdotai/ModernBERT-base |
| tags: |
| - ner |
| - on-device |
| - privacy |
| - flowx |
| - openner |
| - logistics |
| - de-identification |
| - text-classification |
| metrics: |
| - f1 |
| --- |
| |
| # HSCodeClassify |
|
|
| **HSCodeClassify** is a small, on-device logistics text classifier from the FlowX **OpenNER** family. Developed by **FlowX.AI**. Runs 100% on-premise / air-gapped, so no data leaves your boundary. |
|
|
| ## What it does |
| - **Task:** text-classification |
| - **Base model:** `answerdotai/ModernBERT-base` |
| - **Classes (20):** 03 Fish & seafood, 08 Edible fruit & nuts, 09 Coffee, tea & spices, 22 Beverages & spirits, 30 Pharmaceuticals, 39 Plastics & articles, 40 Rubber & articles, 44 Wood & articles, 48 Paper & paperboard, 61 Apparel, knitted, 62 Apparel, not knitted, 64 Footwear, 72 Iron & steel, 73 Articles of iron/steel, 84 Machinery & mechanical, 85 Electrical machinery, 87 Vehicles & parts, 90 Optical/medical instr., 94 Furniture & bedding, 95 Toys, games & sports |
| - **Held-out F1:** 1.0000 |
| - **Runtime:** CPU, Apple Silicon, one GPU, or browser/edge via ONNX (INT8). ~100-160 ms/doc on CPU. |
|
|
| ## Why a small model |
| Fine-tuned encoders match or beat frontier LLMs on structured, convention-bound extraction, at a fraction of the latency and cost, with **zero data egress**. Identifiers are validated by checksum (IBAN mod-97, card Luhn, ISIN/LEI, container ISO-6346, VIN, national IDs), a correctness guarantee general LLMs lack. See the FlowX OpenNER benchmark for measured results. |
|
|
| ## Usage |
| ```python |
| from transformers import AutoTokenizer, AutoModelForSequenceClassification |
| tok = AutoTokenizer.from_pretrained("flowxai/hscodeclassify") |
| model = AutoModelForSequenceClassification.from_pretrained("flowxai/hscodeclassify") |
| ``` |
|
|
| ## License & attribution |
| Licensed under the **Apache License 2.0**. Copyright 2026 **FlowX.AI** (https://flowx.ai). See the `NOTICE` file. Trained on synthetic, checksum-validated data. |
|
|
| _Part of the FlowX OpenNER model family. Synthetic-data F1 reflects an in-distribution synthetic distribution; validate on real documents before production use._ |
