dialectus-engine 0.3.1__tar.gz → 0.4.1__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {dialectus_engine-0.3.1/dialectus_engine.egg-info → dialectus_engine-0.4.1}/PKG-INFO +121 -19
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/README.md +120 -18
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/__init__.py +1 -1
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/config/settings.py +65 -3
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/debate_engine/round_manager.py +4 -1
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/formats/base.py +3 -2
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/formats/oxford.py +3 -2
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/formats/parliamentary.py +2 -1
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/formats/public_forum.py +2 -1
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/formats/socratic.py +2 -1
- dialectus_engine-0.4.1/dialectus/engine/models/anthropic/__init__.py +15 -0
- dialectus_engine-0.4.1/dialectus/engine/models/anthropic/anthropic_enhanced_model_info.py +68 -0
- dialectus_engine-0.4.1/dialectus/engine/models/anthropic/anthropic_model.py +101 -0
- dialectus_engine-0.4.1/dialectus/engine/models/anthropic/anthropic_model_filter.py +133 -0
- dialectus_engine-0.4.1/dialectus/engine/models/anthropic/anthropic_pricing.py +31 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/base_types.py +6 -1
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/manager.py +20 -1
- dialectus_engine-0.4.1/dialectus/engine/models/openai/__init__.py +14 -0
- dialectus_engine-0.4.1/dialectus/engine/models/openai/openai_enhanced_model_info.py +59 -0
- dialectus_engine-0.4.1/dialectus/engine/models/openai/openai_model.py +96 -0
- dialectus_engine-0.4.1/dialectus/engine/models/openai/openai_model_filter.py +108 -0
- dialectus_engine-0.4.1/dialectus/engine/models/openai/openai_pricing.py +31 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/providers/__init__.py +2 -0
- dialectus_engine-0.4.1/dialectus/engine/models/providers/anthropic_provider.py +202 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/providers/ollama_provider.py +62 -56
- dialectus_engine-0.4.1/dialectus/engine/models/providers/open_router_provider.py +306 -0
- dialectus_engine-0.4.1/dialectus/engine/models/providers/openai_compatible_provider.py +573 -0
- dialectus_engine-0.4.1/dialectus/engine/models/providers/openai_provider.py +174 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/providers/providers.py +4 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1/dialectus_engine.egg-info}/PKG-INFO +121 -19
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus_engine.egg-info/SOURCES.txt +26 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/pyproject.toml +1 -1
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/tests/test_config_settings.py +13 -5
- dialectus_engine-0.3.1/dialectus/engine/models/providers/open_router_provider.py +0 -795
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/LICENSE +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/__init__.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/config/__init__.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/config/openrouter_filters.json +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/debate_engine/__init__.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/debate_engine/context_builder.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/debate_engine/engine.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/debate_engine/judge_coordinator.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/debate_engine/models.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/debate_engine/prompt_builder.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/debate_engine/response_handler.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/debate_engine/types.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/debate_engine/utils.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/formats/__init__.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/formats/registry.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/formats/topic_themes.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/judges/__init__.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/judges/ai_judge.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/judges/base.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/judges/ensemble_utils.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/judges/factory.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/__init__.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/cache_manager.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/openrouter/openrouter_architecture.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/openrouter/openrouter_capability_extractor.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/openrouter/openrouter_enhanced_model_info.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/openrouter/openrouter_filter_config.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/openrouter/openrouter_model.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/openrouter/openrouter_model_filter.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/openrouter/openrouter_models_response.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/openrouter/openrouter_pricing.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/openrouter/openrouter_top_provider.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/providers/base_model_provider.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/providers/exceptions.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/providers/openrouter_generation_types.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/moderation/__init__.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/moderation/base_moderator.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/moderation/exceptions.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/moderation/llm_moderator.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/moderation/manager.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/moderation/openai_moderator.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus_engine.egg-info/dependency_links.txt +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus_engine.egg-info/requires.txt +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus_engine.egg-info/top_level.txt +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/setup.cfg +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/tests/test_cache_manager.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/tests/test_debate_models.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/tests/test_format_registry.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/tests/test_formats_base.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/tests/test_judges_factory.py +0 -0
- {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/tests/test_moderation_openai.py +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: dialectus-engine
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 0.4.1
|
|
4
4
|
Summary: Dialectus AI debate engine framework
|
|
5
5
|
Author: Dialectus AI
|
|
6
6
|
License-Expression: MIT
|
|
@@ -43,6 +43,8 @@ A Python library for orchestrating AI-powered debates with multi-provider model
|
|
|
43
43
|

|
|
44
44
|

|
|
45
45
|
|
|
46
|
+
> **Ready-to-Use CLI:** Want to run debates right away? Check out the [dialectus-cli](https://github.com/dialectus-ai/dialectus-cli) - a command-line interface that uses this engine to run debates locally with a beautiful terminal UI.
|
|
47
|
+
|
|
46
48
|
## Overview
|
|
47
49
|
|
|
48
50
|
The Dialectus Engine is a standalone Python library that provides core debate orchestration logic, including participant coordination, turn management, AI judge integration, and multi-provider model support. It's designed to be imported and used by other applications to build debate systems.
|
|
@@ -50,7 +52,7 @@ The Dialectus Engine is a standalone Python library that provides core debate or
|
|
|
50
52
|
## Components
|
|
51
53
|
|
|
52
54
|
- **Core Engine** (`debate_engine/`) - Main debate orchestration logic
|
|
53
|
-
- **Models** (`models/`) - AI model provider integrations (Ollama, OpenRouter)
|
|
55
|
+
- **Models** (`models/`) - AI model provider integrations (Ollama, OpenRouter, Anthropic)
|
|
54
56
|
- **Configuration** (`config/`) - System configuration management
|
|
55
57
|
- **Judges** (`judges/`) - AI judge implementations with ensemble support
|
|
56
58
|
- **Formats** (`formats/`) - Debate format definitions (Oxford, Parliamentary, Socratic, Public Forum)
|
|
@@ -123,26 +125,20 @@ pip install git+https://github.com/dialectus-ai/dialectus-engine.git@main
|
|
|
123
125
|
|
|
124
126
|
```python
|
|
125
127
|
import asyncio
|
|
126
|
-
from
|
|
127
|
-
from
|
|
128
|
-
from
|
|
128
|
+
from pathlib import Path
|
|
129
|
+
from dialectus.engine.debate_engine import DebateEngine
|
|
130
|
+
from dialectus.engine.models.manager import ModelManager
|
|
131
|
+
from dialectus.engine.config.settings import AppConfig
|
|
129
132
|
|
|
130
133
|
async def run_debate():
|
|
131
134
|
# Load configuration
|
|
132
|
-
config = AppConfig.
|
|
135
|
+
config = AppConfig.load_from_file(Path("debate_config.json"))
|
|
133
136
|
|
|
134
|
-
#
|
|
135
|
-
model_manager = ModelManager()
|
|
136
|
-
|
|
137
|
-
# Register models
|
|
138
|
-
for model_id, model_config in config.models.items():
|
|
139
|
-
model_manager.register_model(model_id, model_config)
|
|
137
|
+
# Create model manager from config
|
|
138
|
+
model_manager = ModelManager.from_config(config)
|
|
140
139
|
|
|
141
140
|
# Create debate engine
|
|
142
|
-
engine = DebateEngine(
|
|
143
|
-
config=config,
|
|
144
|
-
model_manager=model_manager
|
|
145
|
-
)
|
|
141
|
+
engine = DebateEngine(config=config, model_manager=model_manager)
|
|
146
142
|
|
|
147
143
|
# Run debate
|
|
148
144
|
transcript = await engine.run_debate()
|
|
@@ -170,7 +166,7 @@ cp debate_config.example.json debate_config.json
|
|
|
170
166
|
|
|
171
167
|
Key configuration sections:
|
|
172
168
|
- **Models**: Define debate participants with provider, personality, and parameters
|
|
173
|
-
- **Providers**: Configure Ollama (local) and
|
|
169
|
+
- **Providers**: Configure Ollama (local), OpenRouter (cloud), and Anthropic (cloud) settings
|
|
174
170
|
- **Judging**: Set evaluation criteria and judge models
|
|
175
171
|
- **Debate**: Default topic, format, and word limits
|
|
176
172
|
- **Moderation** (optional): Content safety for user-provided topics
|
|
@@ -273,10 +269,12 @@ pip install -e ".[dev]"
|
|
|
273
269
|
|
|
274
270
|
### Multi-Provider Model Support
|
|
275
271
|
- **Ollama**: Local model management with hardware optimization
|
|
276
|
-
- **OpenRouter**: Cloud model access to
|
|
277
|
-
- **
|
|
272
|
+
- **OpenRouter**: Cloud model access to a wide variety of models
|
|
273
|
+
- **Anthropic**: Direct access to Claude models
|
|
274
|
+
- **Async streaming**: Chunk-by-chunk response generation for all providers
|
|
278
275
|
- **Auto-discovery**: Dynamic model listing from all configured providers
|
|
279
276
|
- **Caching**: In-memory cache with TTL for model metadata
|
|
277
|
+
- **Cost tracking**: Token usage and cost calculation for cloud providers
|
|
280
278
|
|
|
281
279
|
### Debate Formats
|
|
282
280
|
- **Oxford**: Classic opening/rebuttal/closing structure
|
|
@@ -375,3 +373,107 @@ except TopicRejectedError as e:
|
|
|
375
373
|
```
|
|
376
374
|
|
|
377
375
|
For comprehensive moderation testing and setup instructions, see [MODERATION_TESTING.md](MODERATION_TESTING.md).
|
|
376
|
+
|
|
377
|
+
## Provider Setup
|
|
378
|
+
|
|
379
|
+
### Anthropic (Claude Models)
|
|
380
|
+
|
|
381
|
+
To use Anthropic's Claude models, you'll need an API key:
|
|
382
|
+
|
|
383
|
+
1. **Get an API key**: Sign up at [console.anthropic.com](https://console.anthropic.com/)
|
|
384
|
+
|
|
385
|
+
2. **Set your API key** (choose one method):
|
|
386
|
+
|
|
387
|
+
**Environment variable (recommended):**
|
|
388
|
+
```bash
|
|
389
|
+
export ANTHROPIC_API_KEY="sk-ant-api03-..."
|
|
390
|
+
```
|
|
391
|
+
|
|
392
|
+
**Or in `debate_config.json`:**
|
|
393
|
+
```json
|
|
394
|
+
{
|
|
395
|
+
"system": {
|
|
396
|
+
"anthropic": {
|
|
397
|
+
"api_key": "sk-ant-api03-...",
|
|
398
|
+
"base_url": "https://api.anthropic.com/v1",
|
|
399
|
+
"max_retries": 3,
|
|
400
|
+
"timeout": 60
|
|
401
|
+
}
|
|
402
|
+
}
|
|
403
|
+
}
|
|
404
|
+
```
|
|
405
|
+
|
|
406
|
+
3. **Configure a model**:
|
|
407
|
+
```json
|
|
408
|
+
{
|
|
409
|
+
"models": {
|
|
410
|
+
"model_a": {
|
|
411
|
+
"name": "claude-3-5-sonnet-20241022",
|
|
412
|
+
"provider": "anthropic",
|
|
413
|
+
"personality": "analytical",
|
|
414
|
+
"max_tokens": 300,
|
|
415
|
+
"temperature": 0.7
|
|
416
|
+
}
|
|
417
|
+
}
|
|
418
|
+
}
|
|
419
|
+
```
|
|
420
|
+
|
|
421
|
+
**Finding available models:**
|
|
422
|
+
|
|
423
|
+
Anthropic provides a `/v1/models` API endpoint to list available models. You can also check [Anthropic's model documentation](https://docs.anthropic.com/en/docs/models-overview) for the latest models and their capabilities.
|
|
424
|
+
|
|
425
|
+
### OpenRouter
|
|
426
|
+
|
|
427
|
+
To use OpenRouter's model marketplace:
|
|
428
|
+
|
|
429
|
+
1. **Get an API key**: Sign up at [openrouter.ai](https://openrouter.ai/)
|
|
430
|
+
|
|
431
|
+
2. **Set your API key**:
|
|
432
|
+
```bash
|
|
433
|
+
export OPENROUTER_API_KEY="sk-or-v1-..."
|
|
434
|
+
```
|
|
435
|
+
|
|
436
|
+
3. **Configure a model**:
|
|
437
|
+
```json
|
|
438
|
+
{
|
|
439
|
+
"models": {
|
|
440
|
+
"model_a": {
|
|
441
|
+
"name": "anthropic/claude-3.5-sonnet",
|
|
442
|
+
"provider": "openrouter",
|
|
443
|
+
"personality": "analytical",
|
|
444
|
+
"max_tokens": 300,
|
|
445
|
+
"temperature": 0.7
|
|
446
|
+
}
|
|
447
|
+
}
|
|
448
|
+
}
|
|
449
|
+
```
|
|
450
|
+
|
|
451
|
+
### Ollama (Local Models)
|
|
452
|
+
|
|
453
|
+
To use local models via Ollama:
|
|
454
|
+
|
|
455
|
+
1. **Install Ollama**: Download from [ollama.com](https://ollama.com/)
|
|
456
|
+
|
|
457
|
+
2. **Pull models**:
|
|
458
|
+
```bash
|
|
459
|
+
ollama pull llama3.2:3b
|
|
460
|
+
ollama pull qwen2.5:7b
|
|
461
|
+
```
|
|
462
|
+
|
|
463
|
+
3. **Configure**:
|
|
464
|
+
```json
|
|
465
|
+
{
|
|
466
|
+
"models": {
|
|
467
|
+
"model_a": {
|
|
468
|
+
"name": "llama3.2:3b",
|
|
469
|
+
"provider": "ollama",
|
|
470
|
+
"personality": "analytical",
|
|
471
|
+
"max_tokens": 300,
|
|
472
|
+
"temperature": 0.7
|
|
473
|
+
}
|
|
474
|
+
},
|
|
475
|
+
"system": {
|
|
476
|
+
"ollama_base_url": "http://localhost:11434"
|
|
477
|
+
}
|
|
478
|
+
}
|
|
479
|
+
```
|
|
@@ -10,6 +10,8 @@ A Python library for orchestrating AI-powered debates with multi-provider model
|
|
|
10
10
|

|
|
11
11
|

|
|
12
12
|
|
|
13
|
+
> **Ready-to-Use CLI:** Want to run debates right away? Check out the [dialectus-cli](https://github.com/dialectus-ai/dialectus-cli) - a command-line interface that uses this engine to run debates locally with a beautiful terminal UI.
|
|
14
|
+
|
|
13
15
|
## Overview
|
|
14
16
|
|
|
15
17
|
The Dialectus Engine is a standalone Python library that provides core debate orchestration logic, including participant coordination, turn management, AI judge integration, and multi-provider model support. It's designed to be imported and used by other applications to build debate systems.
|
|
@@ -17,7 +19,7 @@ The Dialectus Engine is a standalone Python library that provides core debate or
|
|
|
17
19
|
## Components
|
|
18
20
|
|
|
19
21
|
- **Core Engine** (`debate_engine/`) - Main debate orchestration logic
|
|
20
|
-
- **Models** (`models/`) - AI model provider integrations (Ollama, OpenRouter)
|
|
22
|
+
- **Models** (`models/`) - AI model provider integrations (Ollama, OpenRouter, Anthropic)
|
|
21
23
|
- **Configuration** (`config/`) - System configuration management
|
|
22
24
|
- **Judges** (`judges/`) - AI judge implementations with ensemble support
|
|
23
25
|
- **Formats** (`formats/`) - Debate format definitions (Oxford, Parliamentary, Socratic, Public Forum)
|
|
@@ -90,26 +92,20 @@ pip install git+https://github.com/dialectus-ai/dialectus-engine.git@main
|
|
|
90
92
|
|
|
91
93
|
```python
|
|
92
94
|
import asyncio
|
|
93
|
-
from
|
|
94
|
-
from
|
|
95
|
-
from
|
|
95
|
+
from pathlib import Path
|
|
96
|
+
from dialectus.engine.debate_engine import DebateEngine
|
|
97
|
+
from dialectus.engine.models.manager import ModelManager
|
|
98
|
+
from dialectus.engine.config.settings import AppConfig
|
|
96
99
|
|
|
97
100
|
async def run_debate():
|
|
98
101
|
# Load configuration
|
|
99
|
-
config = AppConfig.
|
|
102
|
+
config = AppConfig.load_from_file(Path("debate_config.json"))
|
|
100
103
|
|
|
101
|
-
#
|
|
102
|
-
model_manager = ModelManager()
|
|
103
|
-
|
|
104
|
-
# Register models
|
|
105
|
-
for model_id, model_config in config.models.items():
|
|
106
|
-
model_manager.register_model(model_id, model_config)
|
|
104
|
+
# Create model manager from config
|
|
105
|
+
model_manager = ModelManager.from_config(config)
|
|
107
106
|
|
|
108
107
|
# Create debate engine
|
|
109
|
-
engine = DebateEngine(
|
|
110
|
-
config=config,
|
|
111
|
-
model_manager=model_manager
|
|
112
|
-
)
|
|
108
|
+
engine = DebateEngine(config=config, model_manager=model_manager)
|
|
113
109
|
|
|
114
110
|
# Run debate
|
|
115
111
|
transcript = await engine.run_debate()
|
|
@@ -137,7 +133,7 @@ cp debate_config.example.json debate_config.json
|
|
|
137
133
|
|
|
138
134
|
Key configuration sections:
|
|
139
135
|
- **Models**: Define debate participants with provider, personality, and parameters
|
|
140
|
-
- **Providers**: Configure Ollama (local) and
|
|
136
|
+
- **Providers**: Configure Ollama (local), OpenRouter (cloud), and Anthropic (cloud) settings
|
|
141
137
|
- **Judging**: Set evaluation criteria and judge models
|
|
142
138
|
- **Debate**: Default topic, format, and word limits
|
|
143
139
|
- **Moderation** (optional): Content safety for user-provided topics
|
|
@@ -240,10 +236,12 @@ pip install -e ".[dev]"
|
|
|
240
236
|
|
|
241
237
|
### Multi-Provider Model Support
|
|
242
238
|
- **Ollama**: Local model management with hardware optimization
|
|
243
|
-
- **OpenRouter**: Cloud model access to
|
|
244
|
-
- **
|
|
239
|
+
- **OpenRouter**: Cloud model access to a wide variety of models
|
|
240
|
+
- **Anthropic**: Direct access to Claude models
|
|
241
|
+
- **Async streaming**: Chunk-by-chunk response generation for all providers
|
|
245
242
|
- **Auto-discovery**: Dynamic model listing from all configured providers
|
|
246
243
|
- **Caching**: In-memory cache with TTL for model metadata
|
|
244
|
+
- **Cost tracking**: Token usage and cost calculation for cloud providers
|
|
247
245
|
|
|
248
246
|
### Debate Formats
|
|
249
247
|
- **Oxford**: Classic opening/rebuttal/closing structure
|
|
@@ -342,3 +340,107 @@ except TopicRejectedError as e:
|
|
|
342
340
|
```
|
|
343
341
|
|
|
344
342
|
For comprehensive moderation testing and setup instructions, see [MODERATION_TESTING.md](MODERATION_TESTING.md).
|
|
343
|
+
|
|
344
|
+
## Provider Setup
|
|
345
|
+
|
|
346
|
+
### Anthropic (Claude Models)
|
|
347
|
+
|
|
348
|
+
To use Anthropic's Claude models, you'll need an API key:
|
|
349
|
+
|
|
350
|
+
1. **Get an API key**: Sign up at [console.anthropic.com](https://console.anthropic.com/)
|
|
351
|
+
|
|
352
|
+
2. **Set your API key** (choose one method):
|
|
353
|
+
|
|
354
|
+
**Environment variable (recommended):**
|
|
355
|
+
```bash
|
|
356
|
+
export ANTHROPIC_API_KEY="sk-ant-api03-..."
|
|
357
|
+
```
|
|
358
|
+
|
|
359
|
+
**Or in `debate_config.json`:**
|
|
360
|
+
```json
|
|
361
|
+
{
|
|
362
|
+
"system": {
|
|
363
|
+
"anthropic": {
|
|
364
|
+
"api_key": "sk-ant-api03-...",
|
|
365
|
+
"base_url": "https://api.anthropic.com/v1",
|
|
366
|
+
"max_retries": 3,
|
|
367
|
+
"timeout": 60
|
|
368
|
+
}
|
|
369
|
+
}
|
|
370
|
+
}
|
|
371
|
+
```
|
|
372
|
+
|
|
373
|
+
3. **Configure a model**:
|
|
374
|
+
```json
|
|
375
|
+
{
|
|
376
|
+
"models": {
|
|
377
|
+
"model_a": {
|
|
378
|
+
"name": "claude-3-5-sonnet-20241022",
|
|
379
|
+
"provider": "anthropic",
|
|
380
|
+
"personality": "analytical",
|
|
381
|
+
"max_tokens": 300,
|
|
382
|
+
"temperature": 0.7
|
|
383
|
+
}
|
|
384
|
+
}
|
|
385
|
+
}
|
|
386
|
+
```
|
|
387
|
+
|
|
388
|
+
**Finding available models:**
|
|
389
|
+
|
|
390
|
+
Anthropic provides a `/v1/models` API endpoint to list available models. You can also check [Anthropic's model documentation](https://docs.anthropic.com/en/docs/models-overview) for the latest models and their capabilities.
|
|
391
|
+
|
|
392
|
+
### OpenRouter
|
|
393
|
+
|
|
394
|
+
To use OpenRouter's model marketplace:
|
|
395
|
+
|
|
396
|
+
1. **Get an API key**: Sign up at [openrouter.ai](https://openrouter.ai/)
|
|
397
|
+
|
|
398
|
+
2. **Set your API key**:
|
|
399
|
+
```bash
|
|
400
|
+
export OPENROUTER_API_KEY="sk-or-v1-..."
|
|
401
|
+
```
|
|
402
|
+
|
|
403
|
+
3. **Configure a model**:
|
|
404
|
+
```json
|
|
405
|
+
{
|
|
406
|
+
"models": {
|
|
407
|
+
"model_a": {
|
|
408
|
+
"name": "anthropic/claude-3.5-sonnet",
|
|
409
|
+
"provider": "openrouter",
|
|
410
|
+
"personality": "analytical",
|
|
411
|
+
"max_tokens": 300,
|
|
412
|
+
"temperature": 0.7
|
|
413
|
+
}
|
|
414
|
+
}
|
|
415
|
+
}
|
|
416
|
+
```
|
|
417
|
+
|
|
418
|
+
### Ollama (Local Models)
|
|
419
|
+
|
|
420
|
+
To use local models via Ollama:
|
|
421
|
+
|
|
422
|
+
1. **Install Ollama**: Download from [ollama.com](https://ollama.com/)
|
|
423
|
+
|
|
424
|
+
2. **Pull models**:
|
|
425
|
+
```bash
|
|
426
|
+
ollama pull llama3.2:3b
|
|
427
|
+
ollama pull qwen2.5:7b
|
|
428
|
+
```
|
|
429
|
+
|
|
430
|
+
3. **Configure**:
|
|
431
|
+
```json
|
|
432
|
+
{
|
|
433
|
+
"models": {
|
|
434
|
+
"model_a": {
|
|
435
|
+
"name": "llama3.2:3b",
|
|
436
|
+
"provider": "ollama",
|
|
437
|
+
"personality": "analytical",
|
|
438
|
+
"max_tokens": 300,
|
|
439
|
+
"temperature": 0.7
|
|
440
|
+
}
|
|
441
|
+
},
|
|
442
|
+
"system": {
|
|
443
|
+
"ollama_base_url": "http://localhost:11434"
|
|
444
|
+
}
|
|
445
|
+
}
|
|
446
|
+
```
|
|
@@ -44,7 +44,9 @@ class ModelConfig(BaseModel):
|
|
|
44
44
|
@field_validator("provider")
|
|
45
45
|
@classmethod
|
|
46
46
|
def validate_provider(cls, v: str) -> str:
|
|
47
|
-
return validate_provider_value(
|
|
47
|
+
return validate_provider_value(
|
|
48
|
+
v, {"ollama", "openrouter", "anthropic", "openai"}
|
|
49
|
+
)
|
|
48
50
|
|
|
49
51
|
|
|
50
52
|
class DebateConfig(BaseModel):
|
|
@@ -169,6 +171,42 @@ class OpenRouterConfig(BaseModel):
|
|
|
169
171
|
timeout: int = Field(default=60, description="API request timeout in seconds")
|
|
170
172
|
|
|
171
173
|
|
|
174
|
+
class OpenAIConfig(BaseModel):
|
|
175
|
+
"""OpenAI-specific configuration."""
|
|
176
|
+
|
|
177
|
+
api_key: str | None = Field(
|
|
178
|
+
default=None,
|
|
179
|
+
description=(
|
|
180
|
+
"OpenAI API key (can also be set via OPENAI_API_KEY environment variable)"
|
|
181
|
+
),
|
|
182
|
+
)
|
|
183
|
+
base_url: str = Field(
|
|
184
|
+
default="https://api.openai.com/v1", description="OpenAI API base URL"
|
|
185
|
+
)
|
|
186
|
+
max_retries: int = Field(
|
|
187
|
+
default=3, description="Maximum number of API call retries"
|
|
188
|
+
)
|
|
189
|
+
timeout: int = Field(default=60, description="API request timeout in seconds")
|
|
190
|
+
|
|
191
|
+
|
|
192
|
+
class AnthropicConfig(BaseModel):
|
|
193
|
+
"""Anthropic-specific configuration."""
|
|
194
|
+
|
|
195
|
+
api_key: str | None = Field(
|
|
196
|
+
default=None,
|
|
197
|
+
description=(
|
|
198
|
+
"Anthropic API key (can also be set via ANTHROPIC_API_KEY env var)"
|
|
199
|
+
),
|
|
200
|
+
)
|
|
201
|
+
base_url: str = Field(
|
|
202
|
+
default="https://api.anthropic.com/v1", description="Anthropic API base URL"
|
|
203
|
+
)
|
|
204
|
+
max_retries: int = Field(
|
|
205
|
+
default=3, description="Maximum number of API call retries"
|
|
206
|
+
)
|
|
207
|
+
timeout: int = Field(default=60, description="API request timeout in seconds")
|
|
208
|
+
|
|
209
|
+
|
|
172
210
|
class SystemConfig(BaseModel):
|
|
173
211
|
"""System-wide configuration."""
|
|
174
212
|
|
|
@@ -184,12 +222,18 @@ class SystemConfig(BaseModel):
|
|
|
184
222
|
openrouter: OpenRouterConfig = Field(
|
|
185
223
|
default_factory=OpenRouterConfig, description="OpenRouter-specific settings"
|
|
186
224
|
)
|
|
225
|
+
openai: OpenAIConfig = Field(
|
|
226
|
+
default_factory=OpenAIConfig, description="OpenAI-specific settings"
|
|
227
|
+
)
|
|
228
|
+
anthropic: AnthropicConfig = Field(
|
|
229
|
+
default_factory=AnthropicConfig, description="Anthropic-specific settings"
|
|
230
|
+
)
|
|
187
231
|
|
|
188
232
|
# System settings
|
|
189
233
|
log_level: Literal["DEBUG", "INFO", "WARNING", "ERROR"] = Field(default="INFO")
|
|
190
234
|
|
|
191
235
|
# Topic generation settings
|
|
192
|
-
debate_topic_source: Literal["ollama", "openrouter"] = Field(
|
|
236
|
+
debate_topic_source: Literal["ollama", "openrouter", "anthropic", "openai"] = Field(
|
|
193
237
|
default="openrouter", description="Provider for topic generation model"
|
|
194
238
|
)
|
|
195
239
|
debate_topic_model: str = Field(
|
|
@@ -200,7 +244,9 @@ class SystemConfig(BaseModel):
|
|
|
200
244
|
@field_validator("debate_topic_source")
|
|
201
245
|
@classmethod
|
|
202
246
|
def validate_topic_source(cls, v: str) -> str:
|
|
203
|
-
return validate_provider_value(
|
|
247
|
+
return validate_provider_value(
|
|
248
|
+
v, {"ollama", "openrouter", "anthropic", "openai"}
|
|
249
|
+
)
|
|
204
250
|
|
|
205
251
|
|
|
206
252
|
class AppConfig(BaseModel):
|
|
@@ -326,6 +372,22 @@ def get_template_config() -> AppConfig:
|
|
|
326
372
|
max_retries=3,
|
|
327
373
|
timeout=60,
|
|
328
374
|
),
|
|
375
|
+
openai=OpenAIConfig(
|
|
376
|
+
# Set your OpenAI API key here or use
|
|
377
|
+
# OPENAI_API_KEY env var
|
|
378
|
+
api_key=None,
|
|
379
|
+
base_url="https://api.openai.com/v1",
|
|
380
|
+
max_retries=3,
|
|
381
|
+
timeout=60,
|
|
382
|
+
),
|
|
383
|
+
anthropic=AnthropicConfig(
|
|
384
|
+
# Set your Anthropic API key here or use
|
|
385
|
+
# ANTHROPIC_API_KEY env var
|
|
386
|
+
api_key=None,
|
|
387
|
+
base_url="https://api.anthropic.com/v1",
|
|
388
|
+
max_retries=3,
|
|
389
|
+
timeout=60,
|
|
390
|
+
),
|
|
329
391
|
log_level="INFO",
|
|
330
392
|
debate_topic_source="openrouter",
|
|
331
393
|
debate_topic_model="anthropic/claude-3-haiku",
|
{dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/debate_engine/round_manager.py
RENAMED
|
@@ -154,6 +154,9 @@ class RoundManager:
|
|
|
154
154
|
|
|
155
155
|
# Call message_complete callback
|
|
156
156
|
if message_callback:
|
|
157
|
+
# Convert metadata values to strings for MessageCompleteEventData
|
|
158
|
+
metadata_str = {k: str(v) for k, v in message.metadata.items()}
|
|
159
|
+
|
|
157
160
|
complete_event = MessageCompleteEventData(
|
|
158
161
|
message_id=message_id,
|
|
159
162
|
speaker_id=message.speaker_id,
|
|
@@ -163,7 +166,7 @@ class RoundManager:
|
|
|
163
166
|
content=message.content,
|
|
164
167
|
timestamp=message.timestamp.isoformat(),
|
|
165
168
|
word_count=len(message.content.split()),
|
|
166
|
-
metadata=
|
|
169
|
+
metadata=metadata_str,
|
|
167
170
|
cost=message.cost,
|
|
168
171
|
generation_id=message.generation_id,
|
|
169
172
|
)
|
|
@@ -10,6 +10,7 @@ from dialectus.engine.formats.topic_themes import (
|
|
|
10
10
|
TopicTheme,
|
|
11
11
|
TopicTone,
|
|
12
12
|
)
|
|
13
|
+
from dialectus.engine.models.providers.base_model_provider import ChatMessage
|
|
13
14
|
|
|
14
15
|
|
|
15
16
|
@dataclass
|
|
@@ -114,7 +115,7 @@ class DebateFormat(ABC):
|
|
|
114
115
|
self,
|
|
115
116
|
theme: TopicTheme | None = None,
|
|
116
117
|
tone: TopicTone | None = None,
|
|
117
|
-
) -> list[
|
|
118
|
+
) -> list[ChatMessage]:
|
|
118
119
|
"""Get format-specific messages for AI topic generation.
|
|
119
120
|
|
|
120
121
|
Args:
|
|
@@ -122,7 +123,7 @@ class DebateFormat(ABC):
|
|
|
122
123
|
tone: Optional specific tone/sub-theme for more granular control
|
|
123
124
|
|
|
124
125
|
Returns:
|
|
125
|
-
List of
|
|
126
|
+
List of ChatMessage objects for the AI model
|
|
126
127
|
"""
|
|
127
128
|
# Build the system prompt
|
|
128
129
|
system_content = (
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
"""Oxford-style debate format implementation."""
|
|
2
2
|
|
|
3
3
|
from dialectus.engine.debate_engine.types import DebatePhase
|
|
4
|
+
from dialectus.engine.models.providers.base_model_provider import ChatMessage
|
|
4
5
|
|
|
5
6
|
from .base import DebateFormat, FormatPhase, Position
|
|
6
7
|
from .topic_themes import TopicTheme, TopicTone
|
|
@@ -155,7 +156,7 @@ class OxfordFormat(DebateFormat):
|
|
|
155
156
|
self,
|
|
156
157
|
theme: TopicTheme | None = None,
|
|
157
158
|
tone: TopicTone | None = None,
|
|
158
|
-
) -> list[
|
|
159
|
+
) -> list[ChatMessage]:
|
|
159
160
|
"""Get Oxford specific messages for AI topic generation.
|
|
160
161
|
|
|
161
162
|
Args:
|
|
@@ -163,7 +164,7 @@ class OxfordFormat(DebateFormat):
|
|
|
163
164
|
tone: Optional specific tone/sub-theme for more granular control
|
|
164
165
|
|
|
165
166
|
Returns:
|
|
166
|
-
List of
|
|
167
|
+
List of ChatMessage objects for the AI model
|
|
167
168
|
"""
|
|
168
169
|
# Customize system prompt for Oxford format
|
|
169
170
|
oxford_system = (
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
"""Parliamentary debate format implementation."""
|
|
2
2
|
|
|
3
3
|
from dialectus.engine.debate_engine.types import DebatePhase
|
|
4
|
+
from dialectus.engine.models.providers.base_model_provider import ChatMessage
|
|
4
5
|
|
|
5
6
|
from .base import DebateFormat, FormatPhase, Position
|
|
6
7
|
from .topic_themes import TopicTheme, TopicTone
|
|
@@ -137,7 +138,7 @@ class ParliamentaryFormat(DebateFormat):
|
|
|
137
138
|
self,
|
|
138
139
|
theme: TopicTheme | None = None,
|
|
139
140
|
tone: TopicTone | None = None,
|
|
140
|
-
) -> list[
|
|
141
|
+
) -> list[ChatMessage]:
|
|
141
142
|
"""Get Parliamentary specific messages for AI topic generation.
|
|
142
143
|
|
|
143
144
|
Args:
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
"""Public Forum Debate format implementation."""
|
|
2
2
|
|
|
3
3
|
from dialectus.engine.debate_engine.types import DebatePhase
|
|
4
|
+
from dialectus.engine.models.providers.base_model_provider import ChatMessage
|
|
4
5
|
|
|
5
6
|
from .base import DebateFormat, FormatPhase, Position
|
|
6
7
|
from .topic_themes import TopicTheme, TopicTone
|
|
@@ -173,7 +174,7 @@ class PublicForumFormat(DebateFormat):
|
|
|
173
174
|
self,
|
|
174
175
|
theme: TopicTheme | None = None,
|
|
175
176
|
tone: TopicTone | None = None,
|
|
176
|
-
) -> list[
|
|
177
|
+
) -> list[ChatMessage]:
|
|
177
178
|
"""Get Public Forum specific messages for AI topic generation.
|
|
178
179
|
|
|
179
180
|
Args:
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
"""Socratic dialogue format implementation."""
|
|
2
2
|
|
|
3
3
|
from dialectus.engine.debate_engine.types import DebatePhase
|
|
4
|
+
from dialectus.engine.models.providers.base_model_provider import ChatMessage
|
|
4
5
|
|
|
5
6
|
from .base import DebateFormat, FormatPhase, Position
|
|
6
7
|
from .topic_themes import TopicTheme, TopicTone
|
|
@@ -168,7 +169,7 @@ class SocraticFormat(DebateFormat):
|
|
|
168
169
|
self,
|
|
169
170
|
theme: TopicTheme | None = None,
|
|
170
171
|
tone: TopicTone | None = None,
|
|
171
|
-
) -> list[
|
|
172
|
+
) -> list[ChatMessage]:
|
|
172
173
|
"""Get Socratic specific messages for AI topic generation.
|
|
173
174
|
|
|
174
175
|
Args:
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
"""Anthropic model catalog and metadata."""
|
|
2
|
+
|
|
3
|
+
from __future__ import annotations
|
|
4
|
+
|
|
5
|
+
from .anthropic_enhanced_model_info import AnthropicEnhancedModelInfo
|
|
6
|
+
from .anthropic_model import AnthropicModel
|
|
7
|
+
from .anthropic_model_filter import AnthropicModelFilter
|
|
8
|
+
from .anthropic_pricing import AnthropicPricing
|
|
9
|
+
|
|
10
|
+
__all__ = [
|
|
11
|
+
"AnthropicModel",
|
|
12
|
+
"AnthropicPricing",
|
|
13
|
+
"AnthropicEnhancedModelInfo",
|
|
14
|
+
"AnthropicModelFilter",
|
|
15
|
+
]
|