Skip to main content

QA Trainer 📚🤖

QA Trainer is a Python package for fine-tuning Question Answering models using feedback data.
It uses SimpleTransformers for model training and Optuna for hyperparameter tuning.



📂 Example Dataset Format

The dataset must be a JSON array of feedback entries. Each entry should have:

  • "question" → The question text
  • "answer" → The answer text (used as both context and answer in training)
  • "feedback" → A positive number to include it in training, negative/zero to exclude

Example feedback_data.json for question answer model but format will remain same for other model also you can take help of simple transformers python libary

[
    {
        "question": "What is AI?",
        "answer": "AI stands for Artificial Intelligence.",
        "feedback": 1
    },
    {
        "question": "Who is the president of Mars?",
        "answer": "Elon Musk.",
        "feedback": -1
    },
    {
        "question": "What is Python?",
        "answer": "Python is a programming language.",
        "feedback": 1
    }
]

🚀 Quick Start

from feedback_rl_transformers import train_with_feedback

train_with_feedback(
    feedback_data_path="feedback_data.json",  # Path to your feedback dataset
    model_type="bert",                        # Model type (see table below)
    model_path="bert-base-uncased",           # Pretrained model name or path
    output_dir="fine_tuned_model",            # Where to save the final model
    n_trials=5,                               # Optuna hyperparameter tuning trials
    use_cuda=False                            # Set True to use GPU if available
)

🧠 Supported Models

Model Name Code
ALBERT albert
BERT bert
BERTweet bertweet
BigBird* bigbird
CamemBERT camembert
DeBERTa* deberta
DistilBERT distilbert
ELECTRA electra
FlauBERT flaubert
HerBERT herbert
LayoutLM layoutlm
LayoutLMv2 layoutlmv2
Longformer* longformer
MPNet* mpnet
MobileBERT mobilebert
RemBERT rembert
RoBERTa roberta
SqueezeBert* squeezebert
XLM xlm
XLM-RoBERTa xlmroberta
XLNet xlnet

*Some large models may require more memory or a GPU.


⚙️ Parameters

Parameter Type Description
feedback_data_path str Path to feedback JSON dataset
model_type str Model type code (see table)
model_path str Pretrained model name or path
output_dir str Directory where fine-tuned model will be saved
n_trials int Number of Optuna trials for hyperparameter tuning
use_cuda bool Use GPU if available

📤 Output

After training:

  • The fine-tuned model will be saved in output_dir
  • Best hyperparameters from Optuna will be printed

Metadata

Release files for feedback-rl-transformers 0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for feedback-rl-transformers 0.1
File Size Uploaded
feedback_rl_transformers-0.1.tar.gz 4.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for feedback-rl-transformers 0.1
File Interpreter ABI Platform
feedback_rl_transformers-0.1-py3-none-any.whl Python 3 none any Details

Total release size: 9.1 kB

Release files / feedback_rl_transformers-0.1.tar.gz

Download URL feedback_rl_transformers-0.1.tar.gz
Size 4.3 kB
Tags Source
SHA-256 checksum
How to use checksums
9551eec6dac9d2fdd53082dd6ff9376426ec0295088916c4d6c37de85e7c5f6a
BLAKE2b-256 checksum
How to use checksums
70dea9e454c985e26aa4f950886f8970015c49d3732524a2465106dc19bc2c6b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.6

Release files / feedback_rl_transformers-0.1-py3-none-any.whl

Download URL feedback_rl_transformers-0.1-py3-none-any.whl
Size 4.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
25e0ea37ce37ca513a505d8a01d903dd5ee22fd5b1ec0c28eaccc4e44e29a787
BLAKE2b-256 checksum
How to use checksums
50661936fd5eb37e7499731ea177dffe312543bde136cca4df2c6ea483917b39
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.6

Release history Release notifications | RSS feed

This release

0.1 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page