Verndale.CognitiveImageTagging 1.0.0.20589

There is a newer version of this package available.
See the version list below for details.
dotnet add package Verndale.CognitiveImageTagging --version 1.0.0.20589                
NuGet\Install-Package Verndale.CognitiveImageTagging -Version 1.0.0.20589                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Verndale.CognitiveImageTagging" Version="1.0.0.20589" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Verndale.CognitiveImageTagging --version 1.0.0.20589                
#r "nuget: Verndale.CognitiveImageTagging, 1.0.0.20589"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Verndale.CognitiveImageTagging as a Cake Addin
#addin nuget:?package=Verndale.CognitiveImageTagging&version=1.0.0.20589

// Install Verndale.CognitiveImageTagging as a Cake Tool
#tool nuget:?package=Verndale.CognitiveImageTagging&version=1.0.0.20589                

This library features three functions:

- Using AI, "read" the image and provide a sentence description of what it portrays.
- Using AI, "read" the image and provide series of tags that describe what it portrays.
- Using AI, perform OCR on the image and, if the image has embedded text, extract the text to a string value.

The first two features are included in the IAnalysisService.GetImageDescription() call.
OCR can be performed by opting it into the GetImageDescription() call or by calling the IAnalysisService.ExtractTextFromImage() call.

Note that OCR tends to be a more expensive operation both in terms of elapsed time and number of connections to your AI service. Some charges may be incurred.

Requirements
You must have a subscription to Azure Cognitive Services for Computer Vision. You will need both a Subscription Key and an endpoint URL to use this library. Support for other AI
services is planned.


Installation and Use
Install this package using NuGet.

You can get an instance of IAnalysisService through Verndale.CognitiveImageTagging.ServiceManager.GetAnalysisService()
Alternately, you can use Dependency Injection. specify that IAnalysisService maps to Verndale.CognitiveImageTagging.Services.AzureService

You must add configuration to your app.config or web.config file. See the enclosed app.config.example for details.

In the supplied config example, you will see confidence levels for captions and embedded text. These are set to reasonable defaults, but be aware the AI can be
quirky and unreliable. This tool should be used prime the pump on image descriptions but should not be used unsupervised.

Product Compatible and additional computed target framework versions.
.NET Framework net471 is compatible.  net472 was computed.  net48 was computed.  net481 was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Verndale.CognitiveImageTagging:

Package Downloads
Verndale.Feature.CognitiveImageTagging

THIS IS AN EXPERIMENTAL LIBRARY - DO NOT PUBLISH AI-GENERATED ALT TEXT WITHOUT HUMAN REVIEW. This library can perform the following: - Using AI, "read" the image and provide a sentence description of what it portrays. - Using AI, "read" the image and provide series of tags that describe what it portrays. - Using AI, perform OCR on the image and, if the image has embedded text, extract the text to a string value. REQUIRED You must have a subscription to Azure Cognitive Services for Computer Vision. You will need both a Subscription Key and an endpoint URL to use this library. Support for other AI services are not implemented, but you can see where the extension would occur. INSTALLATION Install this package using NuGet. Copy and rename /App_Config/Verndale.CognitiveImageTagging.config.example Remove the "example" suffix. Supply appropriate Azure Cognitive service connection details within the config file. Don't forget to review the Sitecore Feature config file in App_Config/Include/Feature for details on how to activate this library. In the supplied config example, you will see confidence levels for captions and embedded text. These are set to reasonable defaults, but be aware the AI can be quirky and unreliable. This tool should be used prime the pump on image descriptions but should not be used unsupervised. USE Once configured, Images will receive AI-based Alt text when they are uploaded. To add Alt text to existing images, navigate to the image in the media library. The Media tab within the content editor will have new buttons that allow you to retrieve ALT text from AI for the selected Media Item. ALT text will be used in the following order If the image contains text, the text will be written to the Image's Alt field. If the AI returns a high-confidence Caption, that caption will be written to the Image's Alt field. Any descriptive tags returned by the AI will be written to the Image's Alt field in comma-delimited fashion. Keep in mind that AI for image descriptions is relatively experimental. Your descriptive results will depend on image the image. Celebrities tend to get tagged reliably, close-ups, abstract, or heavily filtered photos tend to have less reliable or extermely generic results. DO NOT TRUST AI TO SUPPLY YOU WITH ALT TEXT WITHOUT HUMAN REVIEW. Generated alt text may contain inaccurate descriptions or tags that could be construed as misleading or offensive. Use at your own risk! Do not publish any AI generated content without human review.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
3.0.1.25842 2,000 9/14/2020 3.0.1.25842 is deprecated because it is no longer maintained.
3.0.0.18234 823 9/14/2020
2.0.2.20618 949 9/9/2020
2.0.1.20240 905 9/9/2020
2.0.0.18714 886 9/9/2020
1.0.0.20589 994 8/6/2019

Initial Release