IronOCR 과 LLM 기반 OCR 중 어떤 것을 선택해야 할까요? .NET 개발자는 어떤 것을 선택해야 할까요?

4가지 모델 구성의 오버헤드

모든 RapidOCR .NET 애플리케이션은 복잡성과 관계없이 이 초기화 블록으로 시작합니다.

// RapidOcrNet: 4 paths required — any missing file throws at runtime
var engine = new RapidOcrEngine(new RapidOcrOptions
{
    DetModelPath = "./models/det.onnx",      // ~3 MB download
    ClsModelPath = "./models/cls.onnx",      // ~1 MB download
    RecModelPath = "./models/rec_en.onnx",   // ~2–10 MB depending on language
    KeysPath     = "./models/en_keys.txt"    // ~100 KB character dictionary
});

// Text blocks returned — must be sorted and joined manually
var result = engine.Run(imagePath);
var text = string.Join("\n", result.TextBlocks
    .OrderBy(b => b.BoundingBox.Top)
    .ThenBy(b => b.BoundingBox.Left)
    .Select(b => b.Text));

// RapidOcrNet: 4 paths required — any missing file throws at runtime
var engine = new RapidOcrEngine(new RapidOcrOptions
{
    DetModelPath = "./models/det.onnx",      // ~3 MB download
    ClsModelPath = "./models/cls.onnx",      // ~1 MB download
    RecModelPath = "./models/rec_en.onnx",   // ~2–10 MB depending on language
    KeysPath     = "./models/en_keys.txt"    // ~100 KB character dictionary
});

// Text blocks returned — must be sorted and joined manually
var result = engine.Run(imagePath);
var text = string.Join("\n", result.TextBlocks
    .OrderBy(b => b.BoundingBox.Top)
    .ThenBy(b => b.BoundingBox.Left)
    .Select(b => b.Text));

Imports System.Linq

' RapidOcrNet: 4 paths required — any missing file throws at runtime
Dim engine = New RapidOcrEngine(New RapidOcrOptions With {
    .DetModelPath = "./models/det.onnx",      ' ~3 MB download
    .ClsModelPath = "./models/cls.onnx",      ' ~1 MB download
    .RecModelPath = "./models/rec_en.onnx",   ' ~2–10 MB depending on language
    .KeysPath = "./models/en_keys.txt"        ' ~100 KB character dictionary
})

' Text blocks returned — must be sorted and joined manually
Dim result = engine.Run(imagePath)
Dim text = String.Join(vbCrLf, result.TextBlocks _
    .OrderBy(Function(b) b.BoundingBox.Top) _
    .ThenBy(Function(b) b.BoundingBox.Left) _
    .Select(Function(b) b.Text))

중국어 OCR로 변경하는 것은 구성 변경이 아닙니다 — 파일 교환입니다. 영어 인식 모델(en_rec.onnx / en_keys.txt)과 중국어 인식 모델(ch_rec.onnx / ch_keys.txt)은 별도의 다운로드입니다. 문서에 중국어와 스페인어 텍스트가 모두 포함된 경우, 더 이상 진행할 방법이 없습니다. RapidOCR 모델 카탈로그에는 스페인어 모델이 아예 존재하지 않기 때문입니다.

이 .csproj는 빌드 시 네 파일 모두를 복사하기 위해 명시적인 MSBuild 항목도 필요합니다:

<ItemGroup>
  <Content Include="models\**\*.*">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </Content>
</ItemGroup>

<ItemGroup>
  <Content Include="models\**\*.*">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </Content>
</ItemGroup>

해당 단계를 놓치면 경로가 아무것도 찾지 못할 때 런타임에 프로덕션 배포가 조용히 실패합니다.

상세 기능 비교

RapidOCR .NET 접근 방식

모델 파일은 NuGet 패키지에 포함되어 있지 않습니다. 해당 파일들은 RapidOCR 프로젝트의 GitHub 릴리스 페이지에 있으며, 별도로 다운로드하고 수동으로 버전을 지정한 후 애플리케이션과 함께 배포해야 합니다. RapidOCR 프로젝트에서 정확도 향상을 위한 업데이트된 모델을 출시하면 다운로드 과정을 반복하고 배포 환경의 파일을 교체하면 됩니다.

CI/CD 파이프라인에서는 모델 파일이 리포지토리에 커밋되어야 하거나(이는 Git 기록에 15–25 MB의 바이너리 데이터를 추가함) 빌드 단계에서 사용자 정의 스크립트를 사용하여 가져와야 합니다. Docker 컨테이너에서는 각 언어의 모델 세트가 전용 COPY 명령어와 복잡한 레이어를 추가합니다. Kubernetes 배포에서 모델 파일은 일반적으로 마운트된 볼륨에 저장되거나 이미지에 포함되는데, 두 경우 모두 업데이트 전파 방식에 대한 정책이 필요합니다.

