Getting Started

# Install the AI Gateway client library
dotnet add package Noundry.AIG.Client

using Noundry.AIG.Client;
using Noundry.AIG.Client.Builders;
using Noundry.AIG.Client.Configuration;
using Noundry.AIG.Core.Extensions;
using Noundry.AIG.Core.Models;
using Noundry.AIG.Providers;

// Configure the client
var httpClientFactory = new SimpleHttpClientFactory();
var providerFactory = new ProviderFactory(httpClientFactory);

var options = new AigClientOptions
{
 UseLocalProviders = true,
 ProviderConfigs = new Dictionary<string, ProviderConfig>
 {
 ["openai"] = new ProviderConfig
 {
 ApiKey = Environment.GetEnvironmentVariable("OPENAI_API_KEY")
 },
 ["anthropic"] = new ProviderConfig
 {
 ApiKey = Environment.GetEnvironmentVariable("ANTHROPIC_API_KEY")
 }
 }
};

var aigClient = new AigClient(providerFactory, options);

// Send a request using PromptBuilder
var prompt = new PromptBuilder()
 .WithModel("anthropic/claude-sonnet-4")
 .WithTemperature(0.7f)
 .AddSystemMessage("You are a helpful AI assistant.")
 .AddUserMessage("Explain quantum computing in simple terms.")
 .Build();

var response = await aigClient.SendAsync(prompt);
Console.WriteLine(response.GetTextContent());

// Create a chain that generates, writes, and translates content
var chain = new ChainPromptBuilder()
 .WithDefaultModel("anthropic/claude-sonnet-4")

 // Step 1: Generate a random topic
 .AddStep("Generate Topic", _ =>
 new PromptBuilder()
 .AddUserMessage("Give me a random creative writing topic."))

 // Step 2: Write about the topic (uses previous output)
 .AddStep("Write Content", previousOutput =>
 new PromptBuilder()
 .AddUserMessage($"Write a short paragraph about: {previousOutput}"))

 // Step 3: Translate to Spanish
 .AddStep("Translate", previousOutput =>
 new PromptBuilder()
 .WithModel("openai/gpt-4") // Can use different models per step
 .AddUserMessage($"Translate to Spanish:\n{previousOutput}"));

// Execute the chain
var result = await chain.ExecuteAsync(aigClient);

if (result.Success)
{
 Console.WriteLine($"Final output: {result.FinalOutput}");

 // Inspect each step
 foreach (var step in result.Steps)
 {
 Console.WriteLine($"{step.StepName}: {step.Output}");
 }
}

// Try multiple providers in preferred order
var prompt = new PromptBuilder()
 .WithModels(
 "openai/gpt-4", // Try OpenAI first
 "anthropic/claude-sonnet-4", // Fall back to Anthropic
 "google/gemini-pro" // Finally try Google
 )
 .AddUserMessage("Generate a creative story idea.")
 .Build();

var multiResponse = await aigClient.SendMultiAsync(prompt);

Console.WriteLine($"Received {multiResponse.Responses.Count} responses");
Console.WriteLine($"Time taken: {multiResponse.TotalDurationMs}ms");

// Get the first successful response
if (multiResponse.HasSuccess && multiResponse.FirstSuccess != null)
{
 Console.WriteLine($"Response from: {multiResponse.FirstSuccess.Provider}");
 Console.WriteLine(multiResponse.FirstSuccess.GetTextContent());
}

// Or compare all responses
foreach (var resp in multiResponse.Responses)
{
 var status = resp.IsSuccess() ? "Success" : $"Failed - {resp.Error?.Message}";
 Console.WriteLine($"- {resp.Model}: {status}");
}

var streamingPrompt = new PromptBuilder()
 .WithModel("openai/gpt-4")
 .WithStreaming(true)
 .AddUserMessage("Write a short story about a time traveler.")
 .Build();

Console.Write("Response: ");

// Stream the response as it's generated
await foreach (var chunk in aigClient.SendStreamAsync(streamingPrompt))
{
 if (chunk.IsSuccess())
 {
 var text = chunk.GetTextContent();
 if (!string.IsNullOrEmpty(text))
 {
 Console.Write(text); // Print as it arrives
 }
 }
}

Console.WriteLine();