VOOZH about

URL: https://www.nuget.org/packages/GoogleAdk/

⇱ NuGet Gallery | GoogleAdk 1.0.0-preview.22



GoogleAdk 1.0.0-preview.22

This is a prerelease version of GoogleAdk. 
dotnet add package GoogleAdk --version 1.0.0-preview.22
 
 
NuGet\Install-Package GoogleAdk -Version 1.0.0-preview.22
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="GoogleAdk" Version="1.0.0-preview.22" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="GoogleAdk" Version="1.0.0-preview.22" />
 


 Directory.Packages.props
 

 

 
<PackageReference Include="GoogleAdk" />
 


 Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add GoogleAdk --version 1.0.0-preview.22
The NuGet Team does not provide support for this client. Please contact its maintainers for support. 
#r "nuget: GoogleAdk, 1.0.0-preview.22"
#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. 
#:package GoogleAdk@1.0.0-preview.22
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=GoogleAdk&version=1.0.0-preview.22&prerelease
 


 Install as a Cake Addin
 

 

 
#tool nuget:?package=GoogleAdk&version=1.0.0-preview.22&prerelease
 


 Install as a Cake Tool
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Agent Development Kit (ADK) for .NET (C#)

👁 NuGet

<html> <h2 align="center"> <img src="docs/assets/agent-development-kit.png" width="256"/> </h2> <h3 align="center"> An open-source, code-first .NET toolkit for building, evaluating, and deploying sophisticated AI agents with flexibility and control. </h3>

</html>

Agent Development Kit (ADK) is designed for developers seeking fine-grained control and flexibility when building advanced AI agents that are tightly integrated with services in Google Cloud. It allows you to define agent behavior, orchestration, and tool use directly in code, enabling robust debugging, versioning, and deployment anywhere – from your laptop to the cloud.

⚠️ EXPERIMENTAL - This project is in active development and the API will change. Builds are nightly and super frequent and may contain breaking changes. Use in production at your own risk.

✨ Key Features

🧠 Intelligence & Models

  • Model Backends: Support for Gemini (GoogleAdk.Models.Gemini) and MEAI (GoogleAdk.Models.Meai) for providers like Ollama. .
  • Planning: Equip agents with ReAct-style planners via natural-language processing. .
  • Caching: Prompt and context caching using Gemini-backed implicit caching. .

🛠️ Tools & Integrations

  • C# Source Gen Tools: Effortlessly turn methods into tools using the [FunctionTool] attribute. .
  • Agent Skills: Folder-based skills (SKILL.md, references/, assets/, scripts/) with SkillToolset and optional SkillLoader.LoadFromDirectory for disk-backed skills, aligned with the Python ADK pattern. .
  • MCP Support: Full Model Context Protocol integration with dynamic tool discovery. .
  • OpenAPI Integration: Generate tools seamlessly from OpenAPI specs.
  • Code Execution: Run generated code within secure environments. .
  • Text-to-Speech (TTS): Generate audio directly from compatible LLMs like gemini-2.5-flash-preview-tts. .
  • Built-in Tools: Use pre-configured tools for Computer Use (Browser Automation), Cloud Spanner (Query and Vector Search), BigQuery, Google Search, Vertex AI, code execution, and more. .

🔄 Orchestration & Workflows

  • Agent Orchestration: Combine agents using SequentialAgent, ParallelAgent, or LoopAgent with customizable LLM pipelines. .
  • A2A Protocol: Built-in support for Remote Agent-to-Agent communication (both Client and Server). .
  • Plugins & Telemetry: Lifecycle hooks, streaming events, and OpenTelemetry-style tracing. .

💾 State & Memory

  • State Management: Flexible session state with placeholder injection for dynamic instructions. .
  • Memory: Built-in memory services and persistence options including EF Core storage. .

🚀 Development & Deployment

  • Code-First Approach: Define agents, tools, and logic in C# for great testability and versioning.
  • ADK Web UI: Embedded development server with a rich UI, REST/WebSocket APIs, and Swagger. .
  • Evaluation: Tools for systematic prompt/agent tuning and LLM-as-judge scoring. .

🚀 Installation

Install the preview package via NuGet:

dotnet add package GoogleAdk --prerelease

📚 Documentation

For building, evaluating, and deploying agents, follow the docs and samples:

  • (feature guides for this .NET port)
  • — defining skills in code, loading from disk with SkillLoader, and wiring SkillToolset on an agent
  • Samples — includes GoogleAdk.Samples.Skills, which loads a .skill/ folder next to the project and runs the agent in the console

🏁 Feature Highlight

Same Features & Familiar Interface As Other ADKs:

// Load env variables like GOOGLE_API_KEY
AdkEnv.Load();

var rootAgent = new LlmAgent(new()
{
 Name = "weather_assistant",
 Description = "An assistant that provides weather data.",
 Model = "gemini-2.5-flash",
 Instruction = "You are a helpful assistant. If the user asks about weather, use the GetWeatherData tool to provide the forecast.",
 
 // GetWeatherDataTool is generated from GetWeatherData in the format ADK expects
 Tools = [GetWeatherDataTool]
});

// Creates a webserver that can launch the ADK web UI and other endpoints 
await AdkServer.RunAsync(rootAgent);

//await ConsoleRunner.RunAsync(rootAgent); for running in console or you can easily implement your custom runner

/// <summary>
/// Fetches the current weather data for a given location.
/// </summary>
/// <param name="location">The location to get the weather for (e.g., 'New York')</param>
/// <returns>A WeatherData object containing the location and forecast</returns>
[FunctionTool]
static WeatherData? GetWeatherData(string location)
{
 return new WeatherData(location, "Sunny with a chance of rainbows");
}

public record WeatherData(string Location, string Forecast);

Development UI

Same as the Python Development UI. A built-in development UI to help you test, evaluate, debug, and showcase your agent(s).

<img alt="Image" src="https://github.com/user-attachments/assets/1f8db230-b8f2-4b3c-85c8-54c32ea9e379" />

Evaluate Agents

Use GoogleAdk.Evaluation and GoogleAdk.Optimization for eval sets, inference runs, scoring, and prompt tuning. See and sample GoogleAdk.Samples.EvalOptimize.

🤖 A2A and ADK integration

Remote agent-to-agent communication uses the A2A protocol. Client code lives under src/GoogleAdk.Core/A2a; server wiring is in GoogleAdk.ApiServer (MapA2aApi). End-to-end coverage is in tests/GoogleAdk.E2e.Tests. See .

🏗️ Building the Project

To set up the project and build it from source, follow these steps:

  1. Install dependencies:

    dotnet restore "GoogleAdk/GoogleAdk.slnx"

  2. Build the project:

    dotnet build "GoogleAdk/GoogleAdk.slnx"

🤝 Contributing

We welcome contributions from the community! Whether it's bug reports, feature requests, documentation improvements, or code contributions, please see our guidelines:

📄 License and intellectual property

Google’s Agent Development Kit (ADK)—the reference product family (for example, the Python ADK), its documentation, and related Google materials—is a copyrighted product of Google LLC and/or its affiliates. Google retains applicable rights in that product and in the ADK and Google trademarks.

This repository is a .NET port: an open-source implementation aligned with ADK-style APIs and patterns. It is not described here as Google’s own first-party, directly Google-copyrighted release of ADK for .NET; copyright in this port belongs to its contributors, who license the code under the Apache License, Version 2.0. See for the full terms, including how upstream ADK, this port, and trademarks are distinguished.

Use, reproduction, and distribution of this repository are governed by the Apache License, Version 2.0; it does not transfer ownership of Google’s ADK, Google’s trademarks, or third-party materials to you. Third-party components may be subject to separate licenses as noted in the applicable files or notices.

If you contribute code, your contributions may be subject to the contributor license arrangements described in the contribution documentation. Nothing in this README is legal advice or a waiver of Google’s or any third party’s rights except as stated in and applicable licenses.

Happy Agent Building!

Product Versions Compatible and additional computed target framework versions.
.NET net10.0 net10.0 is compatible.  net10.0-android net10.0-android was computed.  net10.0-browser net10.0-browser was computed.  net10.0-ios net10.0-ios was computed.  net10.0-maccatalyst net10.0-maccatalyst was computed.  net10.0-macos net10.0-macos was computed.  net10.0-tvos net10.0-tvos was computed.  net10.0-windows net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.0-preview.22 70 5/23/2026
1.0.0-preview.21 75 4/27/2026
1.0.0-preview.20 70 4/26/2026
1.0.0-preview.19 61 4/24/2026
1.0.0-preview.18 62 4/22/2026
1.0.0-preview.17 64 4/21/2026
1.0.0-preview.16 79 4/12/2026
1.0.0-preview.15 66 4/7/2026
1.0.0-preview.14 64 4/7/2026
1.0.0-preview.13 69 4/5/2026
1.0.0-preview.12 70 4/5/2026
1.0.0-preview.11 83 4/5/2026
1.0.0-preview.10 68 4/4/2026
1.0.0-preview.9 72 4/4/2026
1.0.0-preview.8 64 4/4/2026
1.0.0-preview.7 62 4/4/2026
1.0.0-preview.6 73 4/4/2026
1.0.0-preview.5 60 4/4/2026
1.0.0-preview.4 73 4/3/2026
1.0.0-preview.3 65 4/3/2026
Loading failed