소스 파일의 유효성 검사 로직이 취약점을 구체화합니다.

// RapidOcrNet: Runtime validation needed because any missing file crashes the engine
public static bool ValidateModelFiles()
{
    var requiredFiles = new[]
    {
        Path.Combine(ModelDirectory, "det.onnx"),
        Path.Combine(ModelDirectory, "cls.onnx"),
        Path.Combine(ModelDirectory, "rec_en.onnx"),
        Path.Combine(ModelDirectory, "en_keys.txt")
    };

    var missingFiles = requiredFiles.Where(f => !File.Exists(f)).ToList();

    if (missingFiles.Any())
    {
        Console.WriteLine("ERROR: Missing required model files:");
        foreach (var file in missingFiles)
            Console.WriteLine($"  - {file}");
        return false;
    }

    return true;
}

// RapidOcrNet: Runtime validation needed because any missing file crashes the engine
public static bool ValidateModelFiles()
{
    var requiredFiles = new[]
    {
        Path.Combine(ModelDirectory, "det.onnx"),
        Path.Combine(ModelDirectory, "cls.onnx"),
        Path.Combine(ModelDirectory, "rec_en.onnx"),
        Path.Combine(ModelDirectory, "en_keys.txt")
    };

    var missingFiles = requiredFiles.Where(f => !File.Exists(f)).ToList();

    if (missingFiles.Any())
    {
        Console.WriteLine("ERROR: Missing required model files:");
        foreach (var file in missingFiles)
            Console.WriteLine($"  - {file}");
        return false;
    }

    return true;
}

Imports System
Imports System.IO
Imports System.Linq

Public Class RapidOcrNet
    Public Shared Function ValidateModelFiles() As Boolean
        Dim requiredFiles = {
            Path.Combine(ModelDirectory, "det.onnx"),
            Path.Combine(ModelDirectory, "cls.onnx"),
            Path.Combine(ModelDirectory, "rec_en.onnx"),
            Path.Combine(ModelDirectory, "en_keys.txt")
        }

        Dim missingFiles = requiredFiles.Where(Function(f) Not File.Exists(f)).ToList()

        If missingFiles.Any() Then
            Console.WriteLine("ERROR: Missing required model files:")
            For Each file In missingFiles
                Console.WriteLine($"  - {file}")
            Next
            Return False
        End If

        Return True
    End Function
End Class

RapidOCR .NET 사용하는 실제 애플리케이션은 모델 파일이 누락되어도 Install-Package 시에는 명확한 오류가 발생하지 않고 엔진이 처음 초기화될 때 런타임 충돌이 발생하기 때문에 일반적으로 이와 같은 시작 유효성 검사를 포함합니다. 그러한 문제는 개발 단계가 아니라 생산 단계에서 나타납니다.

IronOCR 접근법

관리해야 할 모델 파일이 없습니다. dotnet add package IronOcr 후, 엔진이 준비됩니다:

// IronOCR: no model downloads, no path configuration, no validation boilerplate
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";
var text = new IronTesseract().Read("document.jpg").Text;

// IronOCR: no model downloads, no path configuration, no validation boilerplate
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";
var text = new IronTesseract().Read("document.jpg").Text;

' IronOCR: no model downloads, no path configuration, no validation boilerplate
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY"
Dim text = New IronTesseract().Read("document.jpg").Text

IronTesseract 설치 가이드에는 전체 설치 경로가 나와 있습니다. 영어를 넘어서는 언어 팩은 NuGet 패키지입니다 — dotnet add package IronOcr.Languages.French — 그리고 복원 절차는 모든 것을 처리하여, 이미 NuGet 종속성을 복원하는 CI/CD 파이프라인에서도 작동합니다. 바이너리 모델 파일에 대한 .gitignore 결정이 없으며, Dockerfile에 COPY 레이어가 없으며, 시작 시 검증 스크립트도 없습니다.

Docker에 배포하는 팀의 경우, IronOCR Docker 가이드는 필요한 libgdiplus 시스템 종속성만 다룹니다(Debian/Ubuntu 기반 이미지).

RapidOCR .NET 접근 방식

RapidOCR.NET의 언어 지원 범위는 해당 웹사이트의 기원을 반영합니다. PaddleOCR은 바이두가 중국어 인터넷 검색을 위해 개발한 서비스입니다. 이 제품의 모델은 중국어 간체와 중국어 번체 모두에 매우 적합합니다. 영어 지원은 포함되어 있지만, 주요 설계 목표는 아니었습니다. 일본어와 한국어에는 커뮤니티에서 제공한 모델이 실험용으로 표시되어 있습니다. 스페인어, 프랑스어, 독일어, 러시아어, 아랍어, 힌디어, 포르투갈어 등 100개가 넘는 다른 언어에는 사용 가능한 모델이 없습니다.

