fast_gliner

Python bindings for the Rust inference engine gline-rs — providing fast CPU/GPU inference for GLiNER and GLiNER2 models.

fast_gliner exposes a simple Python API while delegating all heavy computation to a Rust runtime powered by ONNX Runtime.

---

✨ Features

• 🚀 High-performance inference using Rust
• 🧠 Supports GLiNER and GLiNER2 models
• ⚡ ~4× faster CPU inference than the PyTorch implementation
• 🐍 Simple Python API
• 🖥 Optional CUDA execution through ONNX Runtime

---

⏳ Installation

Pre-built wheel (CPU)

$ pip install fast_gliner

Building from source

$ pip install --no-binary=:all: fast_gliner

Building with CUDA

$ pip install --no-binary=:all: fast_gliner[cuda]

---

🚀 Quickstart

Named Entity Recognition

GLiNER2 (recommended)

from fast_gliner import FastGLiNER2

model = FastGLiNER2.from_pretrained(
    "lion-ai/gliner2-multi-v1-onnx"
)

model.predict_entities(
    "I am James Bond",
    ["person"]
)

GLiNER

from fast_gliner import FastGLiNER

model = FastGLiNER.from_pretrained(
    model_id="onnx-community/gliner_multi-v2.1-onnx",
    execution_provider="cpu",
)

model.predict_entities("I am James Bond", ["person"])

Output:

[
    {
        'text': 'James Bond',
        'label': 'person',
        'score': 0.9012733697891235,
        'start': 5,
        'end': 15
    }
]

---

Classification

from fast_gliner import FastGLiNER2

model = FastGLiNER2.from_pretrained(
    "lion-ai/gliner2-multi-v1-onnx"
)

model.classify("Buy milk and eggs after work", ["shopping", "work", "personal"])

Output:

[
    ('shopping', 0.93), 
    ('personal', 0.61), 
    ('work', 0.44)
]

---

Structured Extraction

from fast_gliner import FastGLiNER2

model = FastGLiNER2.from_pretrained(
    "lion-ai/gliner2-multi-v1-onnx"
)

text = """Contact: John Smith
Email: john@example.com
Phones: 555-1234, 555-5678
Address: 123 Main St, NYC"""

result = model.extract_json(
    text,
    {
        "contact": [
            "name::str",
            "email::str",
            "phone::list",
            "address"
        ]
    }
)

Output:

{
    'contact': [
        {
            'address': ['123 Main St, NYC'],
            'email': 'john@example.com',
            'name': 'John Smith',
            'phone': ['555-1234', '555-5678']
        }
    ]
}

---

Relation Extraction

GLiNER2

from fast_gliner import FastGLiNER2

model = FastGLiNER2.from_pretrained(
    "lion-ai/gliner2-multi-v1-onnx"
)

text = "Bill Gates founded Microsoft."

labels = ["person", "organization"]

schema = [
    {
        "relation": "founded",
        "subject_labels": ["person"],
        "object_labels": ["organization"]
    }
]

model.extract_relations(text, labels, schema)

GLiNER

from fast_gliner import FastGLiNER

model = FastGLiNER.from_pretrained(
    model_id="onnx-community/gliner-multitask-large-v0.5",
    onnx_path="onnx/model.onnx"
)

text = "Bill Gates is the founder of Microsoft."

labels = ["person", "organization"]

schema = [
    {
        "relation": "founder",
        "subject_labels": ["person"],
        "object_labels": ["organization"]
    }
]

model.extract_relations(text, labels, schema)

Output:

[{'relation': 'founder',
  'score': 0.9981993436813354,
  'subject': {'text': 'Bill Gates',
   'label': 'person',
   'score': 0.9981993436813354,
   'start': 85,
   'end': 94},
  'object': {'text': 'Microsoft',
   'label': 'organization',
   'score': 0.9981993436813354,
   'start': 85,
   'end': 94}}]

---

GLiNER2 Multi-Task Pipeline

entities + classification + structured extraction

from fast_gliner import FastGLiNER2

model = FastGLiNER2.from_pretrained(
    "lion-ai/gliner2-multi-v1-onnx"
)

schema = (
    model.create_schema()
    # Extract entities
    .entities(["person", "company", "location"])
    
    # Classify sentiment
    .classification("sentiment", ["positive", "negative", "neutral"])
    
    # Extract structured product information
    .structure("product")
        .field("name", dtype="str")
        .field("price", dtype="str")
        .field("features", dtype="list")
        .field("category", dtype="str", choices=["electronics", "software", "service"])
)

text = """
Apple CEO Tim Cook announced the iPhone 15 for $999 with amazing new features.
This is exciting!
"""

result = model.extract(text, schema)

print(result)

Output:

