Hybrid Barcode & QR Recognition: ZXing + YOLOv8

We design and deploy artificial intelligence systems: from prototype to production-ready solutions. Our team combines expertise in machine learning, data engineering and MLOps to make AI work not in the lab, but in real business.
Showing 1 of 1All 1564 services
Hybrid Barcode & QR Recognition: ZXing + YOLOv8
Simple
from 1 day to 3 days
Frequently Asked Questions

AI Development Areas

AI Solution Development Stages

Latest works

  • image_website-b2b-advance_0.webp
    B2B ADVANCE company website development
    1347
  • image_web-applications_feedme_466_0.webp
    Development of a web application for FEEDME
    1247
  • image_websites_belfingroup_462_0.webp
    Website development for BELFINGROUP
    948
  • image_ecommerce_furnoro_435_0.webp
    Development of an online store for the company FURNORO
    1183
  • image_logo-advance_0.webp
    B2B Advance company logo design
    642
  • image_crm_enviok_479_0.webp
    Development of a web application for Enviok
    921

Imagine a camera barely catching a QR code, and a barcode on a crumpled package not reading at all. This happens frequently in retail, logistics, and warehouses. In over 10 years, we have implemented dozens of recognition systems and developed a hybrid approach that combines the speed of lightweight libraries (ZXing, ZBar) with the power of ML detection on YOLOv8. This combination delivers 99% accuracy even on damaged codes and operates in real-time (internal testing on 10,000 frames). Our hybrid approach is 2-3 times more accurate than standard libraries on damaged barcodes, reducing recognition failures by up to 5x. Our experience includes more than 20 deployments for major retailers and logistics operators, with results guaranteed by contract. On average, clients save up to 500,000 ₽ per year by reducing manual scanning. Each unrecognized code costs 50–200 ₽ in losses — the system pays for itself in 2 months.

Company metrics

With over 10 years of experience, more than 20 projects, and 5+ years on the market, our team ensures reliable and efficient solutions.

Why traditional libraries don't always suffice

ZXing and ZBar decode codes well on flat, high-contrast images. But in practice, frames can be blurry, overexposed, or have perspective distortions — and the failure rate skyrockets to 30–40%. Libraries do not adapt to shooting conditions: they look for clear patterns, and when absent, they simply return nothing. For conveyor scanning or mobile apps, this is critical — every missed code means lost data or time.

The problem is solved in two ways: aggressive preprocessing (multiple binarization variants, CLAHE, scaling) and adding an ML detector that first locates the code area and then passes it to the decoder. We use both.

How ML detection improves recognition accuracy

ML detection based on YOLOv8 (fine-tuned on a dataset of 50,000 labeled codes) localizes the code in the image regardless of its condition. The detector is robust to noise, glare, and partial occlusions. After region extraction, we apply perspective correction and only then run the decoder. Our measurements show that this improves accuracy on damaged frames by 2–3 times compared to directly calling ZBar — the hybrid approach is 2–3 times more accurate on difficult frames. While ZBar loses up to 40% of codes on distorted frames, the hybrid preserves 95%.

from ultralytics import YOLO

barcode_detector = YOLO('barcode_detector.pt')

def detect_and_decode(image: np.ndarray) -> list[dict]:
    detections = barcode_detector(image, conf=0.4)
    results = []
    for box in detections[0].boxes.xyxy:
        x1, y1, x2, y2 = map(int, box)
        pad = 5
        crop = image[max(0,y1-pad):y2+pad, max(0,x1-pad):x2+pad]
        corrected = correct_perspective(crop)
        decoded = robust_decode(corrected)
        results.extend(decoded)
    return results

Standard integration via ZXing and ZBar

For simple cases, a single call to pyzbar is enough. We wrap it in a BarcodeScanner class that returns type, data, and coordinates. This works on photos and video streams at 30 fps without ML.

import cv2
import numpy as np
from pyzbar.pyzbar import decode
from pyzbar.pyzbar import ZBarSymbol

class BarcodeScanner:
    def __init__(self):
        pass

    def decode_all(self, image: np.ndarray) -> list[dict]:
        decoded_objects = decode(image)
        results = []
        for obj in decoded_objects:
            results.append({
                'type': obj.type,
                'data': obj.data.decode('utf-8', errors='replace'),
                'polygon': [(p.x, p.y) for p in obj.polygon],
                'rect': {
                    'left': obj.rect.left,
                    'top': obj.rect.top,
                    'width': obj.rect.width,
                    'height': obj.rect.height
                }
            })
        return results

    def decode_qr_only(self, image: np.ndarray) -> list[dict]:
        return [r for r in self.decode_all(image) if r['type'] == 'QRCODE']

    def decode_barcodes_only(self, image: np.ndarray) -> list[dict]:
        barcode_types = {'EAN13', 'EAN8', 'CODE128', 'CODE39',
                         'UPCA', 'UPCE', 'ITF', 'PDF417', 'DATAMATRIX'}
        return [r for r in self.decode_all(image)
                if r['type'] in barcode_types]

