IdentityDocument.Processing 1.0.2

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.Extensions;

var builder = WebApplication.CreateBuilder(args);

// Register library services and ML.NET model
builder.Services.AddIdentityDocumentProcessing();

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
            {
                Nombres = result.Nombres,
                Apellidos = result.Apellidos,
                Pais = result.Pais,
                NumeroDocumento = result.NumeroDocumento,
                FechaNacimiento = ParseDate(result.FechaNacimiento),
                FechaEmision = ParseDate(result.FechaEmision),
                FechaVencimiento = ParseDate(result.FechaVencimiento),
                Sexo = result.Sexo,
                Nacionalidad = result.Nacionalidad,
                EstadoCivil = result.EstadoCivil,
                Ocupacion = result.Ocupacion
            };
        }

        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)
• Built-in dependencies:
  • Microsoft.ML
  • Microsoft.Extensions.ML
  • Microsoft.Azure.CognitiveServices.Vision.ComputerVision

?? More Info

• ML.NET Documentation
• Azure Computer Vision

?? 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.