Installation

Install AutoGen for .NET via NuGet

Package Overview

AutoGen for .NET provides multiple NuGet packages to suit different needs. You can install the all-in-one package or choose specific packages based on your requirements.

All packages require .NET 6.0 or later.

Quick Install

For most users, install the all-in-one package:

dotnet add package AutoGen

This package includes:

• AutoGen.Core - Core abstractions and types
• AutoGen.OpenAI - OpenAI integration
• AutoGen.LMStudio - LM Studio support
• AutoGen.SemanticKernel - Semantic Kernel integration
• AutoGen.SourceGenerator - Type-safe function generation

Package Versions

Stable (Recommended)

Install the latest stable version from NuGet:

dotnet add package AutoGen

Nightly Build

For the latest features and bug fixes, use nightly builds:

Add the nightly feed to your NuGet.config:

NuGet.config

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <clear />
    <add key="AutoGen-Nightly" value="https://pkgs.dev.azure.com/AGPublish/AGPublic/_packaging/AutoGen-Nightly/nuget/v3/index.json" />
    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
  </packageSources>
</configuration>

Or add via command line:

dotnet nuget add source https://pkgs.dev.azure.com/AGPublish/AGPublic/_packaging/AutoGen-Nightly/nuget/v3/index.json --name AutoGen-Nightly

For dotnet-interactive support:

dotnet nuget add source https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet-tools/nuget/v3/index.json --name dotnet-tools

Install the nightly package:

dotnet add package AutoGen --version VERSION

Individual Packages

Install only the packages you need for a minimal footprint:

AutoGen.Core

Core abstractions for agents, messages, and group chat. Use this if you want to avoid dependencies on specific LLM providers.

dotnet add package AutoGen.Core

Includes:

• Agent abstractions (IAgent, IStreamingAgent)
• Message types (TextMessage, ImageMessage, etc.)
• Group chat and orchestration
• Middleware infrastructure

AutoGen.OpenAI

OpenAI model integration including GPT-4, GPT-3.5, and Azure OpenAI.

dotnet add package AutoGen.OpenAI

Features:

• OpenAIChatAgent for OpenAI models
• Streaming support
• Function calling
• Vision capabilities

AutoGen.Anthropic

Claude model integration from Anthropic.

dotnet add package AutoGen.Anthropic

Features:

• AnthropicClientAgent for Claude models
• Prompt caching support
• Tool/function calling

AutoGen.AzureAIInference

Azure AI Inference integration for models deployed on Azure.

dotnet add package AutoGen.AzureAIInference

Features:

• ChatCompletionsClientAgent for Azure AI models
• Support for GitHub Models, Azure AI Studio
• Compatible with various model providers

AutoGen.SemanticKernel

Integration with Microsoft Semantic Kernel.

dotnet add package AutoGen.SemanticKernel

Features:

• SemanticKernelAgent wrapper
• Access to Semantic Kernel plugins
• Unified agent interface

AutoGen.SourceGenerator

Source generator for type-safe function definitions.

dotnet add package AutoGen.SourceGenerator

Features:

• [Function] attribute for methods
• Automatic schema generation from XML docs
• Compile-time type safety
• Zero runtime reflection

AutoGen.DotnetInteractive

Code execution support using dotnet-interactive.

dotnet add package AutoGen.DotnetInteractive

Supports:

• C# code execution
• F# code execution
• PowerShell scripts
• Python scripts (with Python kernel)

AutoGen.Mistral

Mistral AI model integration.

dotnet add package AutoGen.Mistral

AutoGen.Gemini

Google Gemini model integration.

dotnet add package AutoGen.Gemini

AutoGen.Ollama

Local model support via Ollama.

dotnet add package AutoGen.Ollama

AutoGen.LMStudio

LM Studio local model support.

dotnet add package AutoGen.LMStudio

Choosing the Right Package

1. All-in-One

   Install AutoGen if you want to get started quickly with common providers like OpenAI and don’t mind the additional dependencies.

   dotnet add package AutoGen
   
2. Core Only

   Install AutoGen.Core if you:

   • Want minimal dependencies
   • Plan to implement custom agents
   • Only need the abstraction layer

   dotnet add package AutoGen.Core
   
3. Provider-Specific

   Install specific provider packages based on your LLM:

   OpenAI

   dotnet add package AutoGen.Core
   dotnet add package AutoGen.OpenAI
   

   dotnet add package AutoGen.Core
   dotnet add package AutoGen.Anthropic
   

   dotnet add package AutoGen.Core
   dotnet add package AutoGen.AzureAIInference
   
4. Add Optional Features

   Enhance your application with optional packages:

   # For type-safe functions
   dotnet add package AutoGen.SourceGenerator
   
   # For code execution
   dotnet add package AutoGen.DotnetInteractive
   
   # For Semantic Kernel integration
   dotnet add package AutoGen.SemanticKernel
   

Verification

Verify your installation by checking the installed packages:

dotnet list package

You should see the AutoGen packages listed with their version numbers.

Example Project File

Here’s a complete .csproj example with common packages:

YourProject.csproj

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net8.0</TargetFramework>
    <Nullable>enable</Nullable>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="AutoGen.Core" Version="0.2.0" />
    <PackageReference Include="AutoGen.OpenAI" Version="0.2.0" />
    <PackageReference Include="AutoGen.SourceGenerator" Version="0.2.0" />
    <PackageReference Include="AutoGen.DotnetInteractive" Version="0.2.0" />
  </ItemGroup>
</Project>

Replace version numbers with the latest available versions from NuGet.

Next Steps

Quick Start

Build your first AutoGen application

Core Concepts

Learn about agents and messaging