Updates docs

Author: thomasmeissnercrm

bluecast/ai/__init__.py

@@ -66,8 +66,10 @@ class BlueCastAI:
 
     :param api_key: API key for the LLM provider.
     :param provider: LLM provider: 'gemini', 'openai', or 'anthropic'.
-    :param model: Provider-specific model name (e.g. 'gpt-4o', 'claude-sonnet-4-20250514').
-        Uses a sensible default per provider if not specified.
+    :param model: Provider-specific model name. Pass the exact string the provider
+        expects (e.g. 'gemini-2.5-pro', 'gpt-4o-mini', 'claude-sonnet-4-20250514').
+        Defaults per provider when not specified:
+        gemini -> 'gemini-2.5-flash', openai -> 'gpt-4o', anthropic -> 'claude-sonnet-4-20250514'.
     :param enable_web_search: Whether agents can search the web for techniques.
     :param verbose: Whether to print progress to stdout.
     :param temperature: LLM temperature (0.0 = deterministic, 1.0 = creative).

bluecast/ai/config.py

@@ -10,7 +10,10 @@ class AIConfig:
 
     :param api_key: API key for the LLM provider.
     :param provider: LLM provider to use.
-    :param model: Provider-specific model name. If None, uses a sensible default.
+    :param model: Provider-specific model name. Pass the exact string the provider
+        expects (e.g. 'gemini-2.5-pro', 'gpt-4o-mini', 'claude-opus-4-20250514').
+        Defaults: gemini -> 'gemini-2.5-flash', openai -> 'gpt-4o',
+        anthropic -> 'claude-sonnet-4-20250514'.
     :param mode: Controls speed vs thoroughness trade-off.
         'fast' = skip FE, 1 iteration, basic config.
         'balanced' = targeted FE, 2-3 iterations.

examples/09_bluecast_ai.py

@@ -235,17 +235,26 @@ def make_credit_data(n=1500, seed=42):
 │  EXAMPLE 8: Choosing your LLM provider                            │
 └─────────────────────────────────────────────────────────────────────┘
 
-    # Google Gemini (default)
+    # Google Gemini (default model: gemini-2.5-flash)
     ai = BlueCastAI(api_key="...", provider="gemini")
 
-    # Specific Gemini model
+    # Choose a specific Gemini model
     ai = BlueCastAI(api_key="...", provider="gemini", model="gemini-2.5-pro")
+    ai = BlueCastAI(api_key="...", provider="gemini", model="gemini-2.0-flash-lite")
 
-    # OpenAI GPT-4o
-    ai = BlueCastAI(api_key="...", provider="openai", model="gpt-4o")
+    # OpenAI (default model: gpt-4o)
+    ai = BlueCastAI(api_key="...", provider="openai")
+    ai = BlueCastAI(api_key="...", provider="openai", model="gpt-4o-mini")
 
-    # Anthropic Claude
-    ai = BlueCastAI(api_key="...", provider="anthropic", model="claude-sonnet-4-20250514")
+    # Anthropic (default model: claude-sonnet-4-20250514)
+    ai = BlueCastAI(api_key="...", provider="anthropic")
+    ai = BlueCastAI(api_key="...", provider="anthropic", model="claude-opus-4-20250514")
+
+    # The model= parameter accepts any model name your provider supports.
+    # When omitted, defaults are:
+    #   gemini    -> gemini-2.5-flash
+    #   openai    -> gpt-4o
+    #   anthropic -> claude-sonnet-4-20250514
 
     # Lower temperature for more deterministic results
     ai = BlueCastAI(api_key="...", provider="gemini", temperature=0.1)