Delibera — Быстрый старт

ollama pull llama3.2:1b
ollama pull qwen2.5:1.5b
ollama pull nomic-embed-text

ollama pull llama3.2:3b
ollama pull qwen2.5:7b
ollama pull nomic-embed-text

ollama pull llama3.1:8b
ollama pull qwen2.5:14b
ollama pull mistral:7b
ollama pull nomic-embed-text

dotnet add package Delibera.Core

git clone https://github.com/techbuzzz/Delibera.git
cd Delibera

dotnet run --project src/Delibera.Cli -- run "Микросервисы или монолит?" --rounds 3

{
  "Delibera": {
    "Providers": {
      "ollama": {
        "Models": {
          "llama3": { "Endpoint": "http://localhost:11434" },
          "qwen":   { "Endpoint": "http://localhost:11434" }
        }
      }
    },
    "Ollama": { "ApiKey": "" }
  }
}

# Показывать раунды по мере готовности и сохранить результат для машины
delibera run "Выкладываем ли мы в пятницу?" --stream --json --output result.md

# Сравнить два прогона одного вопроса
delibera run "Выкладываем ли мы в пятницу?" --json > baseline.json
delibera run "Выкладываем ли мы в пятницу?" --json > today.json
delibera compare baseline.json today.json --output diff.md

# Повторить вопрос и посмотреть, насколько стабилен ответ
delibera benchmark "Выкладываем ли мы в пятницу?" --iterations 5 --rounds 3

// Program.cs
using Delibera.Core.Council;
using Delibera.Core.Providers;

using var factory = new ProviderFactory();
var ollama = factory.CreateOllama("http://localhost:11434");

var result = await new CouncilBuilder()
    .AddMember("llama3.2:3b", ollama, "Analyst")
    .AddMember("qwen2.5:7b", ollama, "Strategist")
    .SetChairman(Chairman.CreateStandard("qwen2.5:7b", ollama))
    .WithStandardDebate()
    .WithSystemPrompt("You are a software architecture expert.")
    .WithUserPrompt("Microservices vs Monolith for a 5-person startup?")
    .WithMaxRounds(4)
    .SaveResultTo("./deliberation.md")
    .Build()
    .ExecuteAsync();

Console.WriteLine(result.FinalVerdict);

dotnet run

using Delibera.Core.DependencyInjection;
using Microsoft.Extensions.DependencyInjection;

var services = new ServiceCollection();

// Привязывает секцию "Delibera" из appsettings.json
services.AddDelibera(configuration, "Delibera");

var provider = services.BuildServiceProvider();
var builder = provider.GetRequiredService<ICouncilBuilder>();

{
  "Delibera": {
    "Strategy": "Standard",
    "MaxRounds": 4,
    "Temperature": 0.7,
    "SystemPrompt": "You are a knowledgeable AI expert participating in a council debate.",
    "Providers": {
      "DefaultType": "Ollama",
      "DefaultEndpoint": "http://localhost:11434",
      "ApiKey": "",
      "EmbeddingModel": "nomic-embed-text"
    },
    "Compression": {
      "Enabled": true,
      "Strategy": "Hybrid",
      "TargetRatio": 0.5,
      "EnableCache": true,
      "MaxCacheEntries": 256
    },
    "Rag": {
      "Enabled": false,
      "ProviderType": "Qdrant",
      "Host": "localhost",
      "Port": 6334,
      "CollectionName": "council_knowledge",
      "ConnectionString": null
    },
    "Output": {
      "Directory": "./debate_results",
      "SeparateFiles": true,
      "FilePrefix": null
    }
  }
}

using Delibera.Core.Compression;
using Delibera.Core.Providers.LLM;

var ollama = new OllamaProvider("http://localhost:11434");
var embeddings = new OllamaEmbeddingProvider(ollama, "nomic-embed-text");

var result = await new CouncilBuilder()
    .AddMember("llama3.2:3b", ollama, "Analyst")
    .AddMember("qwen2.5:7b", ollama, "Strategist")
    .SetChairman(Chairman.CreateStandard("qwen2.5:7b", ollama))
    .WithCompression(CompressionStrategy.Hybrid,
        llmProvider: ollama,
        modelName: "llama3.2:3b",
        embeddingProvider: embeddings)
    .WithCompressionCache()
    .WithUserPrompt("Analyze our architecture options...")
    .WithMaxRounds(4)
    .Build()
    .ExecuteAsync();

