dialectus-engine 0.3.0__tar.gz → 0.4.0__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.0/dialectus_engine.egg-info → dialectus_engine-0.4.0}/PKG-INFO +119 -4
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/README.md +118 -3
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/__init__.py +1 -1
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/config/settings.py +104 -17
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/debate_engine/context_builder.py +11 -7
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/debate_engine/engine.py +8 -11
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/debate_engine/round_manager.py +26 -23
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/debate_engine/types.py +8 -6
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/debate_engine/utils.py +11 -6
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/judges/ai_judge.py +20 -9
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/judges/base.py +32 -43
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/judges/ensemble_utils.py +44 -29
- dialectus_engine-0.4.0/dialectus/engine/models/__init__.py +17 -0
- dialectus_engine-0.4.0/dialectus/engine/models/anthropic/__init__.py +15 -0
- dialectus_engine-0.4.0/dialectus/engine/models/anthropic/anthropic_enhanced_model_info.py +68 -0
- dialectus_engine-0.4.0/dialectus/engine/models/anthropic/anthropic_model.py +101 -0
- dialectus_engine-0.4.0/dialectus/engine/models/anthropic/anthropic_model_filter.py +133 -0
- dialectus_engine-0.4.0/dialectus/engine/models/anthropic/anthropic_pricing.py +31 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/base_types.py +6 -1
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/manager.py +12 -8
- dialectus_engine-0.4.0/dialectus/engine/models/openai/__init__.py +14 -0
- dialectus_engine-0.4.0/dialectus/engine/models/openai/openai_enhanced_model_info.py +59 -0
- dialectus_engine-0.4.0/dialectus/engine/models/openai/openai_model.py +96 -0
- dialectus_engine-0.4.0/dialectus/engine/models/openai/openai_model_filter.py +108 -0
- dialectus_engine-0.4.0/dialectus/engine/models/openai/openai_pricing.py +31 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/openrouter/openrouter_filter_config.py +3 -1
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/providers/__init__.py +2 -0
- dialectus_engine-0.4.0/dialectus/engine/models/providers/anthropic_provider.py +202 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/providers/base_model_provider.py +31 -9
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/providers/ollama_provider.py +66 -60
- dialectus_engine-0.4.0/dialectus/engine/models/providers/open_router_provider.py +306 -0
- dialectus_engine-0.4.0/dialectus/engine/models/providers/openai_compatible_provider.py +573 -0
- dialectus_engine-0.4.0/dialectus/engine/models/providers/openai_provider.py +174 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/providers/openrouter_generation_types.py +44 -3
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/providers/providers.py +4 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/moderation/openai_moderator.py +20 -55
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0/dialectus_engine.egg-info}/PKG-INFO +119 -4
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus_engine.egg-info/SOURCES.txt +26 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/pyproject.toml +2 -1
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/tests/test_config_settings.py +13 -5
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/tests/test_moderation_openai.py +39 -6
- dialectus_engine-0.3.0/dialectus/engine/models/__init__.py +0 -1
- dialectus_engine-0.3.0/dialectus/engine/models/providers/open_router_provider.py +0 -755
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/LICENSE +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/__init__.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/config/__init__.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/config/openrouter_filters.json +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/debate_engine/__init__.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/debate_engine/judge_coordinator.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/debate_engine/models.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/debate_engine/prompt_builder.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/debate_engine/response_handler.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/formats/__init__.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/formats/base.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/formats/oxford.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/formats/parliamentary.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/formats/public_forum.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/formats/registry.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/formats/socratic.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/formats/topic_themes.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/judges/__init__.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/judges/factory.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/cache_manager.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/openrouter/openrouter_architecture.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/openrouter/openrouter_capability_extractor.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/openrouter/openrouter_enhanced_model_info.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/openrouter/openrouter_model.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/openrouter/openrouter_model_filter.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/openrouter/openrouter_models_response.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/openrouter/openrouter_pricing.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/openrouter/openrouter_top_provider.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/models/providers/exceptions.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/moderation/__init__.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/moderation/base_moderator.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/moderation/exceptions.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/moderation/llm_moderator.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/moderation/manager.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus_engine.egg-info/dependency_links.txt +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus_engine.egg-info/requires.txt +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus_engine.egg-info/top_level.txt +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/setup.cfg +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/tests/test_cache_manager.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/tests/test_debate_models.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/tests/test_format_registry.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/tests/test_formats_base.py +0 -0
- {dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/tests/test_judges_factory.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.0
|
|
4
4
|
Summary: Dialectus AI debate engine framework
|
|
5
5
|
Author: Dialectus AI
|
|
6
6
|
License-Expression: MIT
|
|
@@ -43,14 +43,20 @@ 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.
|
|
49
51
|
|
|
52
|
+
**Applications using this engine:**
|
|
53
|
+
- **[dialectus-cli](https://github.com/dialectus-ai/dialectus-cli)** - Command-line interface with Rich terminal UI and SQLite storage
|
|
54
|
+
- **dialectus-web** - Web application with React frontend and FastAPI backend (private repository)
|
|
55
|
+
|
|
50
56
|
## Components
|
|
51
57
|
|
|
52
58
|
- **Core Engine** (`debate_engine/`) - Main debate orchestration logic
|
|
53
|
-
- **Models** (`models/`) - AI model provider integrations (Ollama, OpenRouter)
|
|
59
|
+
- **Models** (`models/`) - AI model provider integrations (Ollama, OpenRouter, Anthropic)
|
|
54
60
|
- **Configuration** (`config/`) - System configuration management
|
|
55
61
|
- **Judges** (`judges/`) - AI judge implementations with ensemble support
|
|
56
62
|
- **Formats** (`formats/`) - Debate format definitions (Oxford, Parliamentary, Socratic, Public Forum)
|
|
@@ -170,7 +176,7 @@ cp debate_config.example.json debate_config.json
|
|
|
170
176
|
|
|
171
177
|
Key configuration sections:
|
|
172
178
|
- **Models**: Define debate participants with provider, personality, and parameters
|
|
173
|
-
- **Providers**: Configure Ollama (local) and
|
|
179
|
+
- **Providers**: Configure Ollama (local), OpenRouter (cloud), and Anthropic (cloud) settings
|
|
174
180
|
- **Judging**: Set evaluation criteria and judge models
|
|
175
181
|
- **Debate**: Default topic, format, and word limits
|
|
176
182
|
- **Moderation** (optional): Content safety for user-provided topics
|
|
@@ -274,9 +280,11 @@ pip install -e ".[dev]"
|
|
|
274
280
|
### Multi-Provider Model Support
|
|
275
281
|
- **Ollama**: Local model management with hardware optimization
|
|
276
282
|
- **OpenRouter**: Cloud model access to 100+ models
|
|
277
|
-
- **
|
|
283
|
+
- **Anthropic**: Direct access to Claude models (3.5 Sonnet, Haiku, Opus, etc.)
|
|
284
|
+
- **Async streaming**: Chunk-by-chunk response generation for all providers
|
|
278
285
|
- **Auto-discovery**: Dynamic model listing from all configured providers
|
|
279
286
|
- **Caching**: In-memory cache with TTL for model metadata
|
|
287
|
+
- **Cost tracking**: Token usage and cost calculation for cloud providers
|
|
280
288
|
|
|
281
289
|
### Debate Formats
|
|
282
290
|
- **Oxford**: Classic opening/rebuttal/closing structure
|
|
@@ -375,3 +383,110 @@ except TopicRejectedError as e:
|
|
|
375
383
|
```
|
|
376
384
|
|
|
377
385
|
For comprehensive moderation testing and setup instructions, see [MODERATION_TESTING.md](MODERATION_TESTING.md).
|
|
386
|
+
|
|
387
|
+
## Provider Setup
|
|
388
|
+
|
|
389
|
+
### Anthropic (Claude Models)
|
|
390
|
+
|
|
391
|
+
To use Anthropic's Claude models, you'll need an API key:
|
|
392
|
+
|
|
393
|
+
1. **Get an API key**: Sign up at [console.anthropic.com](https://console.anthropic.com/)
|
|
394
|
+
|
|
395
|
+
2. **Set your API key** (choose one method):
|
|
396
|
+
|
|
397
|
+
**Environment variable (recommended):**
|
|
398
|
+
```bash
|
|
399
|
+
export ANTHROPIC_API_KEY="sk-ant-api03-..."
|
|
400
|
+
```
|
|
401
|
+
|
|
402
|
+
**Or in `debate_config.json`:**
|
|
403
|
+
```json
|
|
404
|
+
{
|
|
405
|
+
"system": {
|
|
406
|
+
"anthropic": {
|
|
407
|
+
"api_key": "sk-ant-api03-...",
|
|
408
|
+
"base_url": "https://api.anthropic.com/v1",
|
|
409
|
+
"max_retries": 3,
|
|
410
|
+
"timeout": 60
|
|
411
|
+
}
|
|
412
|
+
}
|
|
413
|
+
}
|
|
414
|
+
```
|
|
415
|
+
|
|
416
|
+
3. **Configure a model**:
|
|
417
|
+
```json
|
|
418
|
+
{
|
|
419
|
+
"models": {
|
|
420
|
+
"model_a": {
|
|
421
|
+
"name": "claude-3-5-sonnet-20241022",
|
|
422
|
+
"provider": "anthropic",
|
|
423
|
+
"personality": "analytical",
|
|
424
|
+
"max_tokens": 300,
|
|
425
|
+
"temperature": 0.7
|
|
426
|
+
}
|
|
427
|
+
}
|
|
428
|
+
}
|
|
429
|
+
```
|
|
430
|
+
|
|
431
|
+
**Available Claude models:**
|
|
432
|
+
- `claude-3-5-sonnet-20241022` - Latest, most intelligent (best for debates)
|
|
433
|
+
- `claude-3-5-haiku-20241022` - Fastest and most economical
|
|
434
|
+
- `claude-3-opus-20240229` - Most capable Claude 3 model
|
|
435
|
+
- `claude-3-sonnet-20240229` - Balanced performance
|
|
436
|
+
- `claude-3-haiku-20240307` - Budget-friendly option
|
|
437
|
+
|
|
438
|
+
### OpenRouter
|
|
439
|
+
|
|
440
|
+
To use OpenRouter's model marketplace:
|
|
441
|
+
|
|
442
|
+
1. **Get an API key**: Sign up at [openrouter.ai](https://openrouter.ai/)
|
|
443
|
+
|
|
444
|
+
2. **Set your API key**:
|
|
445
|
+
```bash
|
|
446
|
+
export OPENROUTER_API_KEY="sk-or-v1-..."
|
|
447
|
+
```
|
|
448
|
+
|
|
449
|
+
3. **Configure a model**:
|
|
450
|
+
```json
|
|
451
|
+
{
|
|
452
|
+
"models": {
|
|
453
|
+
"model_a": {
|
|
454
|
+
"name": "anthropic/claude-3.5-sonnet",
|
|
455
|
+
"provider": "openrouter",
|
|
456
|
+
"personality": "analytical",
|
|
457
|
+
"max_tokens": 300,
|
|
458
|
+
"temperature": 0.7
|
|
459
|
+
}
|
|
460
|
+
}
|
|
461
|
+
}
|
|
462
|
+
```
|
|
463
|
+
|
|
464
|
+
### Ollama (Local Models)
|
|
465
|
+
|
|
466
|
+
To use local models via Ollama:
|
|
467
|
+
|
|
468
|
+
1. **Install Ollama**: Download from [ollama.com](https://ollama.com/)
|
|
469
|
+
|
|
470
|
+
2. **Pull models**:
|
|
471
|
+
```bash
|
|
472
|
+
ollama pull llama3.2:3b
|
|
473
|
+
ollama pull qwen2.5:7b
|
|
474
|
+
```
|
|
475
|
+
|
|
476
|
+
3. **Configure**:
|
|
477
|
+
```json
|
|
478
|
+
{
|
|
479
|
+
"models": {
|
|
480
|
+
"model_a": {
|
|
481
|
+
"name": "llama3.2:3b",
|
|
482
|
+
"provider": "ollama",
|
|
483
|
+
"personality": "analytical",
|
|
484
|
+
"max_tokens": 300,
|
|
485
|
+
"temperature": 0.7
|
|
486
|
+
}
|
|
487
|
+
},
|
|
488
|
+
"system": {
|
|
489
|
+
"ollama_base_url": "http://localhost:11434"
|
|
490
|
+
}
|
|
491
|
+
}
|
|
492
|
+
```
|
|
@@ -10,14 +10,20 @@ 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.
|
|
16
18
|
|
|
19
|
+
**Applications using this engine:**
|
|
20
|
+
- **[dialectus-cli](https://github.com/dialectus-ai/dialectus-cli)** - Command-line interface with Rich terminal UI and SQLite storage
|
|
21
|
+
- **dialectus-web** - Web application with React frontend and FastAPI backend (private repository)
|
|
22
|
+
|
|
17
23
|
## Components
|
|
18
24
|
|
|
19
25
|
- **Core Engine** (`debate_engine/`) - Main debate orchestration logic
|
|
20
|
-
- **Models** (`models/`) - AI model provider integrations (Ollama, OpenRouter)
|
|
26
|
+
- **Models** (`models/`) - AI model provider integrations (Ollama, OpenRouter, Anthropic)
|
|
21
27
|
- **Configuration** (`config/`) - System configuration management
|
|
22
28
|
- **Judges** (`judges/`) - AI judge implementations with ensemble support
|
|
23
29
|
- **Formats** (`formats/`) - Debate format definitions (Oxford, Parliamentary, Socratic, Public Forum)
|
|
@@ -137,7 +143,7 @@ cp debate_config.example.json debate_config.json
|
|
|
137
143
|
|
|
138
144
|
Key configuration sections:
|
|
139
145
|
- **Models**: Define debate participants with provider, personality, and parameters
|
|
140
|
-
- **Providers**: Configure Ollama (local) and
|
|
146
|
+
- **Providers**: Configure Ollama (local), OpenRouter (cloud), and Anthropic (cloud) settings
|
|
141
147
|
- **Judging**: Set evaluation criteria and judge models
|
|
142
148
|
- **Debate**: Default topic, format, and word limits
|
|
143
149
|
- **Moderation** (optional): Content safety for user-provided topics
|
|
@@ -241,9 +247,11 @@ pip install -e ".[dev]"
|
|
|
241
247
|
### Multi-Provider Model Support
|
|
242
248
|
- **Ollama**: Local model management with hardware optimization
|
|
243
249
|
- **OpenRouter**: Cloud model access to 100+ models
|
|
244
|
-
- **
|
|
250
|
+
- **Anthropic**: Direct access to Claude models (3.5 Sonnet, Haiku, Opus, etc.)
|
|
251
|
+
- **Async streaming**: Chunk-by-chunk response generation for all providers
|
|
245
252
|
- **Auto-discovery**: Dynamic model listing from all configured providers
|
|
246
253
|
- **Caching**: In-memory cache with TTL for model metadata
|
|
254
|
+
- **Cost tracking**: Token usage and cost calculation for cloud providers
|
|
247
255
|
|
|
248
256
|
### Debate Formats
|
|
249
257
|
- **Oxford**: Classic opening/rebuttal/closing structure
|
|
@@ -342,3 +350,110 @@ except TopicRejectedError as e:
|
|
|
342
350
|
```
|
|
343
351
|
|
|
344
352
|
For comprehensive moderation testing and setup instructions, see [MODERATION_TESTING.md](MODERATION_TESTING.md).
|
|
353
|
+
|
|
354
|
+
## Provider Setup
|
|
355
|
+
|
|
356
|
+
### Anthropic (Claude Models)
|
|
357
|
+
|
|
358
|
+
To use Anthropic's Claude models, you'll need an API key:
|
|
359
|
+
|
|
360
|
+
1. **Get an API key**: Sign up at [console.anthropic.com](https://console.anthropic.com/)
|
|
361
|
+
|
|
362
|
+
2. **Set your API key** (choose one method):
|
|
363
|
+
|
|
364
|
+
**Environment variable (recommended):**
|
|
365
|
+
```bash
|
|
366
|
+
export ANTHROPIC_API_KEY="sk-ant-api03-..."
|
|
367
|
+
```
|
|
368
|
+
|
|
369
|
+
**Or in `debate_config.json`:**
|
|
370
|
+
```json
|
|
371
|
+
{
|
|
372
|
+
"system": {
|
|
373
|
+
"anthropic": {
|
|
374
|
+
"api_key": "sk-ant-api03-...",
|
|
375
|
+
"base_url": "https://api.anthropic.com/v1",
|
|
376
|
+
"max_retries": 3,
|
|
377
|
+
"timeout": 60
|
|
378
|
+
}
|
|
379
|
+
}
|
|
380
|
+
}
|
|
381
|
+
```
|
|
382
|
+
|
|
383
|
+
3. **Configure a model**:
|
|
384
|
+
```json
|
|
385
|
+
{
|
|
386
|
+
"models": {
|
|
387
|
+
"model_a": {
|
|
388
|
+
"name": "claude-3-5-sonnet-20241022",
|
|
389
|
+
"provider": "anthropic",
|
|
390
|
+
"personality": "analytical",
|
|
391
|
+
"max_tokens": 300,
|
|
392
|
+
"temperature": 0.7
|
|
393
|
+
}
|
|
394
|
+
}
|
|
395
|
+
}
|
|
396
|
+
```
|
|
397
|
+
|
|
398
|
+
**Available Claude models:**
|
|
399
|
+
- `claude-3-5-sonnet-20241022` - Latest, most intelligent (best for debates)
|
|
400
|
+
- `claude-3-5-haiku-20241022` - Fastest and most economical
|
|
401
|
+
- `claude-3-opus-20240229` - Most capable Claude 3 model
|
|
402
|
+
- `claude-3-sonnet-20240229` - Balanced performance
|
|
403
|
+
- `claude-3-haiku-20240307` - Budget-friendly option
|
|
404
|
+
|
|
405
|
+
### OpenRouter
|
|
406
|
+
|
|
407
|
+
To use OpenRouter's model marketplace:
|
|
408
|
+
|
|
409
|
+
1. **Get an API key**: Sign up at [openrouter.ai](https://openrouter.ai/)
|
|
410
|
+
|
|
411
|
+
2. **Set your API key**:
|
|
412
|
+
```bash
|
|
413
|
+
export OPENROUTER_API_KEY="sk-or-v1-..."
|
|
414
|
+
```
|
|
415
|
+
|
|
416
|
+
3. **Configure a model**:
|
|
417
|
+
```json
|
|
418
|
+
{
|
|
419
|
+
"models": {
|
|
420
|
+
"model_a": {
|
|
421
|
+
"name": "anthropic/claude-3.5-sonnet",
|
|
422
|
+
"provider": "openrouter",
|
|
423
|
+
"personality": "analytical",
|
|
424
|
+
"max_tokens": 300,
|
|
425
|
+
"temperature": 0.7
|
|
426
|
+
}
|
|
427
|
+
}
|
|
428
|
+
}
|
|
429
|
+
```
|
|
430
|
+
|
|
431
|
+
### Ollama (Local Models)
|
|
432
|
+
|
|
433
|
+
To use local models via Ollama:
|
|
434
|
+
|
|
435
|
+
1. **Install Ollama**: Download from [ollama.com](https://ollama.com/)
|
|
436
|
+
|
|
437
|
+
2. **Pull models**:
|
|
438
|
+
```bash
|
|
439
|
+
ollama pull llama3.2:3b
|
|
440
|
+
ollama pull qwen2.5:7b
|
|
441
|
+
```
|
|
442
|
+
|
|
443
|
+
3. **Configure**:
|
|
444
|
+
```json
|
|
445
|
+
{
|
|
446
|
+
"models": {
|
|
447
|
+
"model_a": {
|
|
448
|
+
"name": "llama3.2:3b",
|
|
449
|
+
"provider": "ollama",
|
|
450
|
+
"personality": "analytical",
|
|
451
|
+
"max_tokens": 300,
|
|
452
|
+
"temperature": 0.7
|
|
453
|
+
}
|
|
454
|
+
},
|
|
455
|
+
"system": {
|
|
456
|
+
"ollama_base_url": "http://localhost:11434"
|
|
457
|
+
}
|
|
458
|
+
}
|
|
459
|
+
```
|
|
@@ -6,6 +6,25 @@ from typing import Literal
|
|
|
6
6
|
from pydantic import BaseModel, Field, field_validator
|
|
7
7
|
|
|
8
8
|
|
|
9
|
+
def validate_provider_value(value: str, valid_providers: set[str]) -> str:
|
|
10
|
+
"""Validate provider string against allowed values.
|
|
11
|
+
|
|
12
|
+
Args:
|
|
13
|
+
value: Provider name to validate
|
|
14
|
+
valid_providers: Set of valid provider names
|
|
15
|
+
|
|
16
|
+
Returns:
|
|
17
|
+
Lowercase provider name
|
|
18
|
+
|
|
19
|
+
Raises:
|
|
20
|
+
ValueError: If provider is not in valid_providers
|
|
21
|
+
"""
|
|
22
|
+
normalized = value.lower()
|
|
23
|
+
if normalized not in valid_providers:
|
|
24
|
+
raise ValueError(f"Provider must be one of: {valid_providers}")
|
|
25
|
+
return normalized
|
|
26
|
+
|
|
27
|
+
|
|
9
28
|
class ModelConfig(BaseModel):
|
|
10
29
|
"""Configuration for a debate model."""
|
|
11
30
|
|
|
@@ -24,11 +43,10 @@ class ModelConfig(BaseModel):
|
|
|
24
43
|
|
|
25
44
|
@field_validator("provider")
|
|
26
45
|
@classmethod
|
|
27
|
-
def validate_provider(cls, v: str):
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
return v
|
|
46
|
+
def validate_provider(cls, v: str) -> str:
|
|
47
|
+
return validate_provider_value(
|
|
48
|
+
v, {"ollama", "openrouter", "anthropic", "openai"}
|
|
49
|
+
)
|
|
32
50
|
|
|
33
51
|
|
|
34
52
|
class DebateConfig(BaseModel):
|
|
@@ -93,9 +111,9 @@ class ModerationConfig(BaseModel):
|
|
|
93
111
|
|
|
94
112
|
@field_validator("provider")
|
|
95
113
|
@classmethod
|
|
96
|
-
def validate_provider(cls, v: str):
|
|
114
|
+
def validate_provider(cls, v: str) -> str:
|
|
97
115
|
# Provider names are case-insensitive
|
|
98
|
-
#
|
|
116
|
+
# For moderation, we accept any provider (ollama, openrouter, openai, custom)
|
|
99
117
|
# Custom providers require explicit base_url
|
|
100
118
|
return v.lower()
|
|
101
119
|
|
|
@@ -153,6 +171,42 @@ class OpenRouterConfig(BaseModel):
|
|
|
153
171
|
timeout: int = Field(default=60, description="API request timeout in seconds")
|
|
154
172
|
|
|
155
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
|
+
|
|
156
210
|
class SystemConfig(BaseModel):
|
|
157
211
|
"""System-wide configuration."""
|
|
158
212
|
|
|
@@ -168,12 +222,18 @@ class SystemConfig(BaseModel):
|
|
|
168
222
|
openrouter: OpenRouterConfig = Field(
|
|
169
223
|
default_factory=OpenRouterConfig, description="OpenRouter-specific settings"
|
|
170
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
|
+
)
|
|
171
231
|
|
|
172
232
|
# System settings
|
|
173
233
|
log_level: Literal["DEBUG", "INFO", "WARNING", "ERROR"] = Field(default="INFO")
|
|
174
234
|
|
|
175
235
|
# Topic generation settings
|
|
176
|
-
debate_topic_source: Literal["ollama", "openrouter"] = Field(
|
|
236
|
+
debate_topic_source: Literal["ollama", "openrouter", "anthropic", "openai"] = Field(
|
|
177
237
|
default="openrouter", description="Provider for topic generation model"
|
|
178
238
|
)
|
|
179
239
|
debate_topic_model: str = Field(
|
|
@@ -183,11 +243,10 @@ class SystemConfig(BaseModel):
|
|
|
183
243
|
|
|
184
244
|
@field_validator("debate_topic_source")
|
|
185
245
|
@classmethod
|
|
186
|
-
def validate_topic_source(cls, v: str):
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
return v
|
|
246
|
+
def validate_topic_source(cls, v: str) -> str:
|
|
247
|
+
return validate_provider_value(
|
|
248
|
+
v, {"ollama", "openrouter", "anthropic", "openai"}
|
|
249
|
+
)
|
|
191
250
|
|
|
192
251
|
|
|
193
252
|
class AppConfig(BaseModel):
|
|
@@ -203,14 +262,26 @@ class AppConfig(BaseModel):
|
|
|
203
262
|
|
|
204
263
|
@classmethod
|
|
205
264
|
def load_from_file(cls, config_path: Path) -> "AppConfig":
|
|
206
|
-
"""Load configuration from JSON file.
|
|
265
|
+
"""Load configuration from JSON file.
|
|
266
|
+
|
|
267
|
+
Args:
|
|
268
|
+
config_path: Path to the JSON configuration file
|
|
269
|
+
|
|
270
|
+
Returns:
|
|
271
|
+
AppConfig instance loaded from the file
|
|
272
|
+
|
|
273
|
+
Raises:
|
|
274
|
+
FileNotFoundError: If config file doesn't exist
|
|
275
|
+
ValueError: If required sections are missing or invalid
|
|
276
|
+
"""
|
|
207
277
|
if not config_path.exists():
|
|
208
278
|
raise FileNotFoundError(f"Config file not found: {config_path}")
|
|
209
279
|
|
|
280
|
+
# Use Pydantic's built-in JSON validation
|
|
210
281
|
import json
|
|
211
282
|
|
|
212
|
-
|
|
213
|
-
|
|
283
|
+
json_data = config_path.read_text(encoding="utf-8")
|
|
284
|
+
data = json.loads(json_data)
|
|
214
285
|
|
|
215
286
|
# Validate required sections
|
|
216
287
|
required_sections = ["debate", "models", "judging", "system"]
|
|
@@ -226,7 +297,7 @@ class AppConfig(BaseModel):
|
|
|
226
297
|
"Config must include at least one model in 'models' section"
|
|
227
298
|
)
|
|
228
299
|
|
|
229
|
-
return cls(
|
|
300
|
+
return cls.model_validate(data)
|
|
230
301
|
|
|
231
302
|
|
|
232
303
|
def get_default_config() -> AppConfig:
|
|
@@ -301,6 +372,22 @@ def get_template_config() -> AppConfig:
|
|
|
301
372
|
max_retries=3,
|
|
302
373
|
timeout=60,
|
|
303
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
|
+
),
|
|
304
391
|
log_level="INFO",
|
|
305
392
|
debate_topic_source="openrouter",
|
|
306
393
|
debate_topic_model="anthropic/claude-3-haiku",
|
{dialectus_engine-0.3.0 → dialectus_engine-0.4.0}/dialectus/engine/debate_engine/context_builder.py
RENAMED
|
@@ -2,9 +2,10 @@
|
|
|
2
2
|
|
|
3
3
|
from __future__ import annotations
|
|
4
4
|
|
|
5
|
-
from typing import TYPE_CHECKING
|
|
5
|
+
from typing import TYPE_CHECKING, cast
|
|
6
6
|
|
|
7
7
|
from dialectus.engine.config.settings import AppConfig
|
|
8
|
+
from dialectus.engine.models.providers.base_model_provider import ChatMessage
|
|
8
9
|
|
|
9
10
|
from .models import DebateContext
|
|
10
11
|
from .prompt_builder import PromptBuilder
|
|
@@ -13,6 +14,9 @@ from .types import DebatePhase
|
|
|
13
14
|
if TYPE_CHECKING:
|
|
14
15
|
from dialectus.engine.formats import DebateFormat, FormatPhase
|
|
15
16
|
|
|
17
|
+
# Maximum number of recent messages to include in conversation context
|
|
18
|
+
MAX_CONTEXT_MESSAGES = 6
|
|
19
|
+
|
|
16
20
|
|
|
17
21
|
class ContextBuilder:
|
|
18
22
|
"""Builds conversation context for model prompts during debates."""
|
|
@@ -39,7 +43,7 @@ class ContextBuilder:
|
|
|
39
43
|
speaker_id: str,
|
|
40
44
|
phase: DebatePhase,
|
|
41
45
|
context: DebateContext,
|
|
42
|
-
) -> list[
|
|
46
|
+
) -> list[ChatMessage]:
|
|
43
47
|
"""Build conversation context for the model.
|
|
44
48
|
|
|
45
49
|
Args:
|
|
@@ -71,7 +75,7 @@ class ContextBuilder:
|
|
|
71
75
|
})
|
|
72
76
|
|
|
73
77
|
# Add relevant debate history
|
|
74
|
-
for msg in context.messages[-
|
|
78
|
+
for msg in context.messages[-MAX_CONTEXT_MESSAGES:]:
|
|
75
79
|
role = "assistant" if msg.speaker_id == speaker_id else "user"
|
|
76
80
|
|
|
77
81
|
# Use a cleaner format that's less likely to be repeated by small
|
|
@@ -94,14 +98,14 @@ class ContextBuilder:
|
|
|
94
98
|
)
|
|
95
99
|
messages.append({"role": "user", "content": turn_prompt})
|
|
96
100
|
|
|
97
|
-
return messages
|
|
101
|
+
return cast(list[ChatMessage], messages)
|
|
98
102
|
|
|
99
103
|
def build_format_conversation_context(
|
|
100
104
|
self,
|
|
101
105
|
speaker_id: str,
|
|
102
106
|
format_phase: FormatPhase,
|
|
103
107
|
context: DebateContext,
|
|
104
|
-
) -> list[
|
|
108
|
+
) -> list[ChatMessage]:
|
|
105
109
|
"""Build conversation context for the model using format phase.
|
|
106
110
|
|
|
107
111
|
Args:
|
|
@@ -139,7 +143,7 @@ class ContextBuilder:
|
|
|
139
143
|
})
|
|
140
144
|
|
|
141
145
|
# Add relevant debate history
|
|
142
|
-
for msg in context.messages[-
|
|
146
|
+
for msg in context.messages[-MAX_CONTEXT_MESSAGES:]:
|
|
143
147
|
role = "assistant" if msg.speaker_id == speaker_id else "user"
|
|
144
148
|
|
|
145
149
|
# Use a cleaner format that's less likely to be repeated by small
|
|
@@ -160,4 +164,4 @@ class ContextBuilder:
|
|
|
160
164
|
turn_prompt = f"Now speak as {role_name}. Stay under {word_limit} words."
|
|
161
165
|
messages.append({"role": "user", "content": turn_prompt})
|
|
162
166
|
|
|
163
|
-
return messages
|
|
167
|
+
return cast(list[ChatMessage], messages)
|
|
@@ -22,6 +22,7 @@ from .types import (
|
|
|
22
22
|
MessageEventCallback,
|
|
23
23
|
PhaseEventCallback,
|
|
24
24
|
PhaseEventType,
|
|
25
|
+
PhaseStartedEventData,
|
|
25
26
|
)
|
|
26
27
|
|
|
27
28
|
logger = logging.getLogger(__name__)
|
|
@@ -169,18 +170,14 @@ class DebateEngine:
|
|
|
169
170
|
|
|
170
171
|
# Invoke phase callback if provided
|
|
171
172
|
if phase_callback:
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
"total_phases": total_phases,
|
|
179
|
-
"progress_percentage": round(
|
|
180
|
-
(phase_index / total_phases) * 100
|
|
181
|
-
),
|
|
182
|
-
},
|
|
173
|
+
phase_event = PhaseStartedEventData(
|
|
174
|
+
phase=format_phase.name,
|
|
175
|
+
instruction=format_phase.instruction,
|
|
176
|
+
current_phase=self.context.current_round,
|
|
177
|
+
total_phases=total_phases,
|
|
178
|
+
progress_percentage=round((phase_index / total_phases) * 100),
|
|
183
179
|
)
|
|
180
|
+
await phase_callback(PhaseEventType.PHASE_STARTED, phase_event)
|
|
184
181
|
|
|
185
182
|
# If streaming callbacks provided, use streaming version
|
|
186
183
|
if message_callback or chunk_callback:
|