Metadata-Version: 2.4
Name: dialectus-cli
Version: 0.1.0
Summary: Command-line interface for the Dialectus AI debate system
Author: Dialectus AI
License-Expression: MIT
Project-URL: Homepage, https://github.com/Dialectus-AI/dialectus-cli
Project-URL: Repository, https://github.com/Dialectus-AI/dialectus-cli
Project-URL: Issues, https://github.com/Dialectus-AI/dialectus-cli/issues
Keywords: ai,debate,cli,artificial-intelligence
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Environment :: Console
Requires-Python: >=3.13
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: rich>=14.1.0
Requires-Dist: click>=8.2.1
Requires-Dist: pydantic>=2.11.0
Requires-Dist: dialectus-engine>=0.1.2
Provides-Extra: dev
Requires-Dist: pip-tools>=7.0.0; extra == "dev"
Requires-Dist: pyright>=1.1.0; extra == "dev"
Requires-Dist: ruff>=0.5.0; extra == "dev"
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: twine; extra == "dev"
Requires-Dist: build; extra == "dev"
Dynamic: license-file

# Dialectus CLI

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

## Installation

```bash
pip install dialectus-cli
```

### From Source

```bash
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

```bash
# 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:

```bash
# 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
```bash
dialectus debate
dialectus debate --topic "Should AI be regulated?"
dialectus debate --format oxford
dialectus debate --interactive
```

### List Available Models
```bash
dialectus list-models
```

### View Saved Transcripts
```bash
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

```bash
# 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)