지원되는 언어 간에 전환하려면 다른 모델 파일을 다운로드해야 합니다.

// RapidOcrNet: 영어 engine
var englishEngine = new RapidOcrEngine(new RapidOcrOptions
{
    DetModelPath = Path.Combine(modelPath, "det.onnx"),
    ClsModelPath = Path.Combine(modelPath, "cls.onnx"),
    RecModelPath = Path.Combine(modelPath, "en_rec.onnx"),   // English-specific
    KeysPath     = Path.Combine(modelPath, "en_keys.txt")    // English-specific
});

// RapidOcrNet: Chinese engine — different rec and keys files required
var chineseEngine = new RapidOcrEngine(new RapidOcrOptions
{
    DetModelPath = Path.Combine(modelPath, "det.onnx"),
    ClsModelPath = Path.Combine(modelPath, "cls.onnx"),
    RecModelPath = Path.Combine(modelPath, "ch_rec.onnx"),   // Different download
    KeysPath     = Path.Combine(modelPath, "ch_keys.txt")    // Different download
});

// Spanish? NotSupportedException — no model exists

// RapidOcrNet: 영어 engine
var englishEngine = new RapidOcrEngine(new RapidOcrOptions
{
    DetModelPath = Path.Combine(modelPath, "det.onnx"),
    ClsModelPath = Path.Combine(modelPath, "cls.onnx"),
    RecModelPath = Path.Combine(modelPath, "en_rec.onnx"),   // English-specific
    KeysPath     = Path.Combine(modelPath, "en_keys.txt")    // English-specific
});

// RapidOcrNet: Chinese engine — different rec and keys files required
var chineseEngine = new RapidOcrEngine(new RapidOcrOptions
{
    DetModelPath = Path.Combine(modelPath, "det.onnx"),
    ClsModelPath = Path.Combine(modelPath, "cls.onnx"),
    RecModelPath = Path.Combine(modelPath, "ch_rec.onnx"),   // Different download
    KeysPath     = Path.Combine(modelPath, "ch_keys.txt")    // Different download
});

// Spanish? NotSupportedException — no model exists

Imports System.IO

' RapidOcrNet: 영어 engine
Dim englishEngine = New RapidOcrEngine(New RapidOcrOptions With {
    .DetModelPath = Path.Combine(modelPath, "det.onnx"),
    .ClsModelPath = Path.Combine(modelPath, "cls.onnx"),
    .RecModelPath = Path.Combine(modelPath, "en_rec.onnx"),   ' English-specific
    .KeysPath = Path.Combine(modelPath, "en_keys.txt")        ' English-specific
})

' RapidOcrNet: Chinese engine — different rec and keys files required
Dim chineseEngine = New RapidOcrEngine(New RapidOcrOptions With {
    .DetModelPath = Path.Combine(modelPath, "det.onnx"),
    .ClsModelPath = Path.Combine(modelPath, "cls.onnx"),
    .RecModelPath = Path.Combine(modelPath, "ch_rec.onnx"),   ' Different download
    .KeysPath = Path.Combine(modelPath, "ch_keys.txt")        ' Different download
})

' Spanish? NotSupportedException — no model exists

동일한 대기열에서 영어, 중국어 및 스페인어 문서를 처리해야 하는 애플리케이션의 경우 RapidOCR .NET 에서 스페인어 문서에 대한 적절한 처리 경로가 없습니다.

IronOCR 접근법

IronOCR 125개 이상의 언어를 지원하며 , 각 언어는 NuGet 언어 팩으로 제공됩니다. 전환은 IronTesseract 인스턴스에서 열거형 속성을 할당하는 것입니다 — 파일 다운로드도 없고 엔진 재생성도 없습니다:

// IronOCR: language switching is a property change, not a file swap
var ocr = new IronTesseract();

// English
ocr.Language = OcrLanguage.English;

// Chinese Simplified
ocr.Language = OcrLanguage.ChineseSimplified;

// Spanish — no model download needed
ocr.Language = OcrLanguage.Spanish;

// Arabic — just works
ocr.Language = OcrLanguage.Arabic;

// Russian — just works
ocr.Language = OcrLanguage.Russian;

var result = ocr.Read("document.jpg");

// IronOCR: language switching is a property change, not a file swap
var ocr = new IronTesseract();

// English
ocr.Language = OcrLanguage.English;

// Chinese Simplified
ocr.Language = OcrLanguage.ChineseSimplified;

