https://github.com/sps014/googleadk-cs
An open-source, code-first C# (Dotnet) toolkit for building, evaluating, and deploying sophisticated AI agents with flexibility and control.
https://github.com/sps014/googleadk-cs
agent-framework gemini google-adk vertex-ai
Last synced: 6 days ago
JSON representation
An open-source, code-first C# (Dotnet) toolkit for building, evaluating, and deploying sophisticated AI agents with flexibility and control.
- Host: GitHub
- URL: https://github.com/sps014/googleadk-cs
- Owner: sps014
- License: other
- Created: 2026-03-31T12:50:54.000Z (18 days ago)
- Default Branch: main
- Last Pushed: 2026-04-05T17:13:45.000Z (13 days ago)
- Last Synced: 2026-04-05T18:17:47.592Z (13 days ago)
- Topics: agent-framework, gemini, google-adk, vertex-ai
- Language: C#
- Homepage: https://sps014.github.io/GoogleAdk-cs/
- Size: 3.24 MB
- Stars: 11
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Agent Development Kit (ADK) for .NET (C#)
[](LICENSE.md)
[](#-installation)
An open-source, code-first .NET toolkit for building, evaluating, and deploying sophisticated AI agents with flexibility and control.
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. [More info](docs/models.md).
- **Planning**: Equip agents with ReAct-style planners via natural-language processing. [More info](docs/planning.md).
- **Caching**: Prompt and context caching using Gemini-backed implicit caching. [More info](docs/caching.md).
### 🛠️ Tools & Integrations
- **C# Source Gen Tools**: Effortlessly turn methods into tools using the `[FunctionTool]` attribute. [More info](docs/tools.md).
- **MCP Support**: Full Model Context Protocol integration with dynamic tool discovery. [More info](docs/mcp.md).
- **OpenAPI Integration**: Generate tools seamlessly from OpenAPI specs.
- **Code Execution**: Run generated code within secure environments. [More info](docs/code-execution.md).
- **Text-to-Speech (TTS)**: Generate audio directly from compatible LLMs like `gemini-2.5-flash-preview-tts`. [More info](docs/tts.md).
- **Built-in Tools**: Use pre-configured tools for Google Search, Maps, Vertex AI, code execution, and more. [More info](docs/features.md).
### 🔄 Orchestration & Workflows
- **Agent Orchestration**: Combine agents using `SequentialAgent`, `ParallelAgent`, or `LoopAgent` with customizable LLM pipelines. [More info](docs/orchestration.md).
- **A2A Protocol**: Built-in support for Remote Agent-to-Agent communication (both Client and Server). [More info](docs/a2a.md).
- **Plugins & Telemetry**: Lifecycle hooks, streaming events, and OpenTelemetry-style tracing. [More info](docs/plugins.md).
### 💾 State & Memory
- **State Management**: Flexible session state with placeholder injection for dynamic instructions. [More info](docs/state.md).
- **Memory**: Built-in memory services and persistence options including EF Core storage. [More info](docs/memory.md).
### 🚀 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. [More info](docs/running-agents.md).
- **Evaluation**: Tools for systematic prompt/agent tuning and LLM-as-judge scoring. [More info](docs/evaluation-optimization.md).
## 🚀 Installation
Install the preview package via NuGet:
```bash
dotnet add package GoogleAdk --prerelease
```
## 📚 Documentation
For building, evaluating, and deploying agents, follow the docs and samples:
- **[In-repo docs](docs/index.md)** (feature guides for this .NET port)
- **[Samples](https://github.com/sps014/GoogleAdk-cs/tree/main/samples)**
## 🏁 Feature Highlight
### Same Features & Familiar Interface As Other ADKs:
```csharp
// Load env variables like GOOGLE_API_KEY
AdkEnv.Load();
var rootAgent = new LlmAgent(new LlmAgentConfig
{
Name = "search_assistant",
Description = "An assistant that can search the web.",
Model = "gemini-2.5-flash",
Instruction = "You are a helpful assistant. Answer user questions using Google Search when needed. If User asks about weather use the GetWeather tool",
// GetWeatherDataTool is generated from GetWeatherData in the format ADK expects
Tools = [new GoogleSearchTool(), GetWeatherDataTool]
});
// Creates a webserver that can launch the ADK web UI and other endpoints
await AdkServer.RunAsync(rootAgent);
///
/// Fetches the current weather data for a given location.
///
/// The location to get the weather for (e.g., 'New York')
/// A WeatherData object containing the location and forecast
[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).
### Evaluate Agents
Use `GoogleAdk.Evaluation` and `GoogleAdk.Optimization` for eval sets, inference
runs, scoring, and prompt tuning. See
[docs/evaluation-optimization.md](docs/evaluation-optimization.md) and sample
`GoogleAdk.Samples.EvalOptimize`.
## 🤖 A2A and ADK integration
Remote agent-to-agent communication uses the
[A2A protocol](https://github.com/google/A2A/). **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 [docs/a2a.md](docs/a2a.md).
## 🏗️ Building the Project
To set up the project and build it from source, follow these steps:
1. **Install dependencies**:
```bash
dotnet restore "GoogleAdk/GoogleAdk.slnx"
```
2. **Build the project**:
```bash
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:
- [General contribution guideline and flow](https://google.github.io/adk-docs/contributing-guide/).
- Then if you want to contribute code, please read
[Code Contributing Guidelines](./CONTRIBUTING.md) to get started.
## 📄 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 **[LICENSE.md](LICENSE.md)** 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 **[LICENSE.md](LICENSE.md)** and applicable licenses.
---
_Happy Agent Building!_