Instructions to use IARG-UF/lfm-2.5-1.2b-instruct_for_sys_review with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- PEFT
How to use IARG-UF/lfm-2.5-1.2b-instruct_for_sys_review with PEFT:
from peft import PeftModel from transformers import AutoModelForCausalLM base_model = AutoModelForCausalLM.from_pretrained("unsloth/LFM2.5-1.2B-Instruct") model = PeftModel.from_pretrained(base_model, "IARG-UF/lfm-2.5-1.2b-instruct_for_sys_review") - Transformers
How to use IARG-UF/lfm-2.5-1.2b-instruct_for_sys_review with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="IARG-UF/lfm-2.5-1.2b-instruct_for_sys_review") messages = [ {"role": "user", "content": "Who are you?"}, ] pipe(messages)# Load model directly from transformers import AutoTokenizer, AutoModelForCausalLM tokenizer = AutoTokenizer.from_pretrained("IARG-UF/lfm-2.5-1.2b-instruct_for_sys_review") model = AutoModelForCausalLM.from_pretrained("IARG-UF/lfm-2.5-1.2b-instruct_for_sys_review", device_map="auto") messages = [ {"role": "user", "content": "Who are you?"}, ] inputs = tokenizer.apply_chat_template( messages, add_generation_prompt=True, tokenize=True, return_dict=True, return_tensors="pt", ).to(model.device) outputs = model.generate(**inputs, max_new_tokens=40) print(tokenizer.decode(outputs[0][inputs["input_ids"].shape[-1]:])) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use IARG-UF/lfm-2.5-1.2b-instruct_for_sys_review with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "IARG-UF/lfm-2.5-1.2b-instruct_for_sys_review" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "IARG-UF/lfm-2.5-1.2b-instruct_for_sys_review", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/IARG-UF/lfm-2.5-1.2b-instruct_for_sys_review
- SGLang
How to use IARG-UF/lfm-2.5-1.2b-instruct_for_sys_review with SGLang:
Install from pip and serve model
# Install SGLang from pip: pip install sglang # Start the SGLang server: python3 -m sglang.launch_server \ --model-path "IARG-UF/lfm-2.5-1.2b-instruct_for_sys_review" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "IARG-UF/lfm-2.5-1.2b-instruct_for_sys_review", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker images
docker run --gpus all \ --shm-size 32g \ -p 30000:30000 \ -v ~/.cache/huggingface:/root/.cache/huggingface \ --env "HF_TOKEN=<secret>" \ --ipc=host \ lmsysorg/sglang:latest \ python3 -m sglang.launch_server \ --model-path "IARG-UF/lfm-2.5-1.2b-instruct_for_sys_review" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "IARG-UF/lfm-2.5-1.2b-instruct_for_sys_review", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }' - Unsloth Studio
How to use IARG-UF/lfm-2.5-1.2b-instruct_for_sys_review with Unsloth Studio:
Install Unsloth Studio (macOS, Linux, WSL)
curl -fsSL https://unsloth.ai/install.sh | sh # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for IARG-UF/lfm-2.5-1.2b-instruct_for_sys_review to start chatting
Install Unsloth Studio (Windows)
irm https://unsloth.ai/install.ps1 | iex # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for IARG-UF/lfm-2.5-1.2b-instruct_for_sys_review to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for IARG-UF/lfm-2.5-1.2b-instruct_for_sys_review to start chatting
Load model with FastModel
pip install unsloth from unsloth import FastModel model, tokenizer = FastModel.from_pretrained( model_name="IARG-UF/lfm-2.5-1.2b-instruct_for_sys_review", max_seq_length=2048, ) - Docker Model Runner
How to use IARG-UF/lfm-2.5-1.2b-instruct_for_sys_review with Docker Model Runner:
docker model run hf.co/IARG-UF/lfm-2.5-1.2b-instruct_for_sys_review
Model Card for lfm-2.5-1.2b-instruct_for_sys_review
This model is a fine-tuned classifier for systematic review screening. It predicts whether a paper should be included (1) or excluded (0) based on the study title and abstract.
Model Details
Model Description
This model adapts the LFM2.5-1.2B-Instruct base model for binary inclusion screening in systematic reviews. It is trained with supervised fine-tuning (SFT) using LoRA adapters and an instruction-following format that outputs a single label (0/1).
- Developed by: Intelligent Agents Research Group (IARG-UF)
- Funded by [optional]: Not disclosed
- Shared by [optional]: IARG-UF
- Model type: Causal language model, instruction-tuned binary classifier (LoRA)
- Language(s) (NLP): English
- License: Same as base model (see base model card)
- Finetuned from model [optional]: unsloth/LFM2.5-1.2B-Instruct
Model Sources [optional]
- Repository: https://github.com/Intelligent-Agents-Research-Group/llm_systematic_review
- Paper [optional]: Not available
- Demo [optional]: Not available
Uses
Direct Use
- Automating Phase I screening in systematic reviews by classifying abstracts as include (1) or exclude (0).
Downstream Use [optional]
- As a screening assistant in a human-in-the-loop workflow to prioritize studies for manual review.
- As a baseline for additional fine-tuning on domain-specific screening tasks.
Out-of-Scope Use
- Medical, legal, or safety-critical decision-making without expert oversight.
- Tasks requiring nuanced multi-label classification beyond include/exclude.
- Non-English abstracts or domains not represented in the training data.
Bias, Risks, and Limitations
- The training data reflects specific inclusion criteria and may not generalize to other review topics.
- Class imbalance can bias predictions toward exclusion.
- The model may output a label even when evidence is insufficient or ambiguous.
Recommendations
- Use as a triage tool with human verification.
- Calibrate thresholds or prompts to reduce false positives.
- Re-train or adapt for new domains and criteria.
How to Get Started with the Model
Use the code below to get started with the model.
from unsloth import FastLanguageModel
model, tokenizer = FastLanguageModel.from_pretrained(
model_name="models/lfm-2.5-1.2b-instruct_for_sys_review",
max_seq_length=4096,
)
FastLanguageModel.for_inference(model)
prompt = """Assess inclusion for the review.
Title: 'ChatGPT as a Software Development Bot: A Project-Based Study'.
Abstract: The study examines ChatGPT as a support tool for undergraduate
software development projects and evaluates learning outcomes.
Output 0 or 1."""
messages = [{"role": "user", "content": prompt}]
inputs = tokenizer.apply_chat_template(
messages,
add_generation_prompt=True,
return_tensors="pt",
tokenize=True,
return_dict=True,
).to("cuda")
output = model.generate(**inputs, max_new_tokens=64, temperature=0.0)
print(tokenizer.decode(output[0], skip_special_tokens=True))
Training Details
Training Data
- Source: data/train_data_LFM.csv
- Task: Binary inclusion/exclusion screening based on title + abstract prompts.
Training Procedure
- Method: Supervised fine-tuning (SFT) with LoRA adapters using Unsloth.
- Objective: Generate a single token label (0/1) after the instruction prompt.
Training Hyperparameters
- Training regime: Mixed precision (implementation-dependent; see training script)
Evaluation
Testing Data, Factors & Metrics
Testing Data
- Source: data/test_data_LFM.csv
Metrics
- Accuracy, precision, recall, and F1 (macro and weighted), plus class-wise metrics.
Results
From results/eval_results_lfm2.5_1.2b_instruct.json (test set size = 56):
- Accuracy (weighted): 0.9449
- F1 (weighted): 0.9468
- F1 (macro): 0.9377
- Class 0 (Exclude) F1: 0.9610
- Class 1 (Include) F1: 0.9143
Environmental Impact
Carbon emissions can be estimated using the Machine Learning Impact calculator presented in Lacoste et al. (2019).
- Hardware Type: Not disclosed
- Hours used: Not disclosed
- Cloud Provider: Not disclosed
- Compute Region: Not disclosed
- Carbon Emitted: Not disclosed
Technical Specifications [optional]
Model Architecture and Objective
- Base model: LFM2.5-1.2B-Instruct
- Objective: Instruction-following generation of a binary label for screening tasks.
Compute Infrastructure
- Frameworks: Unsloth, Transformers, TRL
Citation [optional]
If you use this model, please cite the repository:
BibTeX:
@misc{llm_systematic_review_2026,
title = {LLM Systematic Review Classifier},
author = {Intelligent Agents Research Group},
year = {2026},
howpublished = {\url{https://github.com/Intelligent-Agents-Research-Group/llm_systematic_review}}
}
Model Card Authors [optional]
[More Information Needed]
Model Card Contact
[More Information Needed]
Framework versions
- PEFT 0.18.1
- Downloads last month
- 21
Model tree for IARG-UF/lfm-2.5-1.2b-instruct_for_sys_review
Base model
LiquidAI/LFM2.5-1.2B-Base