IdentityDocument.Processing 1.2.0

IdentityDocument.Processing

IdentityDocument.Processing is a .NET library that combines Azure Computer Vision and ML.NET to process images of identity documents (ID cards, passports, licenses, etc.).
It extracts raw text from images and maps it into structured fields such as First Name, Last Name, Document Number, Dates, and more.

Features

• OCR extraction using Azure Computer Vision.
• Field classification and parsing with ML.NET.
• Easy integration into ASP.NET Core and .NET 7+ applications.
• Provides strongly-typed results for identity documents.

Installation

dotnet add package IdentityDocument.Processing

Quick Start

1. Register services in Program.cs

using IdentityDocument.Processing.Abstractions;
using IdentityDocument.Processing.Services;
using Microsoft.Azure.CognitiveServices.Vision.ComputerVision;
using ocr_project.Services.ComputerVisionAzure;
using OpenAI.Chat;

var builder = WebApplication.CreateBuilder(args);
var configuration = builder.Configuration;

// Azure Computer Vision
builder.Services.AddSingleton(provider =>
{
    return new ComputerVisionClient(
        new ApiKeyServiceClientCredentials(configuration["AzureVision:Key"]))
    {
        Endpoint = configuration["AzureVision:Endpoint"]
    };
});

// OpenAI Chat client
builder.Services.AddSingleton<ChatClient>(sp =>
{
    var apiKey = configuration["OpenAI:ApiKey"];
    if (string.IsNullOrWhiteSpace(apiKey))
        throw new InvalidOperationException("OpenAI:ApiKey is missing.");

    var model = configuration["OpenAI:Model"] ?? "gpt-4o-mini";
    return new ChatClient(model, apiKey);
});

// Register services
builder.Services.AddScoped<IOpenIAService, OpenIAService>();
builder.Services.AddScoped<IComputerVisionAzureServices, ComputerVisionAzureServices>();
builder.Services.AddScoped<IIdentityDocumentServices, IdentityDocumentService>();

var app = builder.Build();
app.Run();

2. Example service usage

using IdentityDocument.Processing.Abstractions;
using Microsoft.AspNetCore.Http;

namespace MyApp.Services
{
    public class DocumentProcessingService : IDocumentProcessingServices
    {
        private readonly IIdentityDocumentServices _identityDocService;

        public DocumentProcessingService(IIdentityDocumentServices identityDocService)
        {
            _identityDocService = identityDocService;
        }

        public async Task<FileUploadResponse> IdentityDocumentProcessingImgs(ICollection<IFormFile> files)
        {
            if (files == null || files.Count == 0)
                throw new ArgumentException("At least one image must be provided.");

            var result = await _identityDocService.IdentityDocumentProsessingImgs(files);

            if (result == null)
                throw new InvalidOperationException("Document could not be processed.");

            return new FileUploadResponse
            {
                FirstNames = result.FirstNames,
                LastNames = result.LastNames,
                Country = result.Country,
                DocumentNumber = result.DocumentNumber,
                BirthDate = ParseDate(result.BirthDate),
                IssueDate = ParseDate(result.IssueDate),
                ExpiryDate = ParseDate(result.ExpiryDate),
                Sex = result.Sex,
                Nationality = result.Nationality
            };
        }

        private DateTime? ParseDate(string? value, string format = "yyyy-MM-dd")
        {
            if (string.IsNullOrWhiteSpace(value)) return null;
            if (DateTime.TryParseExact(value, format,
                System.Globalization.CultureInfo.InvariantCulture,
                System.Globalization.DateTimeStyles.None,
                out var date))
                return date;
            return null;
        }
    }
}

Requirements

• .NET 7.0
• Azure Computer Vision subscription (endpoint and key)
• OpenAI API key

Configuration

{
  "AzureVision": {
    "Endpoint": "https://<your-cv-endpoint>.cognitiveservices.azure.com/",
    "Key": "YOUR_AZURE_CV_KEY"
  },
  "OpenAI": {
    "ApiKey": "YOUR_OPENAI_API_KEY",
    "Model": "gpt-4o-mini"
  }
}

Contributing

Contributions are welcome:

1. Fork the repository.
2. Create a feature/bugfix branch.
3. Submit a Pull Request.

Issues

• Report issues at GitHub Issues

License

This project is licensed under the MIT License.