Skip to content

Initial Release

Choose a tag to compare

View all tags
@psarno psarno released this 12 Oct 16:22
· 81 commits to main since this release
v0.1.0
da717da

Dialectus CLI v0.1.0 - Initial Release

First public release of the Dialectus command-line interface for running AI debates locally.

Overview

Dialectus CLI is a lightweight, local-first terminal application that brings AI-powered debates to your command line. Run debates between language models, judge them with AI critics, and save transcripts to a local database - all without needing a backend API.

Key Features

Core Functionality

  • Local AI debates - Run debates completely offline using Ollama models
  • Cloud model support - Use OpenRouter for access to GPT-4, Claude, and other cloud models
  • Multiple debate formats - Oxford, Parliamentary, Socratic, and Public Forum styles
  • AI judging - Evaluate debates with configurable judge models and criteria
  • Rich terminal UI - Beautiful formatted output with tables, panels, and progress indicators
  • SQLite storage - Save and review debate transcripts locally

Commands

  • dialectus debate - Start a debate between AI models
  • dialectus list-models - Show available models from Ollama and OpenRouter
  • dialectus transcripts - View saved debate history

Configuration

  • JSON-based configuration with full validation
  • Supports both Ollama (local) and OpenRouter (cloud) providers
  • Flexible judging criteria and model selection
  • Environment variable support for API keys

Technical Highlights

  • Python 3.13 with modern type annotations
  • Direct engine integration - Imports dialectus-engine library directly
  • Type-safe - Pydantic validation for all configuration
  • Cross-platform - Works on Linux, macOS, and Windows
  • Zero network dependencies - Runs completely offline with Ollama
  • Modern async - Built with async/await throughout

Requirements

  • Python 3.13 or higher
  • Ollama (for local models) or OpenRouter API key (for cloud models)

Installation

pip install dialectus-cli

Quick Start

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

# Edit configuration
nano debate_config.json

# Run a debate
dialectus debate

Links

MIT License - Open source and free to use

Assets 2
Loading