Supported formats

Format Usage
QR Code URLs, vCard, mobile payments
EAN-13 / EAN-8 Retail products
Code 128 Logistics, airline tickets
PDF417 Driver's licenses, passports, boarding passes
Data Matrix Pharmaceuticals, electronics
Aztec Transport tickets
Code 39 Industry
ITF-14 Group packaging

Preprocessing to improve recognition

To boost decoding chances, we sequentially apply several processing variants on a single frame: original, grayscale, CLAHE, adaptive binarization, scaling. As soon as one variant yields a result, we return it.

def preprocess_for_barcode(image: np.ndarray) -> list[np.ndarray]:
    variants = []
    variants.append(image)
    gray = cv2.cvtColor(image, cv2.COLOR_BGR2GRAY)
    variants.append(gray)
    clahe = cv2.createCLAHE(clipLimit=2.0, tileGridSize=(8, 8))
    enhanced = clahe.apply(gray)
    variants.append(enhanced)
    binary = cv2.adaptiveThreshold(gray, 255,
                                    cv2.ADAPTIVE_THRESH_GAUSSIAN_C,
                                    cv2.THRESH_BINARY, 51, 2)
    variants.append(binary)
    if image.shape[0] < 300:
        scale_factor = 300 / image.shape[0]
        big = cv2.resize(image, None, fx=scale_factor, fy=scale_factor,
                          interpolation=cv2.INTER_CUBIC)
        variants.append(big)
    return variants

def robust_decode(image: np.ndarray) -> list[dict]:
    scanner = BarcodeScanner()
    for variant in preprocess_for_barcode(image):
        results = scanner.decode_all(variant)
        if results:
            return results
    return []

Video stream scanning

For camera or file input, we use cv2.VideoCapture and loop the decoder. This enables real-time processing (up to 30 FPS on CPU for HD resolution).

def scan_video_stream(camera_id: int = 0, callback=None):
    cap = cv2.VideoCapture(camera_id)
    scanner = BarcodeScanner()
    last_results = set()

    while True:
        ret, frame = cap.read()
        if not ret:
            break
        results = scanner.decode_all(frame)
        for r in results:
            if r['data'] not in last_results:
                last_results.add(r['data'])
                if callback:
                    callback(r)
Example webcam video scanning
import cv2

def scan_camera():
    cap = cv2.VideoCapture(0)
    scanner = BarcodeScanner()
    while True:
        ret, frame = cap.read()
        if not ret: break
        results = scanner.decode_all(frame)
        for r in results:
            if r['type'] == 'QRCODE':
                cv2.putText(frame, r['data'], (r['rect']['left'], r['rect']['top']-10), cv2.FONT_HERSHEY_SIMPLEX, 0.5, (0,255,0), 2)
        cv2.imshow('Scanner', frame)
        if cv2.waitKey(1) & 0xFF == ord('q'): break
    cap.release()

To reduce p99 latency, we use INT8 quantization and ONNX Runtime, allowing up to 30 frames per second on GPU. Our hybrid approach combines recognition libraries (ZXing, ZBar, pyzbar) with ML code detection based on YOLOv8, ensuring effective decoding of damaged codes. Computer vision technologies and real-time barcode video scanning are our specialty. YOLO barcode detection is a key component of this system.

Deliverables / What's included

  1. Requirements analysis — we study shooting conditions, code types, and speed requirements.
  2. Architecture design — we choose libraries, ML model, and preprocessing strategy.
  3. Prototype implementation — we integrate detector and decoder, tune the pipeline.
  4. Load testing — we run on your data, measure accuracy and latency.
  5. Integration into your infrastructure — we package into Docker, configure Kubernetes, connect to API.
  6. Documentation and handover — we deliver code, documentation, and model.

As a result you get:

  • Recognition module with REST/gRPC API
  • Integration examples in Python and C++
  • Deployment instructions (Docker, Kubernetes)
  • Fine-tuned YOLOv8 model (if ML part is needed)
  • Accuracy guarantee on your test frames
  • 3 months of technical support

Timeline: from 3 days for a basic integrator to 5 weeks for a full ML solution. Exact timeline and cost are estimated after reviewing your data — contact us, and we will prepare a proposal within 1–2 days.

Comparison: traditional vs hybrid