// Spanish — no model download needed
ocr.Language = OcrLanguage.Spanish;

// Arabic — just works
ocr.Language = OcrLanguage.Arabic;

// Russian — just works
ocr.Language = OcrLanguage.Russian;

var result = ocr.Read("document.jpg");

Imports IronOcr

Dim ocr As New IronTesseract()

' English
ocr.Language = OcrLanguage.English

' Chinese Simplified
ocr.Language = OcrLanguage.ChineseSimplified

' Spanish — no model download needed
ocr.Language = OcrLanguage.Spanish

' Arabic — just works
ocr.Language = OcrLanguage.Arabic

' Russian — just works
ocr.Language = OcrLanguage.Russian

Dim result = ocr.Read("document.jpg")

혼합 언어 문서는 AddSecondaryLanguage을 사용합니다:

var ocr = new IronTesseract();
ocr.Language = OcrLanguage.ChineseSimplified;
ocr.AddSecondaryLanguage(OcrLanguage.English);
var result = ocr.Read("mixed-document.jpg");

var ocr = new IronTesseract();
ocr.Language = OcrLanguage.ChineseSimplified;
ocr.AddSecondaryLanguage(OcrLanguage.English);
var result = ocr.Read("mixed-document.jpg");

Imports IronOcr

Dim ocr As New IronTesseract()
ocr.Language = OcrLanguage.ChineseSimplified
ocr.AddSecondaryLanguage(OcrLanguage.English)
Dim result = ocr.Read("mixed-document.jpg")

다국어 사용 방법 및 국제 언어 예제에서는 언어 팩 설치 및 보조 언어 구성에 대해 자세히 다룹니다.

RapidOCR .NET 접근 방식

RapidOCR .NET 이미지를 처리합니다. PDF 파일은 이미지가 아닙니다. 이 라이브러리는 PDF 렌더링 기능, PDF 작성 기능, 검색 가능한 PDF 출력물을 생성하는 메커니즘을 갖추고 있지 않습니다. RapidOCR .NET 을 사용하여 스캔한 PDF에서 텍스트를 추출하려면 최소한 세 가지 구성 요소가 필요합니다.

// RapidOcrNet: PDF processing requires external library + manual assembly
public async Task<string> ExtractTextFromPdf(string pdfPath)
{
    // Step 1: Requires PdfPig, Docotic, or similar external library
    var pageImages = await RenderPdfToImages(pdfPath);

    // Step 2: Initialize RapidOcr with 4 model files (must already be downloaded)
    using var engine = new RapidOcrEngine(new RapidOcrOptions
    {
        DetModelPath = "models/det.onnx",
        ClsModelPath = "models/cls.onnx",
        RecModelPath = "models/rec_en.onnx",
        KeysPath     = "models/en_keys.txt"
    });

    // Step 3: OCR each image individually
    var results = new List<string>();
    foreach (var pageImage in pageImages)
    {
        var result = engine.Run(pageImage);
        results.Add(string.Join("\n", result.TextBlocks.Select(b => b.Text)));
    }

    // Step 4: Combine manually — page structure not preserved
    return string.Join("\n\n", results);
}

// RapidOcrNet: PDF processing requires external library + manual assembly
public async Task<string> ExtractTextFromPdf(string pdfPath)
{
    // Step 1: Requires PdfPig, Docotic, or similar external library
    var pageImages = await RenderPdfToImages(pdfPath);

    // Step 2: Initialize RapidOcr with 4 model files (must already be downloaded)
    using var engine = new RapidOcrEngine(new RapidOcrOptions
    {
        DetModelPath = "models/det.onnx",
        ClsModelPath = "models/cls.onnx",
        RecModelPath = "models/rec_en.onnx",
        KeysPath     = "models/en_keys.txt"
    });

    // Step 3: OCR each image individually
    var results = new List<string>();
    foreach (var pageImage in pageImages)
    {
        var result = engine.Run(pageImage);
        results.Add(string.Join("\n", result.TextBlocks.Select(b => b.Text)));
    }

    // Step 4: Combine manually — page structure not preserved
    return string.Join("\n\n", results);
}

Imports System.Threading.Tasks
Imports System.Collections.Generic
Imports System.Linq

