Skip to content

Latest commit

 

History

History

README.md

Umbraco.AI.Google

NuGet

Google provider plugin for Umbraco.AI, enabling integration with Google's Gemini models.

Features

  • Google AI Support - Connect to Google's AI API (Gemini 2.0, 1.5 Pro, 1.5 Flash, etc.)
  • Chat Capabilities - Full support for chat completions with streaming
  • Model Configuration - Configure temperature, max tokens, and other model parameters
  • Middleware Support - Compatible with Umbraco.AI's middleware pipeline

Monorepo Context

This package is part of the Umbraco.AI monorepo. For local development, see the monorepo setup instructions in the root README.

Installation

dotnet add package Umbraco.AI.Google

Requirements

  • Umbraco CMS 17.0.0+
  • Umbraco.AI 1.0.0+
  • .NET 10.0

Configuration

After installation, create a connection in the Umbraco backoffice:

  1. Navigate to the AI section
  2. Create a new Google connection
  3. Enter your API key from Google AI Studio
  4. Create a profile using this connection

API Configuration

{
    "ApiKey": "AIza..."
}

Supported Models

Chat Models:

  • Gemini 2.0 Flash
  • Gemini 2.0 Flash Lite
  • Gemini 1.5 Pro
  • Gemini 1.5 Flash
  • Gemini 1.5 Flash 8B

Known Limitations

  • Billing account required for free-tier models - Even when using free models (e.g., Gemini Flash), Google requires a billing account with a credit card on file. Without billing enabled, API requests will fail with a "quota exceeded" error. You can set up billing in the Google AI Studio or Google Cloud Console.

Documentation

License

This project is licensed under the MIT License. See LICENSE.md for details.