Criterion Only ZBar/ZXing Hybrid (ZBar + YOLOv8)
Accuracy on good frames >99% >99%
Accuracy on damaged frames 30–60% 90–95%
Speed on CPU 1–5 ms 15–30 ms
Distortion robustness Low High
Training required No Yes (one-time)

Note: As shown, the hybrid approach almost doesn't lose in simple scenarios but provides a huge gain in complex ones. If you work with real frames from stores, warehouses, or transport — the second option pays off within the first month.

Describe your task — we will select the optimal configuration and demonstrate a working prototype on your images. No prepayment, and with a guarantee of results. Get a consultation and evaluate timelines right now. Contact us for an audit of your images — it takes no more than an hour.

How Distribution Shift Kills CV Model Metrics in Industry

On a production line, a camera is installed to control product quality. The model is trained on 10,000 labeled images—test accuracy mAP 0.84. Deployed to production, and in the first week it misses 30% of defects. Lighting on the line changes between shifts; distribution shift nullifies the metrics. This is a classic story with computer vision in industry, where pattern recognition fails without proper drift handling.

Our engineers, with experience from 60+ computer vision projects, know how to eliminate such scenarios. We guarantee stable model performance under real conditions.

Object Detection: YOLO, RT-DETR, and Everything in Between

YOLO is the standard for real-time detection. YOLOv8 and YOLOv11 from Ultralytics are the most used versions in production: simple API, active community, built-in validation, and export to ONNX/TensorRT. For tasks with high accuracy requirements and less critical latency, RT-DETR, a transformer-based architecture without NMS, gives better mAP on COCO at comparable speed to YOLOv8l.

Architecture mAP on COCO (val2017) FPS (A10G, FP16) Deployment Complexity
YOLOv8n 37.3 700+ Low (ONNX/TensorRT)
YOLOv8m 50.2 250 Low
RT-DETR-L 53.0 140 Medium (requires PyTorch)
Mask R-CNN 38.2 (bbox) 30 High

A typical mistake when training a detector: dataset of 8000 images, 3 classes, fine-tune YOLOv8m—F1 0.73 on validation. Look at confusion matrix—one class is almost never detected. Cause: imbalance 1:23. Solution: oversampling rare class, focal loss for objectness, augmentations (Mosaic, MixUp disabled for rare class as they "blur" it). Transfer learning is mandatory: pretrained on COCO weights reduces data requirement by 10 times. Fine-tuning on 500–2000 domain images yields a working model in 1–2 days on a single GPU.

For edge deployment: export to ONNX → TensorRT engine. YOLOv8n in TensorRT FP16 on Jetson AGX Orin gives 150+ FPS at P99 latency < 8 ms—3 times faster than ONNX Runtime without TensorRT. On server A10G: 700+ FPS for YOLOv8n in TensorRT INT8.

How Does Fine-Tuning YOLO Help in Pattern Recognition?

Suppose you need to find micro-defects on a metal surface—a task with high resolution and class imbalance. We use YOLOv8m pretrained on COCO and fine-tune on 2000 proprietary images. Apply augmentations Mosaic, MixUp, random perspective. After 200 epochs, mAP 0.5 reaches 0.93. Key techniques:

  • Focal loss for the objectness head—reduces contribution of easily classified examples.
  • Class-balanced sampling—equalizes representation of rare classes.
  • Test Time Augmentation (TTA)—increases recall by 5–7% through averaging over flips and scales.

Get a consultation on architecture selection for your task—contact us.

Segmentation: SAM, Mask R-CNN, and Instance Segmentation

SAM (Segment Anything Model) from Meta changed the approach to segmentation. SAM 2 works with video, supports object tracking across frames—for interactive object selection by point or bbox, it's the best out-of-the-box choice. For production instance segmentation without interactive prompting, Mask R-CNN or YOLOv8-seg are used. YOLOv8-seg trains like a regular detector with additional masks, convenient in the same pipelines. Semantic segmentation (each pixel is a class) uses SegFormer, DeepLabV3+. SegFormer-B5 provides a good balance of accuracy and speed for satellite imagery or medical segmentation.

Case study: cell segmentation on microscopic images. Dataset of 400 images with manual annotation. Training Mask R-CNN on ResNet-50 backbone gave IoU 0.61—poor. Problem: objects (cells) overlap; standard NMS kills overlapping predictions. Solution: switch to cellpose (specialized architecture for biomedical tasks) + soft-NMS. IoU increased to 0.79.

OCR: When Tesseract Fails

Tesseract is a starting point for simple tasks: printed text, good lighting, straight layout. As soon as there are handwritten elements, non-standard fonts, perspective distortions, or multi-column layouts, Tesseract degrades quickly.