Public Class PdfTextExtractor
    ' RapidOcrNet: PDF processing requires external library + manual assembly
    Public Async Function ExtractTextFromPdf(pdfPath As String) As Task(Of String)
        ' Step 1: Requires PdfPig, Docotic, or similar external library
        Dim pageImages = Await RenderPdfToImages(pdfPath)

        ' Step 2: Initialize RapidOcr with 4 model files (must already be downloaded)
        Using engine As New RapidOcrEngine(New RapidOcrOptions With {
            .DetModelPath = "models/det.onnx",
            .ClsModelPath = "models/cls.onnx",
            .RecModelPath = "models/rec_en.onnx",
            .KeysPath = "models/en_keys.txt"
        })

            ' Step 3: OCR each image individually
            Dim results As New List(Of String)()
            For Each pageImage In pageImages
                Dim result = engine.Run(pageImage)
                results.Add(String.Join(vbLf, result.TextBlocks.Select(Function(b) b.Text)))
            Next

            ' Step 4: Combine manually — page structure not preserved
            Return String.Join(vbLf & vbLf, results)
        End Using
    End Function

    ' Placeholder for the RenderPdfToImages method
    Private Async Function RenderPdfToImages(pdfPath As String) As Task(Of List(Of Object))
        ' Implementation goes here
        Return New List(Of Object)()
    End Function
End Class

이로 인해 NuGet 종속성이 하나 더 추가되고, 학습해야 할 API 영역이 늘어나며, 대용량 문서의 경우 페이지 렌더링된 비트맵을 메모리에 유지해야 하므로 메모리 부담이 가중됩니다. 검색 가능한 PDF 출력(인식된 텍스트를 원본 스캔 위에 숨겨진 OCR 레이어로 덮어쓰는 방식)은 이 파이프라인의 어떤 단계에서도 구현할 수 없습니다.

IronOCR 접근법

IronOCR PDF 파일을 기본적으로 읽습니다. 같은 IronTesseract.Read() 메서드는 이미지 경로와 PDF 경로를 모두 허용합니다:

// IronOCR: direct PDF OCR — no conversion, no external library
var text = new IronTesseract().Read("scanned-document.pdf").Text;

// 비밀번호로 보호된 PDF — one parameter
using var input = new OcrInput();
input.LoadPdf("encrypted.pdf", Password: "secret");
var result = new IronTesseract().Read(input);

// 검색 가능한 PDF — one method call on the result
var result = new IronTesseract().Read("scanned.pdf");
result.SaveAsSearchablePdf("searchable-output.pdf");

// IronOCR: direct PDF OCR — no conversion, no external library
var text = new IronTesseract().Read("scanned-document.pdf").Text;

// 비밀번호로 보호된 PDF — one parameter
using var input = new OcrInput();
input.LoadPdf("encrypted.pdf", Password: "secret");
var result = new IronTesseract().Read(input);

// 검색 가능한 PDF — one method call on the result
var result = new IronTesseract().Read("scanned.pdf");
result.SaveAsSearchablePdf("searchable-output.pdf");

Imports IronOcr

' IronOCR: direct PDF OCR — no conversion, no external library
Dim text As String = New IronTesseract().Read("scanned-document.pdf").Text

' 비밀번호로 보호된 PDF — one parameter
Using input As New OcrInput()
    input.LoadPdf("encrypted.pdf", Password:="secret")
    Dim result = New IronTesseract().Read(input)
End Using

' 검색 가능한 PDF — one method call on the result
Dim result2 = New IronTesseract().Read("scanned.pdf")
result2.SaveAsSearchablePdf("searchable-output.pdf")

PDF 입력 방법 안내에는 페이지 선택, 비밀번호 처리 및 여러 페이지 처리가 포함됩니다. 검색 가능한 PDF 생성 방법 안내서는 원본 스캔 이미지와 시각적으로 동일하면서도 전체 텍스트 검색 기능을 추가하여 규정 준수 수준의 결과물을 만드는 방법을 보여줍니다. 문서 아카이빙 파이프라인을 구축하는 팀에게 있어 해당 출력 형식은 최종 목표이며,IronOCR패키지 자체 외에는 추가적인 종속성이 전혀 필요하지 않습니다.

RapidOCR .NET 접근 방식

RapidOCR .NET 은 비교적 최근에 개발된 프로젝트입니다. 해당 GitHub 저장소는 기존 .NET OCR 라이브러리에 비해 별점 수와 기여 활동이 저조합니다. Stack Overflow는 관련 내용이 거의 없습니다. 프로덕션 환경에서 특이한 이미지 방향, 특정 문자 집합, ONNX 런타임 버전 충돌, GPU 모드 구성과 같은 예외적인 상황이 발생할 경우, 주요 해결 방법은 GitHub 이슈 트래커를 활용하는 것입니다. 상업적 지원 등급, 유지보수 SLA, 보장된 응답 시간 등이 없습니다.