{
    "classifications": {
        "sentiment": [
            {"label": "positive", "score": 0.9232913255691528},
            {"label": "neutral", "score": 0.19288331270217896},
            {"label": "negative", "score": 0.005759984254837036},
        ]
    },
    "entities": [
        {
            "text": "Apple",
            "label": "company",
            "score": 0.9991476535797119,
            "start": 1,
            "end": 6,
        },
        {
            "text": "Tim Cook",
            "label": "person",
            "score": 0.999701738357544,
            "start": 11,
            "end": 19,
        },
    ],
    "relations": [],
    "structures": {
        "product": {
            "name": ["iPhone 15"],
            "price": ["$999"],
            "features": ["amazing new features"],
            "category": [],
        }
    },
}

entities + relation extraction

schema = (
    model.create_schema()
    .entities(["person", "company"])
    .relation("founded", ["person"], ["company"])
    .relation("works_for", ["person"], ["company"])
)

text = """
Bill Gates founded Microsoft.
Satya Nadella works for Microsoft.
"""

model.extract(text, schema)

Output:

{
  "entities": [
    {"text": "Bill Gates", "label": "person"},
    {"text": "Microsoft", "label": "company"},
    {"text": "Satya Nadella", "label": "person"},
    {"text": "Microsoft", "label": "company"}
  ],
  "relations": [
    {
      "relation": "founded",
      "subject": {"text": "Bill Gates", "label": "person"},
      "object": {"text": "Microsoft", "label": "company"}
    },
    {
      "relation": "works_for",
      "subject": {"text": "Satya Nadella", "label": "person"},
      "object": {"text": "Microsoft", "label": "company"}
    }
  ]
}

---

Supported Models

Model	Runtime	Task	Multilingual
GLiNER v2.1
onnx-community/gliner_small-v2.1	FastGLiNER	NER	❌
onnx-community/gliner_medium-v2.1	FastGLiNER	NER	❌
onnx-community/gliner_large-v2.1	FastGLiNER	NER	❌
onnx-community/gliner_multi-v2.1-onnx	FastGLiNER	NER	✅
juampahc/gliner_multi-v2.1-onnx	FastGLiNER	NER	✅
GLiNER multitask
onnx-community/gliner-multitask-large-v0.5	FastGLiNER	NER, Relation Extraction	❌
GLiNER2
lion-ai/gliner2-base-v1-onnx	FastGLiNER2	NER, Classification, Structured Extraction, Relation Extraction	❌
lion-ai/gliner2-large-v1-onnx	FastGLiNER2	NER, Classification, Structured Extraction, Relation Extraction	❌
lion-ai/gliner2-multi-v1-onnx	FastGLiNER2	NER, Classification, Structured Extraction, Relation Extraction	✅

---

Performance

fast_gliner uses the Rust engine gline-rs and ONNX Runtime to accelerate inference.

Benchmarks show ~4× faster CPU inference compared to the original PyTorch implementation.

See the benchmark results in the gline-rs README.

---

Development

Set up environment

$ cd fast_gliner/bindings/python
$ make dev

Run code formatting

$ make style

Release package to PyPI

$ make
$ make release

---

For Contributors

If you're planning to contribute to fast_gliner, the following documents provide useful context:

1. Start here: docs/GLINER_OVERVIEW.md — background on GLiNER and GLiNER2 models.

2. Understand the system design: ARCHITECTURE.md — explains how the Python API, Rust inference engine, and ONNX Runtime interact.

3. Set up your development environment: docs/DEVELOPMENT.md — instructions for building the project and running it locally.

Coding agents working in this repository should also follow the rules described in:

• AGENTS.md

---

References

[1] GLiNER: Generalist Model for Named Entity Recognition using Bidirectional Transformer.

@inproceedings{zaratiana-etal-2024-gliner,
  title   = "{GL}i{NER}: Generalist Model for Named Entity Recognition using Bidirectional Transformer",
  author  = "Zaratiana, Urchade and Tomeh, Nadi and Holat, Pierre and Charnois, Thierry",
  booktitle = "Proceedings of the 2024 Conference of the North American Chapter of the Association for Computational Linguistics (NAACL)",
  year    = "2024",
  url     = "https://aclanthology.org/2024.naacl-long.300"
}

[2] GLiNER2: Schema-Driven Multi-Task Learning for Structured Information Extraction

@inproceedings{zaratiana-etal-2025-gliner2,
    title = "{GL}i{NER}2: Schema-Driven Multi-Task Learning for Structured Information Extraction",
    author = "Zaratiana, Urchade and Pasternak, Gil and Boyd, Oliver and Hurn-Maloney, George and Lewis, Ash",
    booktitle = "EMNLP 2025 System Demonstrations",
    year = "2025"
}