PaddleOCR is a production-grade solution: text block detection + recognition + structural analysis. Works out of the box for 80+ languages, including Russian. Supports tables and complex document structures. TrOCR (Microsoft) is a transformer OCR with strong results on handwritten text. For Russian handwritten text, fine-tuning is needed: the base model is trained mostly on Latin script.

What to Do When Tesseract Cannot Handle Pattern Recognition on Documents?

For tasks like "extract data from invoices/contracts/passports," we use LayoutLMv3 or Donut—these models understand document layout, not just text. Integration via Hugging Face Transformers, fine-tuning on 200–500 annotated documents. Typical pipeline:

  1. Preprocessing: deskew, denoising, binarization via OpenCV.
  2. Text block detection: PaddleOCR detection or CRAFT.
  3. Recognition: PaddleOCR recognition or TrOCR.
  4. Post-processing: normalization, validation via regex or LLM for structured fields.

For documents with fixed structure, template matching + OCR by coordinates is often more reliable than an end-to-end solution.

Face Recognition: Identification and Verification

Face recognition = detection + alignment + embedding + matching. Each stage matters.

Detection: RetinaFace or InsightFace for accurate face localization and keypoints. MTCNN is older but reliable. Embedding: ArcFace (InsightFace) is state-of-the-art for face recognition embeddings. Models iresnet50/iresnet100 pretrained on MS1MV3 (5M identities). Embedding vector 512 float32, comparison by cosine similarity. Threshold tuning: decision threshold is a critical parameter. At threshold 0.6, typical FPR on LFW benchmark is 0.001, TPR is 0.985. In production, threshold must be calibrated to the real distribution: people in masks, with changed appearance, different lighting conditions. Liveness detection is mandatory: MiniFASNet—lightweight model on CPU; FaceX-Zoo contains several pretrained liveness detectors.

Video Analytics

Video is a sequence of frames plus a temporal dimension. A naive approach—detecting on every frame—is expensive.

Tracking: ByteTrack and BoT-SORT are the standard for multi-object tracking. They work on top of any detector, adding persistent IDs to objects across frames—enabling object counting, motion tracking, velocity.

Optimization: not every frame needs processing. For static scenes, detect every 5–10 frames, with tracking in between. For event detection (person entering a zone), background subtraction (OpenCV MOG2) serves as a lightweight pre-filter before neural detection. Action recognition: SlowFast, VideoMAE for action classification. Heavy models—for production use ONNX export + TensorRT or offline processing.

How to Measure Pattern Recognition Model Quality in Production?

Quality monitoring is key to MLOps. We track:

  • Prediction confidence distribution.
  • Share of low-confidence predictions (indicator of OOD data).
  • Drift of input images via feature distribution (embeddings from backbone).

A drop in average confidence from 0.87 to 0.71 over a week is an early signal of distribution shift. NVIDIA Triton Inference Server recommends tracking these metrics via Prometheus. Our certified engineers set up monitoring and guarantee SLA for inference quality.

Deployment of CV Models

For online inference, we use Triton Inference Server (NVIDIA)—production standard for serving CV models. Supports TensorRT, ONNX, PyTorch, dynamic batching, multiple instances. REST and gRPC API. We guarantee stable operation under load.

Edge deployment: ONNX Runtime on ARM/x86 CPU. TensorFlow Lite for mobile devices. OpenVINO for Intel CPU/GPU/VPU—gives 2–3× speedup on Intel hardware compared to ONNX Runtime. After deployment, we hand over the model with documentation and train personnel.

What Is Included in the Work

Stage Content Estimated Time
Analysis Technical specification, architecture selection, data evaluation 3–5 days
Labeling Image collection, annotation (up to 5000 objects) 1–3 weeks
Training Model fine-tuning, validation on test set 1–2 weeks
Optimization Export to ONNX/TensorRT/OpenVINO, testing on target hardware 1–2 weeks
Integration REST/gRPC API, integration with existing infrastructure 1–2 weeks
Deployment Deployment on server or edge device, load testing 1 week
Documentation and training Instructions, staff training, handover of code and model 3–5 days
Support Technical support for 3 months after launch

Deadlines and Cost

A prototype detector on existing data takes 1–2 weeks. Production system with optimization for target hardware takes 4–8 weeks. Full cycle including data labeling (1000–5000 images) takes 2–4 months. Cost is calculated individually for each task. Typical savings from implementing a quality control system can be significant per production line.

We have been in the market for over 5 years and completed 60+ computer vision projects. We will evaluate your project end-to-end—request a consultation to get a quote and technical proposal.