의존성 사슬은 추가적인 위험을 초래합니다. RapidOCR .NET 은 RapidOCR 프로젝트의 모델 릴리스에 의존합니다. RapidOCR 프로젝트는 PaddleOCR의 모델 아키텍처에 의존합니다. 해당 체인의 어느 계층에서든 호환성을 깨뜨리는 변경 사항이 발생하면 사용자가 업데이트하기 전에 .NET 래퍼 유지 관리자가 응답해야 합니다. 그런데 이 래퍼는 조직의 지원 없이 단 한 명의 커뮤니티 개발자가 유지 관리하고 있습니다.

배포 과정에서 ONNX 런타임 버전 관리 문제도 드러납니다. Microsoft.ML.OnnxRuntime 패키지는 부 버전 사이에 변경 사항이 있었으며, 함께 제공되는 네이티브 바이너리는 플랫폼 별입니다. linux/amd64에 기반하여 빌드된 컨테이너 이미지는 linux/arm64에 기반하여 빌드된 컨테이너 이미지와 동일한 ONNX Runtime 바이너리를 사용할 수 없습니다. 각 배포 대상은 유효성 검사를 거쳐야 합니다.

IronOCR 접근법

IronOCR 10년 이상 활발한 상업적 개발이 진행되어 왔습니다. 이 라이브러리는 버전 관리되는 API와 문서화된 호환성 파괴 변경 사항, .NET SDK 릴리스에 맞춘 정기 릴리스, 그리고 모든 상업용 라이선스에 포함된 이메일 지원을 제공합니다. 실제 운영 파이프라인을 구축하는 팀은 개발자 한 명이 여가 시간에 모니터링하는 GitHub 이슈 대기열 대신 직접적인 지원 경로를 확보하게 됩니다.

단일 패키지 설계로 배포 검증 단계를 완전히 없앨 수 있습니다. NuGet 복원 단계는 결정론적입니다. 동일한 패키지 버전은 플랫폼별 네이티브 바이너리 관리 없이 Windows, Linux 및 macOS에서 동일하게 작동하는 설치를 생성합니다. AWS Lambda 및 Azure 배포의 경우 함수 번들에는 게시된 애플리케이션만 포함되며 모델 파일 사이드카, 볼륨 마운트, 시작 유효성 검사 로직은 포함되지 않습니다.

저품질 스캔 예제 와 이미지 품질 보정 방법은 ONNX 기반 파이프라인에서 일반적으로 사용자 지정 코드가 필요한 전처리 시나리오(기울어진 스캔, 노이즈가 많은 배경, 저대비 문서)를 적절한 필터 방법을 선택하는 것 외에는 코드를 작성하지 않고 처리하는 방법을 다룹니다.

모델 파일 관리가 배포 병목 현상이 될 때

RapidOCR .NET 사용하여 프로토타입 개발을 시작한 팀은 일반적으로 상용화 단계에서 모델 파일 관리 문제에 직면합니다. 네 개의 모델 파일은 버전 관리, 추적, 빌드 시 복사, CI 아티팩트 포함, 스테이징 환경 배포, 그리고 프로덕션 환경 배포까지 모두 NuGet 종속성 그래프와 별도로 처리해야 합니다. 소규모 팀에서는 그러한 운영상의 추가 비용은 한 번 발생하고 나면 잊어버리게 됩니다. 여러 서비스, 여러 환경, 여러 CI 파이프라인을 유지하는 팀에서 모델 파일 배포에 대한 맞춤형 스크립팅이 실질적인 유지보수 비용으로 축적됩니다. 팀원이 "왜 리포에 이 models/ 폴더가 있고 내가 삭제하면 무슨 일이 발생하나요?"라고 물었을 때, 답변에 5분이 소요된다면, 평가가 시작되는 시점일 것입니다.IronOCR모델 관리와 관련된 모든 단계를 제거합니다. 별도로 다운로드할 것도 없고, CI에 복사할 것도 없고, 시작 시 유효성 검사를 할 필요도 없습니다.

지원되지 않는 언어로 작성된 문서가 도착했을 때

언어 지원 범위 부족은 설정 문제가 아니라 해결해야 할 중대한 문제입니다. 만약 어떤 조직이 독일어 계약서, 프랑스어 송장, 러시아어 구매 주문서 또는 아랍어 서신을 받는다면, RapidOCR .NET 은 해당 문서에 대한 경로를 제공하지 않습니다. 즉, "제한된 정확도"가 아니라 모델 자체가 없어서 결과가 나오지 않는다는 뜻입니다. 처음에 CJK(중국어, 문법, 언어) 중심의 사용 사례를 위해 RapidOCR .NET 선택한 팀은 해당 집합 외의 문서를 처리해야 할 때 비로소 이러한 한계를 발견하게 됩니다. IronOCR의 언어 기능은 NuGet 통해 설치 가능한 125개 이상의 언어를 지원하므로 애플리케이션 코드를 수정하지 않고도 OCR 파이프라인에서 처리할 수 있는 범위를 확장할 수 있습니다. 언어 팩을 추가하고 열거형 속성을 변경하기만 하면 됩니다.

