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.
Files changed (85) hide show
  1. {dialectus_engine-0.3.1/dialectus_engine.egg-info → dialectus_engine-0.4.1}/PKG-INFO +121 -19
  2. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/README.md +120 -18
  3. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/__init__.py +1 -1
  4. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/config/settings.py +65 -3
  5. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/debate_engine/round_manager.py +4 -1
  6. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/formats/base.py +3 -2
  7. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/formats/oxford.py +3 -2
  8. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/formats/parliamentary.py +2 -1
  9. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/formats/public_forum.py +2 -1
  10. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/formats/socratic.py +2 -1
  11. dialectus_engine-0.4.1/dialectus/engine/models/anthropic/__init__.py +15 -0
  12. dialectus_engine-0.4.1/dialectus/engine/models/anthropic/anthropic_enhanced_model_info.py +68 -0
  13. dialectus_engine-0.4.1/dialectus/engine/models/anthropic/anthropic_model.py +101 -0
  14. dialectus_engine-0.4.1/dialectus/engine/models/anthropic/anthropic_model_filter.py +133 -0
  15. dialectus_engine-0.4.1/dialectus/engine/models/anthropic/anthropic_pricing.py +31 -0
  16. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/base_types.py +6 -1
  17. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/manager.py +20 -1
  18. dialectus_engine-0.4.1/dialectus/engine/models/openai/__init__.py +14 -0
  19. dialectus_engine-0.4.1/dialectus/engine/models/openai/openai_enhanced_model_info.py +59 -0
  20. dialectus_engine-0.4.1/dialectus/engine/models/openai/openai_model.py +96 -0
  21. dialectus_engine-0.4.1/dialectus/engine/models/openai/openai_model_filter.py +108 -0
  22. dialectus_engine-0.4.1/dialectus/engine/models/openai/openai_pricing.py +31 -0
  23. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/providers/__init__.py +2 -0
  24. dialectus_engine-0.4.1/dialectus/engine/models/providers/anthropic_provider.py +202 -0
  25. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/providers/ollama_provider.py +62 -56
  26. dialectus_engine-0.4.1/dialectus/engine/models/providers/open_router_provider.py +306 -0
  27. dialectus_engine-0.4.1/dialectus/engine/models/providers/openai_compatible_provider.py +573 -0
  28. dialectus_engine-0.4.1/dialectus/engine/models/providers/openai_provider.py +174 -0
  29. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/providers/providers.py +4 -0
  30. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1/dialectus_engine.egg-info}/PKG-INFO +121 -19
  31. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus_engine.egg-info/SOURCES.txt +26 -0
  32. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/pyproject.toml +1 -1
  33. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/tests/test_config_settings.py +13 -5
  34. dialectus_engine-0.3.1/dialectus/engine/models/providers/open_router_provider.py +0 -795
  35. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/LICENSE +0 -0
  36. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/__init__.py +0 -0
  37. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/config/__init__.py +0 -0
  38. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/config/openrouter_filters.json +0 -0
  39. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/debate_engine/__init__.py +0 -0
  40. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/debate_engine/context_builder.py +0 -0
  41. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/debate_engine/engine.py +0 -0
  42. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/debate_engine/judge_coordinator.py +0 -0
  43. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/debate_engine/models.py +0 -0
  44. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/debate_engine/prompt_builder.py +0 -0
  45. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/debate_engine/response_handler.py +0 -0
  46. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/debate_engine/types.py +0 -0
  47. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/debate_engine/utils.py +0 -0
  48. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/formats/__init__.py +0 -0
  49. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/formats/registry.py +0 -0
  50. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/formats/topic_themes.py +0 -0
  51. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/judges/__init__.py +0 -0
  52. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/judges/ai_judge.py +0 -0
  53. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/judges/base.py +0 -0
  54. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/judges/ensemble_utils.py +0 -0
  55. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/judges/factory.py +0 -0
  56. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/__init__.py +0 -0
  57. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/cache_manager.py +0 -0
  58. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/openrouter/openrouter_architecture.py +0 -0
  59. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/openrouter/openrouter_capability_extractor.py +0 -0
  60. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/openrouter/openrouter_enhanced_model_info.py +0 -0
  61. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/openrouter/openrouter_filter_config.py +0 -0
  62. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/openrouter/openrouter_model.py +0 -0
  63. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/openrouter/openrouter_model_filter.py +0 -0
  64. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/openrouter/openrouter_models_response.py +0 -0
  65. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/openrouter/openrouter_pricing.py +0 -0
  66. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/openrouter/openrouter_top_provider.py +0 -0
  67. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/providers/base_model_provider.py +0 -0
  68. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/providers/exceptions.py +0 -0
  69. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/models/providers/openrouter_generation_types.py +0 -0
  70. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/moderation/__init__.py +0 -0
  71. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/moderation/base_moderator.py +0 -0
  72. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/moderation/exceptions.py +0 -0
  73. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/moderation/llm_moderator.py +0 -0
  74. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/moderation/manager.py +0 -0
  75. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus/engine/moderation/openai_moderator.py +0 -0
  76. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus_engine.egg-info/dependency_links.txt +0 -0
  77. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus_engine.egg-info/requires.txt +0 -0
  78. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/dialectus_engine.egg-info/top_level.txt +0 -0
  79. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/setup.cfg +0 -0
  80. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/tests/test_cache_manager.py +0 -0
  81. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/tests/test_debate_models.py +0 -0
  82. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/tests/test_format_registry.py +0 -0
  83. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/tests/test_formats_base.py +0 -0
  84. {dialectus_engine-0.3.1 → dialectus_engine-0.4.1}/tests/test_judges_factory.py +0 -0
  85. {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.1
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
  ![License](https://img.shields.io/badge/license-MIT-green.svg)
44
44
  ![Status](https://img.shields.io/badge/status-Production%20Ready-brightgreen.svg)
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 debate_engine.core import DebateEngine
127
- from models.manager import ModelManager
128
- from config.settings import AppConfig, ModelConfig
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.from_json_file("debate_config.json")
135
+ config = AppConfig.load_from_file(Path("debate_config.json"))
133
136
 
134
- # Set up model manager
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 OpenRouter (cloud) settings
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 100+ models
277
- - **Async streaming**: Chunk-by-chunk response generation
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
  ![License](https://img.shields.io/badge/license-MIT-green.svg)
11
11
  ![Status](https://img.shields.io/badge/status-Production%20Ready-brightgreen.svg)
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 debate_engine.core import DebateEngine
94
- from models.manager import ModelManager
95
- from config.settings import AppConfig, ModelConfig
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.from_json_file("debate_config.json")
102
+ config = AppConfig.load_from_file(Path("debate_config.json"))
100
103
 
101
- # Set up model manager
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 OpenRouter (cloud) settings
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 100+ models
244
- - **Async streaming**: Chunk-by-chunk response generation
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
+ ```
@@ -4,4 +4,4 @@ from pkgutil import extend_path
4
4
 
5
5
  __path__ = extend_path(__path__, __name__)
6
6
  __all__: list[str] = []
7
- __version__ = "0.3.1"
7
+ __version__ = "0.4.1"
@@ -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(v, {"ollama", "openrouter"})
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(v, {"ollama", "openrouter"})
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",
@@ -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=message.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[dict[str, str]]:
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 message dictionaries for the AI model
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[dict[str, str]]:
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 message dictionaries for the AI model
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[dict[str, str]]:
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[dict[str, str]]:
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[dict[str, str]]:
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
+ ]