Cadenza: Ein minimalistisches SDK, das den Nutzen dateibasierter Apps in .NET 10 maximiert

Cadenza ist ein Bundle aus Single-File-Scripting-SDKs für file-based Apps ab .NET 10+. Es ist so konzipiert, dass man direkt Code schreiben und ausführen kann, sobald nur die neueste Version des .NET 10 SDK installiert ist. Zur Einordnung für alle, die damit nicht vertraut sind: In Python lässt sich das in etwa mit der Erfahrung vergleichen, die uv mit PEP 723 bietet.

Bei der Entwicklung mit Cadenza kann man im Wesentlichen eines der folgenden fünf SDK-Typen wählen.

• Cadenza: Konsolen-Skripte, CLI-Utilities
• Cadenza.Worker: Hintergrunddienste, Daemons
• Cadenza.Web: Web-APIs, Minimal-API-Skripte
• Cadenza.Mcp: MCP-Server für Claude / Cursor / VS Code AI-Agenten
• Cadenza.Agent: Lokale AI-Agenten (auf Basis von MEAI)

Es bietet verschiedene Grundfunktionen einschließlich Web-APIs, aber besonders hervorheben möchte ich die Agent-Entwicklung. Um beispielsweise einen benutzerdefinierten AI-Agenten zu erstellen, kann man den folgenden Code schreiben und ausführen. Außerdem gibt es die Möglichkeit, ihn als eigenständige ausführbare Datei oder als Docker-Container-Image zu bauen.

ServedModelName = "custom-codex-agent";  
SystemPrompt("You are a helpful assistant with read-only filesystem access.");  
  
Tool("read_file", "Read a UTF-8 text file from disk",  
    (string path) => ReadText(path));  
  
Tool("list_files", "List files matching a glob pattern (e.g., **/*.cs)",  
    (string pattern) => Glob(pattern).ToArray());  
  
UseOllama("llama3.2");  
  
await Run();  

Und wenn man für den so erstellten AI-Agenten eine separate Konfigurationsdatei wie unten anlegt und über die Umgebungsvariable CODEX_HOME ersetzt, eröffnet sich ein Weg, die Konfiguration des AI-Agenten anzupassen.

model          = "cadenza-codex-openrouter"  
model_provider = "cadenza"  
model_catalog_json = "{catalogPath}"  
  
[model_providers.cadenza]  
name     = "Cadenza.Agent (OpenRouter-backed)"  
base_url = "http://localhost:8080/v1";  
wire_api = "responses"  
env_key  = "CADENZA_API_KEY"  
stream_idle_timeout_ms = 300000  

Außerdem kann man Cadenza-basierte Skripte sofort nutzen, wenn lediglich die grundlegende C#-Erweiterung für VS Code (nicht Dev Kit) oder die grundlegende C#-Erweiterung für andere VS-Code-kompatible Editoren installiert ist. Eine Visual-Studio-Lizenz ist also nicht erforderlich.

Ich würde mich freuen, wenn ihr es ausgiebig ausprobiert und Feedback gebt!