애플리케이션에서 PDF 입력 또는 출력이 필요한 경우

OCR이 다루는 중요한 비즈니스 문서 범주 중 하나는 PDF 파일입니다. 스캔한 계약서, 보관된 송장, 복합기에서 PDF로 변환된 팩스 양식 등이 여기에 해당합니다. RapidOCR .NET 은 별도의 PDF 렌더링 라이브러리, 사용자 지정 변환 코드 및 페이지 크기 비트맵에 대한 메모리 관리 없이는 이러한 파일들을 읽을 수 없습니다. 문서 수집 파이프라인을 구축하는 팀은 RapidOCR .NET 스택에 PDF 렌더링용 라이브러리 하나와 OCR용 라이브러리 하나, 총 최소 두 개의 라이브러리가 필요하며, 각 라이브러리마다 업그레이드 주기와 호환성 문제가 있다는 것을 금방 알게 됩니다.IronOCR이 두 가지를 하나의 패키지로 처리합니다. 스캔한 아카이브를 검색 가능한 색인으로 변환하여 검색 가능한 PDF를 생성하는 기능은 RapidOCR .NET 의 범위를 완전히 벗어나며IronOCR에서는 단일 메서드 호출로 가능합니다. 규정 준수 요건을 충족하는 문서 관리 애플리케이션을 개발하는 팀은 검색 가능한 PDF 출력 기능을 결정적인 요소로 꼽는 경우가 많습니다.

지원 경로 없이 운영상의 문제가 발생했을 때

커뮤니티 프로젝트는 참여자의 참여 가능 여부에 따라 운영됩니다. RapidOCR .NET 프로덕션 배포에서 특정 ONNX 런타임 버전 충돌, 특이한 이미지 형식에서의 모델 추론 실패, 지속적인 부하 시 메모리 누수와 같은 새로운 예외 상황이 발생하면 지원 경로는 GitHub 이슈를 등록하고 기다리는 것입니다. SLA 의무가 있거나 비즈니스 핵심 문서 처리 파이프라인을 운영하는 팀의 경우, 이는 실행 가능한 사고 대응 모델이 아닙니다. IronOCR의 상업용 라이선스에는 직접 이메일 지원이 포함되어 있어, 팀은 월요일 마감일을 앞둔 금요일 밤에 문제가 발생했을 때 실제 연락할 수 있는 창구를 확보할 수 있습니다.

프로젝트가 프로토타입의 가정을 뛰어넘을 때

RapidOCR .NET 은 실험적인 개념 증명에는 적합한 선택입니다. 무료이고, 라이선스 협상이 필요 없으며, 모델 설정 외에는 설치가 빠릅니다. 하지만 이러한 개념 증명이 실제 운영 환경에서 사용될 때는 연구실에서는 용인되었던 제약 조건들, 즉 PDF 미지원, 제한적인 언어 지원, 수동 모델 관리, 상업적 지원 부족 등이 걸림돌이 됩니다. RapidOCR .NET 에서IronOCR로의 마이그레이션 경로는 간단합니다. 패키지를 제거하고, 모델 디렉터리를 삭제하고, MSBuild 복사 규칙을 제거하고, 엔진 초기화 블록을 인수가 없는 단일 OCR 엔진 생성자로 교체하면 PDF 입력, 125개 언어 지원, 자동 전처리 및 검색 가능한 출력 기능을 동시에 사용할 수 있습니다.

엔진 초기화 교체

가장 직접적인 코드 변경은 RapidOcrEngine 초기화 블록을 IronTesseract 인스턴스화로 대체하는 것입니다. 4개 경로 구성 객체가 완전히 사라집니다.

// Before: RapidOcrNet — engine needs all 4 paths populated
var engine = new RapidOcrEngine(new RapidOcrOptions
{
    DetModelPath = "models/det.onnx",
    ClsModelPath = "models/cls.onnx",
    RecModelPath = "models/rec_en.onnx",
    KeysPath     = "models/en_keys.txt"
});
var result = engine.Run(imagePath);
var text = string.Join("\n", result.TextBlocks
    .OrderBy(b => b.BoundingBox.Top)
    .Select(b => b.Text));

// After:IronOCR— no configuration required
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";
var text = new IronTesseract().Read(imagePath).Text;

