Skip to content

AskVerdict/askverdict

Repository files navigation

AskVerdict AI

Multi-agent AI debate engine. Get AI-powered verdicts on any question.

npm npm npm npm License: MIT

Website | Documentation | Get API Key

What is AskVerdict AI?

AskVerdict AI is a multi-agent debate engine that pits multiple AI personas against each other to analyze questions from different perspectives. Instead of getting a single biased answer, you get a structured debate with evidence, cross-examination, and a synthesized verdict.

Quick Start

verdict (BYOK, zero signup)

npx askverdict "Should I use PostgreSQL or MongoDB for my SaaS?"

Uses your own API keys (OpenAI, Anthropic, or Gemini). See packages/verdict for details.

CLI (with AskVerdict account)

npx askverdict "Should I use PostgreSQL or MongoDB for my SaaS?"

SDK

pnpm add @askverdict/sdk
import { AskVerdictClient } from '@askverdict/sdk';

const client = new AskVerdictClient({ apiKey: 'your-api-key' });

const { verdict } = await client.createVerdict({
  question: 'Should I use PostgreSQL or MongoDB for my SaaS?',
  mode: 'balanced',
});

console.log(verdict.verdict.recommendation);

Packages

Package Description Version
verdict BYOK debate CLI (zero signup) npm
@askverdict/sdk TypeScript API client npm
@askverdict/cli Command-line interface npm
@askverdict/types Shared TypeScript types npm

How It Works

  1. Ask a question - Any decision, comparison, or open-ended question
  2. AI agents debate - Multiple specialized personas argue different sides with evidence
  3. Cross-examination - Agents challenge each other's claims
  4. Verdict - A synthesized recommendation with confidence scores and dissenting views

Debate Modes

Mode Agents Rounds Best For
fast 2 1 Quick opinions, simple comparisons
balanced 3 2 Most questions (default)
thorough 4 3 Important decisions, complex topics
analytical 5 4 Deep analysis, research questions

Authentication

Get your API key at askverdict.ai/settings/api.

# CLI
export ASKVERDICT_TOKEN=your-api-key
// SDK
const client = new AskVerdictClient({ apiKey: 'your-api-key' });

Examples

See the examples/ directory for working code samples.

Contributing

We welcome contributions! Please see our contributing guidelines (coming soon).

License

MIT - see LICENSE for details.

About

AskVerdict AI - Multi-agent AI debate engine. SDK, CLI, and types.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors