Utilisation d'IronOCR avec des assistants de codage intelligents
IronOCR est une bibliothèque OCR commerciale pour .NET avec plus de six millions de téléchargements NuGet. Ses tutoriels, guides pratiques et notes de dépannage sont disponibles depuis des années, donc les assistants de codage les ont souvent vus dans leurs données d'entraînement.
Cette familiarité ne s'étend pas à la version que votre projet utilise. Un assistant qui lit la documentation d'IronOCR est plus susceptible d'écrire du code OCR qui construit et retourne un texte précis. Partagez la documentation avant la première demande.
Ces outils se divisent en deux catégories, qui diffèrent par la quantité de travail qu'ils effectuent avant que vous n'analysiez le résultat.
- Un assistant fonctionne dans une partie de votre flux de travail. Il complète une ligne, explique une méthode ou effectue une petite modification, comme le font les suggestions en ligne de GitHub Copilot.
- Un agent prend une tâche en plusieurs étapes, modifie les fichiers, exécute la construction et les tests, et soumet le résultat pour examen, comme le font Claude Code, ChatGPT Codex, Cursor et Google Antigravity.
La configuration est identique pour les deux. Installez le package, appliquez la clé de licence depuis une variable d'environnement, fournissez la documentation lisible par machine d'IronOCR, et vérifiez chaque valeur extraite par rapport à une page dont vous connaissez déjà le texte. Cela s'applique aussi bien aux images qu'aux PDF scannés, ainsi qu'à rendre une numérisation consultable, lire plusieurs langues, extraire des codes-barres de la même lecture ou améliorer une numérisation de mauvaise qualité.
Comment utiliser IronOCR avec un assistant ou agent de codage intelligent
- Téléchargez la bibliothèque C# OCR depuis NuGet
- Chargez la clé de licence depuis une variable d'environnement avant la première lecture
- Donnez à l'assistant l'index
llms.txtd'IronOCR avant qu'il n'écrive du code - Enregistrez les règles d'IronOCR où que votre assistant conserve les instructions du projet
- Commencez une nouvelle session avec l'invite de configuration suivante
- Compilez, puis vérifiez la sortie d'IronOCR par rapport aux valeurs attendues sur chaque page d'exemple
Mon assistant IA ne peut-il pas gérer l'OCR seul?
Sans documentation, un assistant se fie à tout code OCR qu'il a absorbé lors de son entraînement, qui mélange souvent des paramètres issus de wrappers Tesseract bruts ou d'une version antérieure d'IronOCR.
IronOCR publie une documentation conçue pour être lue par des outils, y compris des tutoriels, des guides pratiques et plus de cinquante articles de dépannage. Une fois l'assistant chargé, la documentation montre comment IronTesseract, OcrInput et OcrResult s'assemblent.
Le choix du moteur reste important. Les wrappers Tesseract gratuits gèrent bien une page propre et droite en anglais.
- Un résultat lisible ne garantit pas un résultat correct : un résultat OCR peut être fluide mais toujours transformer 589,50 en 580,50.
OcrResultsignale un score de confiance pour chaque mot afin d'indiquer où chercher. - Les numérisations nécessitent une préparation : des pages tordues, bruyantes ou en basse résolution sont mal lues par n'importe quel moteur.
OcrInputpropose des filtres qui redressent une page, éliminent le bruit, augmentent la résolution, et plus. - Adapter manuellement un moteur est coûteux : chaque tentative d'un assistant sur les paramètres bruts de Tesseract dépense des jetons pour un travail que la bibliothèque fait déjà, et le coût se répète avec chaque nouveau type de document.
- Le package dépend de la plateforme :
IronOcrcouvre Windows,IronOcr.MacOscouvre les Macs Intel, etIronOcr.MacOs.ARMcouvre les Apple silicon. Un assistant peut aussi inventer un nom de package plausible, et des attaquants enregistrent ces noms avec du code malveillant, une pratique appelée slopsquatting. Nommez le package dans l'invite. - Le licensing est prévisible : les services OCR en cloud facturent souvent à la page ou à l'appel, et un assistant ne mentionnera pas ces termes de lui-même. IronOCR fonctionne localement sous une licence commerciale perpétuelle tarifée par paliers de développeurs, de localisations et de projets, sans facturation par page.
Étape 1 : Installez IronOCR
Une fois la référence au package existante, l'assistant peut voir les types réels d'IronOCR lorsqu'il génère du code.
Install the IronOcr NuGet package into this project and confirm it restores.
Le guide d'installation NuGet avancé répertorie les autres options d'installation.
Étape 2 : Appliquez votre clé de licence
IronOCR n'a pas de mode non licencié filigrané. Construire un IronTesseract sans clé réussit, mais la première lecture lève IronSoftware.Exceptions.LicensingException avec le message "Production License Required". Une clé présente mais mal tapée produit "License Key Not Recognized" de la même méthode. Vous pouvez obtenir une clé d'essai gratuite ci-dessous.
Commencez à utiliser IronOCR dans votre projet dès aujourd'hui avec un essai gratuit.
Définissez IronOcr.License.LicenseKey au démarrage de l'application, avant tout autre appel IronOCR, et lisez-le depuis la variable d'environnement IRONOCR_LICENSE_KEY pour qu'il n'entre jamais dans le contrôle de source. La même classe dispose également d'une méthode qui teste une chaîne de clé sans l'appliquer.
Web.config et appsettings.json.Étape 3 : Dirigez votre assistant vers la documentation LLM d'IronOCR
llms.txtest l'index, une ligne par page.- Les résumés de 145 pages arrivent en une seule récupération depuis
llms-full.txt. llms-full-catalog.txtajoute le blog à l'index.- La référence API documente chaque type et membre.
- Configuration, licence, recettes et correctifs sont dans
skill.md. - La fiche produit AI résume la portée, les plateformes et les limites.
Lorsque qu'une tâche dépend du détail d'un guide, demandez à l'assistant d'ouvrir la page de ce guide.
Fournissez une instruction directe avec l'index.
Before writing any IronOCR code, read https://ironsoftware.com/ocr/csharp/llms.txt
and use only APIs documented there. A read is assembled on an OcrInput, whose
Load overloads differ by source type, and run through IronTesseract.Read.
Confirm the overload you pick against
https://ironsoftware.com/ocr/csharp/object-reference/api/, and if you cannot find
it, say so instead of guessing.
Étape 4 : Ajoutez un contexte IronOCR à votre projet
Placez les règles IronOCR dans le fichier que votre équipe conserve déjà. Claude Code lit CLAUDE.md, GitHub Copilot lit .github/copilot-instructions.md, et ChatGPT Codex et Google Antigravity lisent AGENTS.md. Cursor lit .cursor/rules/*.mdc ou AGENTS.md, et seul son fichier de règles nécessite un en-tête MDC. Utilisez ce qui suit comme point de départ.
## OCR with IronOCR
This project uses IronOCR (NuGet package `IronOcr`, or `IronOcr.Linux` for Linux and Docker, namespace `IronOcr`) for all OCR work.
- Reference: https://ironsoftware.com/ocr/csharp/llms.txt
- Skill file: https://ironsoftware.com/ocr/csharp/skill.md
- Read with `IronTesseract` and an `OcrInput` inside a `using` block, and use the `OcrResult` it returns.
- Read the license key from the IRONOCR_LICENSE_KEY environment variable at startup. Never inline it.
- Every OCR change must be tested against sample pages whose text is known, reporting the values read and their confidence.
- Do not add another OCR engine or a cloud OCR service. If IronOCR cannot do something, say so.
L'exemple à fichier unique du fichier de compétence conserve IronOcr 2026.7.2 tandis que NuGet fournit maintenant 2026.10.2. Il est également indiqué de conserver chaque package Iron à la même version, ce que les packs de langue ne peuvent suivre, puisque IronOcr.Languages.German a été publié pour la dernière fois en 2020.11.2. Sa recette ConvertToSearchablePdf en une ligne échouait sur les PDF scannés avec images uniquement lors de nos tests, tandis que charger le PDF, le lire, et appeler SaveAsSearchablePdf sur le résultat fonctionnait.
Étape 5 : Invite de configuration en une seule fois
Tout de l'étape 1 à 4 peut être envoyé dans un seul message.
Use IronOCR for all OCR work in this project.
1. Install the IronOcr NuGet package (IronOcr.Linux when the app runs on Linux or Docker).
2. Apply the license key at application startup, before any other IronOCR call,
reading it from the IRONOCR_LICENSE_KEY environment variable. Never write
the key into source or into a committed file.
3. Read https://ironsoftware.com/ocr/csharp/llms.txt before writing OCR code
and work only from APIs documented there, checking the API reference when a
member is unfamiliar.
4. Load https://ironsoftware.com/ocr/csharp/skill.md if your tooling supports skill files.
5. Keep these instructions for future sessions in this project.
Étape 6 : Modèles d'invite qui produisent un code fonctionnel
Les résultats faibles proviennent généralement d'une invite qui laisse de la place à l'assistant pour deviner.
Nommez l'entrée, les champs et la langue.
Vague Lisez les factures avec IronOCR.
Mieux Utilisez IronTesseract avec un OcrInput qui charge chaque PDF scanné, lisez le numéro de facture et la ligne commençant par Total à payer, et retournez le montant avec la confiance de cette ligne.
Indiquez également la version et le framework.
Mieux Ciblez .NET 9 avec IronOcr 2026.9.4.
Demandez le fichier complet.
Mieux Renvoyez le Program.cs complet, directives et configuration de la licence incluses, prêt à être compilé sans modifications.
Étape 7 : Vérifiez ce que vous obtenez
Surveillez ces erreurs courantes.
- OCR sur un PDF qui a déjà du texte : extraire une véritable couche de texte est plus rapide et plus précis que de faire fonctionner l'OCR sur les pages. Vérifiez d'abord la présence d'une couche de texte et commandez l'OCR uniquement sur les pages scannées.
- Chaque filtre en même temps : empiler une correction après l'autre sur une page propre peut réduire l'exactitude et ajoute toujours du temps. Sur un ensemble dense de factures lors de nos essais de test,
DeNoisea transformé le dernier 1 d'un numéro de facture tourné en un 4, et ajouterDilatea corrigé cette page mais a coûté à d'autres ensembles de une à trois lignes. Appliquez uniquement le filtre qui corrige le défaut que vous voyez. Le fichier de compétences d'IronOCR donne le même conseil, et le guide de correction de la qualité de l'image décrit quand chaque filtre s'applique.
Laissez l'agent vérifier son propre travail
Build and run this project in Release. Confirm that every IronOCR member you used
appears in the documentation, that IronOcr.License.IsLicensed returns true, and
that every sample page reads back with the values it is known to contain.
Report the build result and a table of page, expected value, value read, confidence, and match.
Comment lire des langues autres que l'anglais ?
L'anglais est la seule langue dans le package IronOcr. La liste des langues d'IronOCR couvre 125. Donnez ces informations à l'assistant.
- Une autre langue nécessite son pack, tel que
IronOcr.Languages.German, puisLanguage = OcrLanguage.German. - Sans accès à NuGet, utilisez le fichier
.ocrdataetInstallation.LanguagePackDirectory. - Les variantes Fast et Best telles que
OcrLanguage.GermanFastsont livrées dans le même package. - Pour une page dans plusieurs langues, appelez
AddSecondaryLanguage, la plus courante d'abord. - Les tableaux financiers prennent
OcrLanguage.FinancialdepuisIronOcr.Languages.Financial. - Un modèle formé ailleurs se charge via
UseCustomTesseractLanguageFileavec un fichier.traineddata.
Un pack manquant soulève LanguagePackException à la première lecture. Son message nomme exactement le package NuGet et l'alternative .ocrdata, alors demandez à l'assistant d'installer ce que le message nomme.
Le guide de configuration rapide d'IronOCR signale un gain de 17% avec EnglishFast combiné à la désactivation de la lecture des codes-barres. Sur dix de nos pages, cette variante à elle seule est restée dans les limites du bruit de répétition de l'anglais, alors chronométrez les variantes sur vos propres pages avant d'échanger la précision pour la vitesse.
La publication ClickOnce omet les fichiers .ocrdata des langues secondaires, comme l'explique la note ClickOnce. Sous Windows, ajouter EnglishFast comme langue secondaire peut poser un problème avec les grands PDF dans les versions 2025.12.3 à 2026.7.2, comme l'enregistre cette entrée de dépannage.
Quels sont les paramètres IronOCR activés par défaut ?
Le code généré définit souvent des valeurs qui sont déjà des paramètres par défaut, ou omet un paramètre qui est désactivé par défaut. Voici les valeurs initiales en IronOcr 2026.9.4, lues depuis un nouveau IronTesseract.
| Paramètres | Default | Changez-le pour |
|---|---|---|
Language | Anglais | Autres langues |
Configuration.ReadBarCodes | désactivé | Codes-barres |
Configuration.ReadDataTables | désactivé | Structure des tables |
Configuration.RenderSearchablePdf | activé | Ignorer la sortie consultable |
Configuration.RenderHocr | désactivé | sortie hOCR |
Configuration.PageSegmentationMode | AutoOsd | Découpes sur une ligne ou un mot |
Configuration.EngineMode | LstmOnly | Rarement |
Configuration.WhiteListCharacters et BlackListCharacters | vide | Jeux de caractères restreints |
Configuration.TesseractVariables | trois entrées préréglées | Variables brutes Tesseract |
MultiThreaded | activé | Rarement |
MaxDegreeOfParallelism | Environment.ProcessorCount | Gros lots à court de mémoire |
OcrInput.TargetDPI | 0 | Numérisations basse résolution |
Au-delà de la lecture standard, IronTesseract fournit des lecteurs adaptés à d'autres entrées. ReadPhoto gère les photographies de documents et ReadScreenShot manipule les captures d'écran. Le tutoriel pour documents spécialisés liste toujours IronOcr.Extensions.AdvancedScan pour eux, mais ce package a été expédié pour la dernière fois en 2025 et aucun lecteur n'en avait besoin. Le même tutoriel couvre également les lecteurs de passeports et de plaques d'immatriculation.
Un résultat que vous pouvez reproduire
L'invite
Build a .NET 9 console app that reads totals from scanned invoices. Start in an empty folder; if it already holds code or project files, stop and report. Work start to finish alone: write, build, run, and fix, making sensible assumptions where anything is unspecified. Save every deliverable under the project root, in the folders named below.
1. Install the IronOcr NuGet package pinned to version 2026.9.4.
2. Read https://ironsoftware.com/ocr/csharp/llms.txt and the pages it links to, and use only IronOCR APIs documented there for the OCR work. Any .NET imaging library may draw the test images.
3. Read the license key from the IRONOCR_LICENSE_KEY environment variable at startup and never write it into source or any output file. If IronOcr.License.IsLicensed is false, stop and report that.
4. With random seed 2026, generate testset/invoice-01.png to invoice-10.png. Each is a US Letter page of exactly 1700 x 2200 pixels, saved as PNG with 200 DPI in the file metadata, with all text in Arial inside 0.75 inch margins, headings at 14 point bold and everything else at 11 point. Each invoice has an invoice number made of INV- and six random digits, a customer name, three line items with random prices in dollars and cents, and a total equal to their sum, with no two totals alike.
5. Rotate invoice-02 and invoice-07 by 3 degrees about the page center, keeping the 1700 x 2200 canvas. Add speckle noise to invoice-04 and invoice-09: dark square specks 1 or 2 pixels wide, placed anywhere including over the text, until they have darkened 1% of the page's pixels, counting a pixel as dark below 128 of 255. Leave the other six clean. Write manifest.csv with each file, invoice number, the three prices, total, and distortion (none, rotated, or speckled).
6. Before the first OCR call, check every saved image: 1700 x 2200 pixels, 200 DPI when rounded, and, measured on each page before distortion, the smallest distance from any ink to an edge, at least 0.75 inch. On each speckled page, check that speckling raised the share of dark pixels by 0.9 to 1.1 percentage points. Also draw a capital H with the 11 point font on a 200 DPI bitmap and check that its ink is 21 to 23 pixels tall. If a check fails, fix the generator. After the first OCR call, never regenerate or change the saved image files; filters applied in memory are expected.
7. Read all 10 images in one OcrInput with one set of filters for every page. Each run of the program uses one filter set; it must not try several or choose between them, and choosing filters is your job between runs. No manifest value, file name, or expected value may steer the OCR or the parsing of its text; read the manifest only to write roundtrip.md. The reader must hold no invoice number, price, or total as a literal and must run the same code for every page. Extract each page's invoice number and total, save each page's OCR text as ocr/invoice-01.txt to invoice-10.txt, and save the result as invoices-searchable.pdf.
8. Build in Release and run.
9. Write roundtrip.md: the step 6 checks as measured numbers for every image, not pass or fail words, the filter set used, then a table of file, distortion, expected invoice number, invoice number read, expected total, total read, the Confidence (0 to 100) of the OCR line holding the total or n/a, and match, then the page count of invoices-searchable.pdf loaded back with OcrInput. A row matches only when the invoice number read is identical to the expected one and the total read equals the expected total to the cent.
10. All 10 rows must match and the PDF must have 10 pages. If not, read the saved OCR text of the failing pages, change the filter set or the reader, rebuild, and run again. If rows still fail after eight such runs, stop and report which rows failed, the filter sets tried, and why.
11. Finish with a short report: build result, match count, filters used, font sizes used, and assumptions made.
Sortie
Il s'agit de la facture-09, l'une des deux pages tachetées de cette série, découpée dans la zone imprimée. Une lecture simple a correspondu à 8 des 10 factures et n'a pas identifié les deux pages tachetées, indiquant le numéro de facture de celle-ci comme ANV-938066, et Deskew seul n'a pas fait mieux. Avec DeNoise ajouté, IronOCR a retourné INV-939066 et 1731,53, avec une confiance de 41,45 sur la ligne totale, la plus basse de la série. L'autre ligne totale tachetée a été lue à 63,86 et les pages propres à environ 95. Claude Code a choisi ces deux filtres dans son premier brouillon et les a conservés lors des cinq exécutions du programme.
- Une vérification indépendante a mesuré à nouveau chaque exigence, et toutes les 10 factures correspondaient.
- ChatGPT Codex avec GPT-6 Luna a aussi correspondu 10 sur 10 à la même invite.
roundtrip.mdest publié sans modification et
à taille réduite.
Ce qui passe
- Le code n'a nécessité aucune modification de votre part.
- Ouvrir une image montre un petit texte sans rien couper sur les bords, et des taches sur le texte ainsi que sur les marges.
- Chaque numéro de facture et total dans
roundtrip.mdapparaît également dans le texte OCR enregistré de cette page.
L'enregistrement de l'exécution
- La machine fonctionne sous Windows 11 x64 sur un Core i9-14900KF avec 64 Go de mémoire.
- Chaque projet cible .NET 9.
- Ce guide, Copilot, et Cursor ont exécuté
IronOcr2026.9.4, tandis que Claude Code, Codex et Antigravity ont exécuté 2026.10.2. Copilot a ajoutéIronOcr.Linux2026.9.4, et Codex, Cursor, et Antigravity ont ajoutéIronOcr.Languages.German2020.11.2. - Dernière fois testé le 8 octobre 2026 avec l'exécution de Cursor. Chaque autre exécution date du 6 octobre.
| Guide | Assistant et version | Modèle | Durée (minutes) |
|---|---|---|---|
| Ce guide | Claude Code 2.1.277, invites de permission désactivées | Claude Opus 5 | 20.8 |
| Claude Code | Claude Code 2.1.277 | Claude Sonnet 5 | 9.4 |
| ChatGPT Codex | CLI Codex 0.160.0 | GPT-6 Luna | 27.7 |
| GitHub Copilot | Mode agent Copilot dans VS Code 1.140 | GPT-6 Luna, routé par Auto | 22.0 |
| Cursor | Application de bureau Cursor 3.23.23 | Grok 4.7 | 83.5 |
| Google Antigravity | Antigravity CLI 1.3.0 | Gemini 3.8 Flash (Élevé) | 32.7 |
Guides spécifiques aux agents
Pour des étapes qui conviennent à un outil, ouvrez son guide.
- Utilisez IronOCR avec Claude Code
- Utilisez IronOCR avec ChatGPT Codex
- Utilisez IronOCR avec GitHub Copilot
- Utilisez IronOCR avec Cursor
- Utilisez IronOCR avec Google Antigravity
Dépannage
- Appliquer une clé de licence dans IronOCR
- Améliorer la précision de l'OCR si le texte reconnu ne correspond pas à la page
- Dépannage général de l'OCR si des erreurs apparaissent après le déploiement
Des questions ?
Si vous avez des questions, contactez support@ironsoftware.com
Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.