// Before: RapidOcrNet — engine needs all 4 paths populated
var engine = new RapidOcrEngine(new RapidOcrOptions
{
    DetModelPath = "models/det.onnx",
    ClsModelPath = "models/cls.onnx",
    RecModelPath = "models/rec_en.onnx",
    KeysPath     = "models/en_keys.txt"
});
var result = engine.Run(imagePath);
var text = string.Join("\n", result.TextBlocks
    .OrderBy(b => b.BoundingBox.Top)
    .Select(b => b.Text));

// After:IronOCR— no configuration required
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";
var text = new IronTesseract().Read(imagePath).Text;

Imports System.Linq

' Before: RapidOcrNet — engine needs all 4 paths populated
Dim engine = New RapidOcrEngine(New RapidOcrOptions With {
    .DetModelPath = "models/det.onnx",
    .ClsModelPath = "models/cls.onnx",
    .RecModelPath = "models/rec_en.onnx",
    .KeysPath = "models/en_keys.txt"
})
Dim result = engine.Run(imagePath)
Dim text = String.Join(vbCrLf, result.TextBlocks _
    .OrderBy(Function(b) b.BoundingBox.Top) _
    .Select(Function(b) b.Text))

' After: IronOCR— no configuration required
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY"
Dim text = New IronTesseract().Read(imagePath).Text

수동 OrderBy와 Select 체인을 가진 result.TextBlocks 컬렉션은 result.Text로 축소됩니다. TextBlocks 제공하는 경계 상자 데이터를 필요로 하는 애플리케이션은 표준화된 API를 통해 같은 단어별 좌표와 신뢰 값들을 result.Words이 노출하여 읽기 결과 사용 설명서에 문서화되어 있습니다.

모델 파일 인프라 제거

코드를 변경한 후, models/ 디렉토리를 삭제하고, 빌드 시 모델 파일을 복사한 MSBuild <Content> 항목을 제거하며, 파일 누락을 확인하는 스타트업 검증 로직을 제거합니다. 이것들은 필요하지 않습니다.IronOCR데이터를 자체적으로 전송합니다. CI/CD 파이프라인에서 모델 파일을 가져오거나 캐시하는 단계를 모두 제거하세요. 이미지 입력 ​​방법 안내서는 기존 RapidOCR .NET 코드에서 흔히 사용되는 파일 경로, 스트림 및 바이트 배열 시나리오에 대한 입력 처리 패턴을 다룹니다.

저화질 이미지 처리

RapidOCR.NET의 ONNX 모델은 추론 중에 내부 전처리를 적용하지만, 라이브러리는 호출자에게 전처리 API를 제공하지 않습니다. 기존 코드가 engine.Run()에 전달하기 전에 이미지 조작을 적용한 경우, 그 코드는 별도의 이미지 라이브러리를 사용하여 작성되었습니다. IronOCR는 OcrInput에 직접 전처리 API를 노출합니다:

using var input = new OcrInput();
input.LoadImage("low-quality-scan.jpg");
input.Deskew();           // Correct skewed scans
input.DeNoise();          // Remove scanner noise
input.Contrast();         // Enhance contrast
input.Binarize();         // Convert to black/white
input.EnhanceResolution(300);

var result = new IronTesseract().Read(input);
Console.WriteLine($"Confidence: {result.Confidence}%");

using var input = new OcrInput();
input.LoadImage("low-quality-scan.jpg");
input.Deskew();           // Correct skewed scans
input.DeNoise();          // Remove scanner noise
input.Contrast();         // Enhance contrast
input.Binarize();         // Convert to black/white
input.EnhanceResolution(300);

var result = new IronTesseract().Read(input);
Console.WriteLine($"Confidence: {result.Confidence}%");

Imports IronOcr

Using input As New OcrInput()
    input.LoadImage("low-quality-scan.jpg")
    input.Deskew()           ' Correct skewed scans
    input.DeNoise()          ' Remove scanner noise
    input.Contrast()         ' Enhance contrast
    input.Binarize()         ' Convert to black/white
    input.EnhanceResolution(300)

    Dim result = New IronTesseract().Read(input)
    Console.WriteLine($"Confidence: {result.Confidence}%")
End Using

이미지 방향 보정 방법 과 DPI 설정 방법은 스캔 문서의 정확도에 가장 흔히 영향을 미치는 두 가지 전처리 문제를 다룹니다 . 신뢰 점수는 result.Confidence과 단어별로 result.Words[i].Confidence을 통해 제공됩니다.

PDF 지원 추가

기존에 engine.Run()을 호출하기 전에 PDF를 이미지로 변환하던 코드는 완전히 삭제할 수 있습니다. IronTesseract.Read()은 PDF 경로를 직접 받아들입니다. PDF 렌더링 라이브러리 종속성과 변환 파이프라인 코드를 함께 제거하세요. 이렇게 하면 종속성이 추가되는 것이 아니라 오히려 줄어듭니다.