dialectus-cli 0.1.0

Command-line interface for the Dialectus AI debate system

Dialectus CLI

Command-line interface for the Dialectus AI debate system. Run AI debates locally with Ollama or cloud models via OpenRouter.

Installation

pip install dialectus-cli

From Source

git clone https://github.com/Dialectus-AI/dialectus-cli
cd dialectus-cli
pip install -e ".[dev]"

Requirements

• Python 3.13+
• Ollama (if using local models): Running at http://localhost:11434
• OpenRouter API key (if using cloud models): Set via environment variable

Environment Variables

# Linux/macOS
export OPENROUTER_API_KEY="your-key-here"

# Windows PowerShell
$env:OPENROUTER_API_KEY="your-key-here"

# Windows CMD
set OPENROUTER_API_KEY=your-key-here

Quick Start

After installation, the dialectus command is available:

# Copy example config
cp debate_config.example.json debate_config.json

# Edit with your preferred models and API keys
nano debate_config.json  # or your favorite editor

# Run a debate
dialectus debate

Configuration

Edit debate_config.json to configure:

• Models: Debate participants (Ollama or OpenRouter)
• Judging: AI judge models and evaluation criteria
• System: Ollama/OpenRouter settings

Commands

All commands work identically across platforms:

Start a Debate

dialectus debate
dialectus debate --topic "Should AI be regulated?"
dialectus debate --format oxford
dialectus debate --interactive

List Available Models

dialectus list-models

View Saved Transcripts

dialectus transcripts
dialectus transcripts --limit 50

Database

Transcripts are saved to SQLite database at ~/.dialectus/debates.db

Architecture

CLI → DebateRunner → DebateEngine → Rich Console
           ↓
    SQLite Database

• No API layer - Imports engine directly
• Local-first - Runs completely offline with Ollama
• SQLite storage - Simple, portable database

Development

Contributing

# Clone and install in editable mode
git clone https://github.com/Dialectus-AI/dialectus-cli
cd dialectus-cli
pip install -e ".[dev]"

# Type checking
pyright dialectus/

# Build package
python -m build

License

MIT (open source)