Console.WriteLine(result.TokenStats?.ToSummary());

docker run -d -p 6333:6333 -p 6334:6334 qdrant/qdrant

using Delibera.Core.Council;
using Delibera.Core.Models;
using Delibera.Core.Providers.LLM;
using Delibera.Core.Providers.RAG;

var ollama = new OllamaProvider("http://localhost:11434");
var embeddings = new OllamaEmbeddingProvider(ollama, "nomic-embed-text");

var ragFactory = new VectorStoreFactory();
var rag = ragFactory.CreateQdrant(embeddings, "localhost", 6334);

var kkMember = new CouncilMember("llama3.2:3b", ollama, "Knowledge Keeper");
var keeper = new KnowledgeKeeper(rag, kkMember, "architecture_kb");
await keeper.IndexFileAsync("./docs/architecture.md");

var result = await new CouncilBuilder()
    .AddMember("llama3.2:3b", ollama, "Backend Expert")
    .AddMember("qwen2.5:7b", ollama, "DevOps Expert")
    .SetChairman(Chairman.CreateStandard("qwen2.5:7b", ollama))
    .WithKnowledgeKeeper(keeper)
    .WithStandardDebate()
    .WithUserPrompt("Our startup has 4 developers. Microservices or monolith?")
    .WithMaxRounds(4)
    .Build()
    .ExecuteAsync();

# Проверьте, что Node.js / npx доступны
node --version
npx --version

# Для сервера браузера один раз установите движки Playwright:
npx playwright install

using Delibera.Core.Models;

var servers = new[]
{
    // 🌐 Браузер — навигация, чтение страниц, клики, скриншоты
    McpServerConfig.Stdio(
        name: "browser",
        command: "npx",
        arguments: new[] { "-y", "@playwright/mcp@latest", "--headless" }),

    // 🎯 Marp — генерация презентаций HTML/PDF/PPTX из Markdown
    McpServerConfig.Stdio(
        name: "marp",
        command: "npx",
        arguments: new[] { "-y", "@marp-team/marp-cli", "--server", "./out" }),

    // …или удалённый HTTP/SSE MCP-сервер с заголовками авторизации:
    // McpServerConfig.Http(
    //     name: "remote",
    //     endpoint: "https://my-mcp-host.example.com/mcp",
    //     additionalHeaders: new Dictionary<string, string> { ["Authorization"] = "Bearer <token>" }),
};

using Delibera.Core.Council;
using Delibera.Core.Interfaces;
using Delibera.Core.Models;
using Delibera.Core.Providers.LLM;
using Delibera.Core.Providers.Mcp;

var ollama = new OllamaProvider("http://localhost:11434");

await using var @operator = new Operator(
    new CouncilMember("llama3.2", ollama, "Operator"),
    new IMcpClient[] { new McpClientAdapter(servers[0]), new McpClientAdapter(servers[1]) });

await @operator.InitializeAsync();   // подключается к серверам и обнаруживает инструменты

// 1) Открыть сайт и пересказать его
var browse = await @operator.ExecuteTaskAsync(
    "Open https://modelcontextprotocol.io and briefly summarize what MCP is.");
Console.WriteLine(browse.FinalAnswer);

// 2) Сгенерировать презентацию из 3 слайдов и сохранить как deck.html
var deck = await @operator.ExecuteTaskAsync(
    "Generate a 3-slide Marp presentation about .NET 10 and save it as deck.html.");
Console.WriteLine(deck.FinalAnswer);

var result = await new CouncilBuilder()
    .AddMember("llama3.2:3b", ollama, "Researcher")
    .AddMember("qwen2.5:7b",  ollama, "Reviewer")
    .SetChairman(Chairman.CreateStandard("qwen2.5:7b", ollama))
    // Operator использует свою более дешёвую модель; reuseCompression разделяет компрессор совета
    .WithOperator("llama3.2", ollama, servers, reuseCompression: true)
    .WithStandardDebate()
    .WithSystemPrompt(
        "You may delegate research or presentation tasks to the Operator by writing " +
        "[[OPERATOR: <task>]] in your message.")
    .WithUserPrompt("Research the latest .NET 10 features and prepare a short summary deck.")
    .WithMaxRounds(4)
    .SaveResultTo("./deliberation.md")
    .Build()
    .ExecuteAsync();

Console.WriteLine(result.FinalVerdict);

I think we should highlight the runtime improvements.
[[OPERATOR: open https://learn.microsoft.com/dotnet/core/whats-new/dotnet-10 and list the top 5 features]]

{
  "Delibera": {
    "Operator": {
      "Enabled": true,
      "ModelName": "llama3.2",
      "ReuseCompression": true,
      "McpServers": [
        {
          "Name": "browser",
          "Transport": "Stdio",
          "Command": "npx",
          "Arguments": [ "-y", "@playwright/mcp@latest", "--headless" ]
        },
        {
          "Name": "marp",
          "Transport": "Stdio",
          "Command": "npx",
          "Arguments": [ "-y", "@marp-team/marp-cli", "--server", "./out" ]
        }
      ]
    }
  }
}

var (resultPath, statsPath, logsPath) = await result.SaveAllAsync("./output");
// → debate_<timestamp>_result.md
// → debate_<timestamp>_statistics.md
// → debate_<timestamp>_logs.md

using Delibera.Core.Interfaces;
using Delibera.Core.Tools;

// Привязан к каталогу, отклоняет выход за его пределы, ограничивает чтение 1 МБ по умолчанию
var files = new FileSystemToolProvider("./repo");

// Доступны только эти хосты; обычный HTTP отклоняется, если вы его явно не разрешили
var http = new HttpToolProvider(httpClient, ["docs.example.com", "api.github.com"]);

// Или подключите инструменты MCP-сервера
var mcp = new McpToolProvider(mcpClient);

var result = await new CouncilBuilder()
    .AddMember("qwen2.5:7b", ollama, "Analyst")
    .WithUserPrompt("Что валидирует CouncilBuilder.Build()?")
    .WithTools(files, http)
    .WithMaxToolIterations(5)
    .Build()
    .ExecuteAsync();

foreach (var call in result.ToolCalls)          // и по раундам: round.ToolCalls
{
    Console.WriteLine($"{call.MemberName} → {call.ToolName} ({call.Transport}, {call.Duration})");
}

using Delibera.Core.Cost;

// A money ceiling needs prices: spend only exists once tokens are priced
var pricing = new ModelPricingRegistry("""
[
  { "model": "qwen2.5:7b",   "inputPerMillion": 0.30, "outputPerMillion": 0.40 },
  { "model": "llama3.2:3b",  "inputPerMillion": 0.10, "outputPerMillion": 0.10 }
]
""");

var result = await new CouncilBuilder()
    .WithPricingRegistry(pricing)
    .WithCostLimit(0.50m)                                  // Abort at the ceiling (default)
    .WithRateLimit(20, TimeSpan.FromMinutes(1))             // 20 calls per minute, per model
    // ...
    .Build()
    .ExecuteAsync();

if (result.IsDegraded)
{
    Console.WriteLine($"Stopped early: {result.CostEstimate?.WasTruncated}");
    foreach (var failure in result.FailedMembers) { /* why */ }
}

using Delibera.Core.Debate;

DebateDiff diff = baseline.Diff(today);

Console.WriteLine($"Verdict similarity: {diff.VerdictSimilarity:P0}");
Console.WriteLine($"Verdict changed:   {diff.VerdictChanged}");
Console.WriteLine($"Missing rounds:    {string.Join(", ", diff.MissingRoundNumbers)}");

foreach (var round in diff.Rounds)
{
    foreach (var member in round.Members)
    {
        // word-level, rendered as **added** / ~~removed~~
        Console.WriteLine(member.InlineDiff);
    }
}

await diff.SaveToMarkdownAsync("diff.md");
await diff.SaveToHtmlAsync("diff.html");       // self-contained

builder.Services.AddGrpc();
builder.Services.AddSingleton(sp => new DebateServiceImpl(
    sp.GetRequiredService<IDebateOrchestrator>(),
    () => BuildCouncil(),
    sp.GetRequiredService<ILogger<DebateServiceImpl>>()));

app.MapGrpcService<DebateServiceImpl>();