abstractcore 2.6.0__py3-none-any.whl → 2.6.3__py3-none-any.whl

abstractcore/apps/judge.py

@@ -178,7 +178,7 @@ def format_assessment_plain(assessment: dict) -> str:
     lines.append(f"Overall Score: {assessment.get('overall_score', 0)}/5")
     lines.append("")
 
-    # Individual scores
+    # Predefined criterion scores
     score_fields = [
         ('clarity_score', 'Clarity'),
         ('simplicity_score', 'Simplicity'),
@@ -191,13 +191,28 @@ def format_assessment_plain(assessment: dict) -> str:
         ('coherence_score', 'Coherence')
     ]
 
-    lines.append("Individual Scores:")
-    lines.append("-" * 20)
-    for field, label in score_fields:
-        score = assessment.get(field)
-        if score is not None:
-            lines.append(f"{label:15}: {score}/5")
-    lines.append("")
+    # Check if any predefined scores exist
+    has_predefined_scores = any(assessment.get(field) is not None for field, _ in score_fields)
+
+    if has_predefined_scores:
+        lines.append("📋 Predefined Criterion Scores:")
+        lines.append("-" * 32)
+        for field, label in score_fields:
+            score = assessment.get(field)
+            if score is not None:
+                lines.append(f"{label:15}: {score}/5")
+        lines.append("")
+
+    # Custom criterion scores
+    custom_scores = assessment.get('custom_scores', {})
+    if custom_scores:
+        lines.append("🎯 Custom Criterion Scores:")
+        lines.append("-" * 28)
+        for criterion, score in custom_scores.items():
+            # Format criterion name nicely
+            criterion_display = criterion.replace('_', ' ').title()
+            lines.append(f"{criterion_display:30}: {score}/5")
+        lines.append("")
 
     # Strengths
     strengths = assessment.get('strengths', [])

abstractcore/config/__init__.py

@@ -7,4 +7,27 @@ Provides configuration management and command-line interface for AbstractCore.
 from .vision_config import handle_vision_commands, add_vision_arguments
 from .manager import get_config_manager
 
-__all__ = ['handle_vision_commands', 'add_vision_arguments', 'get_config_manager']
+
+def configure_provider(provider: str, **kwargs) -> None:
+    """Configure runtime settings for a provider."""
+    get_config_manager().configure_provider(provider, **kwargs)
+
+
+def get_provider_config(provider: str) -> dict:
+    """Get runtime configuration for a provider."""
+    return get_config_manager().get_provider_config(provider)
+
+
+def clear_provider_config(provider: str = None) -> None:
+    """Clear runtime provider configuration."""
+    get_config_manager().clear_provider_config(provider)
+
+
+__all__ = [
+    'handle_vision_commands',
+    'add_vision_arguments',
+    'get_config_manager',
+    'configure_provider',
+    'get_provider_config',
+    'clear_provider_config'
+]

abstractcore/config/manager.py

@@ -136,6 +136,7 @@ class ConfigurationManager:
         self.config_dir = Path.home() / ".abstractcore" / "config"
         self.config_file = self.config_dir / "abstractcore.json"
         self.config = self._load_config()
+        self._provider_config: Dict[str, Dict[str, Any]] = {}  # Runtime config (not persisted)
 
     def _load_config(self) -> AbstractCoreConfig:
         """Load configuration from file or create default."""
@@ -437,6 +438,52 @@ class ConfigurationManager:
         """Check if local_files_only should be forced for transformers."""
         return self.config.offline.force_local_files_only
 
+    def configure_provider(self, provider: str, **kwargs) -> None:
+        """
+        Configure runtime settings for a provider.
+
+        Args:
+            provider: Provider name ('ollama', 'lmstudio', 'openai', 'anthropic')
+            **kwargs: Configuration options (base_url, timeout, etc.)
+
+        Example:
+            configure_provider('ollama', base_url='http://192.168.1.100:11434')
+        """
+        provider = provider.lower()
+        if provider not in self._provider_config:
+            self._provider_config[provider] = {}
+
+        for key, value in kwargs.items():
+            if value is None:
+                # Remove config (revert to env var / default)
+                self._provider_config[provider].pop(key, None)
+            else:
+                self._provider_config[provider][key] = value
+
+    def get_provider_config(self, provider: str) -> Dict[str, Any]:
+        """
+        Get runtime configuration for a provider.
+
+        Args:
+            provider: Provider name
+
+        Returns:
+            Dict with configured settings, or empty dict if no config
+        """
+        return self._provider_config.get(provider.lower(), {}).copy()
+
+    def clear_provider_config(self, provider: Optional[str] = None) -> None:
+        """
+        Clear runtime provider configuration.
+
+        Args:
+            provider: Provider name, or None to clear all
+        """
+        if provider is None:
+            self._provider_config.clear()
+        else:
+            self._provider_config.pop(provider.lower(), None)
+
 
 # Global instance
 _config_manager = None

abstractcore/core/session.py

@@ -939,13 +939,18 @@ class BasicSession:
         summary_tokens = self._estimate_tokens_for_summary(summary_text)
         return original_tokens / summary_tokens if summary_tokens > 0 else 1.0
 
-    def generate_assessment(self, criteria: Optional[Dict[str, bool]] = None) -> Dict[str, Any]:
+    def generate_assessment(
+        self,
+        criteria: Optional[Dict[str, bool]] = None,
+        custom_criteria: Optional[Dict[str, str]] = None
+    ) -> Dict[str, Any]:
         """
         Generate a quality assessment of the entire conversation and store it in session.assessment.
-        
+
         Args:
-            criteria: Optional criteria for assessment
-            
+            criteria: Optional predefined criteria toggles (e.g., {"clarity": True, "coherence": False})
+            custom_criteria: Optional custom domain-specific criteria with descriptions (e.g., {"logical_coherence": "Are results logically consistent?"})
+
         Returns:
             Dict containing the generated assessment
         """
@@ -989,13 +994,27 @@ class BasicSession:
         assessment_result = judge.evaluate(
             content=conversation_text,
             context="conversation quality assessment",
-            criteria=judge_criteria
+            criteria=judge_criteria,
+            custom_criteria=custom_criteria
         )
         
         # Store assessment in session
         self.assessment = {
             "created_at": start_time.isoformat(),
             "criteria": criteria,
+            "custom_criteria": custom_criteria,
+            "scores": {
+                "clarity": assessment_result.get('clarity_score'),
+                "simplicity": assessment_result.get('simplicity_score'),
+                "actionability": assessment_result.get('actionability_score'),
+                "soundness": assessment_result.get('soundness_score'),
+                "innovation": assessment_result.get('innovation_score'),
+                "effectiveness": assessment_result.get('effectiveness_score'),
+                "relevance": assessment_result.get('relevance_score'),
+                "completeness": assessment_result.get('completeness_score'),
+                "coherence": assessment_result.get('coherence_score'),
+            },
+            "custom_scores": assessment_result.get('custom_scores', {}),
             "overall_score": assessment_result.get('overall_score', 0),
             "judge_summary": assessment_result.get('judge_summary', ''),
             "strengths": assessment_result.get('strengths', []),

abstractcore/processing/basic_judge.py

@@ -9,11 +9,11 @@ Features:
 - Clear, simple and actionable feedback
 """
 
-from typing import Optional, List, Dict, Any, Union
+from typing import Optional, List, Dict, Any, Union, Type
 import json
 import logging
 from pathlib import Path
-from pydantic import BaseModel, Field
+from pydantic import BaseModel, Field, create_model
 
 from ..core.interface import AbstractCoreInterface
 from ..core.factory import create_llm
@@ -44,7 +44,7 @@ class Assessment(BaseModel):
     judge_summary: str = Field(..., description="Judge's experiential note summarizing the assessment task and key findings")
     source_reference: str = Field(..., description="Reference to what was assessed (file, content type, context)")
 
-    # Individual criterion scores
+    # Individual criterion scores (predefined criteria)
     clarity_score: Optional[int] = Field(None, description="Clarity score (1-5)")
     simplicity_score: Optional[int] = Field(None, description="Simplicity score (1-5)")
     actionability_score: Optional[int] = Field(None, description="Actionability score (1-5)")
@@ -161,6 +161,30 @@ class BasicJudge:
 
         self.retry_strategy = FeedbackRetry(max_attempts=3)
 
+    def _create_dynamic_assessment_model(self, custom_criteria: Optional[Dict[str, str]]) -> Type[BaseModel]:
+        """Create a dynamic Assessment model with custom score fields"""
+        if not custom_criteria:
+            return Assessment
+
+        # Build fields dict for dynamic model creation
+        fields_dict = {}
+
+        # Add custom score fields dynamically as REQUIRED (not Optional)
+        # This forces the LLM to provide scores for all custom criteria
+        for criterion_name in custom_criteria.keys():
+            field_name = f"{criterion_name}_score"
+            # Make it required (int, not Optional[int]) with Field(...)
+            fields_dict[field_name] = (int, Field(..., description=f"{criterion_name} score (1-5)", ge=1, le=5))
+
+        # Create dynamic model that inherits from Assessment using create_model
+        DynamicAssessment = create_model(
+            'DynamicAssessment',
+            __base__=Assessment,
+            **fields_dict
+        )
+
+        return DynamicAssessment
+
     def evaluate(
         self,
         content: str,
@@ -168,7 +192,8 @@ class BasicJudge:
         criteria: Optional[JudgmentCriteria] = None,
         focus: Optional[str] = None,
         reference: Optional[str] = None,
-        include_criteria: bool = False
+        include_criteria: bool = False,
+        custom_criteria: Optional[Dict[str, str]] = None
     ) -> dict:
         """
         Evaluate content against specified criteria
@@ -180,6 +205,7 @@ class BasicJudge:
             focus: Specific areas to focus evaluation on (e.g., "technical accuracy, performance")
             reference: Optional reference/expected output for comparison
             include_criteria: Include detailed explanation of evaluation criteria in assessment
+            custom_criteria: Custom domain-specific criteria with descriptions (e.g., {"logical_coherence": "Are results logically consistent?"})
 
         Returns:
             dict: Structured assessment result
@@ -196,13 +222,16 @@ class BasicJudge:
         logger.info("Starting evaluation", context=context)
 
         # Build the evaluation prompt
-        prompt = self._build_evaluation_prompt(content, context, criteria, focus, reference, include_criteria)
+        prompt = self._build_evaluation_prompt(content, context, criteria, focus, reference, include_criteria, custom_criteria)
+
+        # Create dynamic assessment model with custom score fields
+        AssessmentModel = self._create_dynamic_assessment_model(custom_criteria)
 
         # Generate structured assessment
         try:
             result = self.llm.generate(
                 prompt,
-                response_model=Assessment,
+                response_model=AssessmentModel,
                 retry_strategy=self.retry_strategy
             )
             
@@ -216,6 +245,19 @@ class BasicJudge:
             # Convert to dict and add metadata
             assessment_dict = result.dict() if hasattr(result, 'dict') else result
 
+            # Extract custom scores from individual fields and add to custom_scores dict
+            if custom_criteria:
+                custom_scores = {}
+                for criterion_name in custom_criteria.keys():
+                    field_name = f"{criterion_name}_score"
+                    if field_name in assessment_dict:
+                        score_value = assessment_dict.pop(field_name)  # Remove individual field
+                        if score_value is not None:
+                            custom_scores[criterion_name] = score_value
+                assessment_dict['custom_scores'] = custom_scores
+            else:
+                assessment_dict['custom_scores'] = {}
+
             # Log results
             overall_score = assessment_dict.get('overall_score', 0)
             logger.info("Evaluation completed", overall_score=overall_score, max_score=5)
@@ -247,7 +289,8 @@ class BasicJudge:
         reference: Optional[str] = None,
         include_criteria: bool = False,
         max_file_size: int = 1000000,  # 1MB default limit per file
-        exclude_global: bool = False  # Include global assessment by default
+        exclude_global: bool = False,  # Include global assessment by default
+        custom_criteria: Optional[Dict[str, str]] = None
     ) -> Union[dict, List[dict]]:
         """
         Evaluate content from one or multiple files sequentially to avoid context overflow
@@ -261,6 +304,7 @@ class BasicJudge:
             include_criteria: Include detailed explanation of evaluation criteria in assessment
             max_file_size: Maximum file size in bytes (default 1MB to avoid context overflow)
             exclude_global: If True, skip global assessment for multiple files (default False)
+            custom_criteria: Custom domain-specific criteria with descriptions (e.g., {"logical_coherence": "Are results logically consistent?"})
 
         Returns:
             dict: Single assessment if one file provided
@@ -360,7 +404,8 @@ class BasicJudge:
                 criteria=criteria,
                 focus=focus,
                 reference=reference,
-                include_criteria=include_criteria
+                include_criteria=include_criteria,
+                custom_criteria=custom_criteria
             )
 
             # Update source reference to include file name
@@ -382,7 +427,7 @@ class BasicJudge:
             # Generate global assessment and return structured result
             logger.info("Generating global assessment from individual file evaluations", file_count=len(assessments))
             global_assessment = self._generate_global_assessment(
-                assessments, context, criteria, focus, include_criteria
+                assessments, context, criteria, focus, include_criteria, custom_criteria
             )
 
             return {
@@ -396,7 +441,8 @@ class BasicJudge:
         context: str,
         criteria: Optional[JudgmentCriteria],
         focus: Optional[str],
-        include_criteria: bool
+        include_criteria: bool,
+        custom_criteria: Optional[Dict[str, str]] = None
     ) -> dict:
         """
         Generate a global assessment from multiple individual file assessments
@@ -475,7 +521,8 @@ Provide a comprehensive global assessment of overall quality and recommendations
                 context=f"global assessment summary for {total_files} files ({context})",
                 criteria=criteria,
                 focus=focus,
-                include_criteria=include_criteria
+                include_criteria=include_criteria,
+                custom_criteria=custom_criteria
             )
 
             # Update the source reference to indicate this is a global assessment
@@ -506,6 +553,19 @@ Provide a comprehensive global assessment of overall quality and recommendations
                 "evaluation_criteria_details": None
             }
 
+    def _build_custom_scores_format(self, custom_criteria: Optional[Dict[str, str]]) -> str:
+        """Build custom score fields for the prompt (individual fields, not dict)"""
+        if not custom_criteria:
+            return ""
+
+        # Build individual score fields for each custom criterion
+        score_fields = []
+        for criterion_name in custom_criteria.keys():
+            field_name = f"{criterion_name}_score"
+            score_fields.append(f'    "{field_name}": <1-5 integer>,')
+
+        return "\n" + "\n".join(score_fields)
+
     def _build_evaluation_prompt(
         self,
         content: str,
@@ -513,7 +573,8 @@ Provide a comprehensive global assessment of overall quality and recommendations
         criteria: JudgmentCriteria,
         focus: Optional[str],
         reference: Optional[str],
-        include_criteria: bool = False
+        include_criteria: bool = False,
+        custom_criteria: Optional[Dict[str, str]] = None
     ) -> str:
         """Build the evaluation prompt with chain-of-thought reasoning"""
 
@@ -565,6 +626,12 @@ Provide a comprehensive global assessment of overall quality and recommendations
                 active_criteria.append(focus_item)
                 criteria_descriptions.append(f"- **{focus_item.title()}**: PRIMARY FOCUS AREA - This is a key evaluation target")
 
+        # Add custom criteria with their specific descriptions
+        if custom_criteria:
+            for name, description in custom_criteria.items():
+                active_criteria.append(name)
+                criteria_descriptions.append(f"- **{name.replace('_', ' ').title()}**: {description}")
+
         criteria_text = "\n".join(criteria_descriptions)
 
         # Build reference section if provided
@@ -613,12 +680,26 @@ SCORING RUBRIC (1-5 scale):
 - **Score 2**: Poor - Falls short of expectations with significant issues
 - **Score 1**: Very Poor - Fails to meet basic standards in this dimension
 
+SCORING PRINCIPLES - CRITICAL:
+- **Be rigorous and avoid grade inflation**: Most adequate responses should be scored 2-3, not 3-4
+- **Context matters**: For routine tasks (e.g., basic arithmetic), criteria like "innovation" should be scored 1-2 unless truly creative
+- **If a criterion doesn't meaningfully apply to the task**, score it 1-2, not 3 (e.g., innovation for standard formula application = 1)
+- **Reserve 4-5 for genuinely excellent work**: Don't give high scores by default
+- **Apply task-appropriate expectations**:
+  * Routine calculations: innovation 1-2, soundness 4-5 (if correct)
+  * Creative explanations: innovation 3-4 if novel approach shown
+  * Complex problem-solving: innovation 4-5 if breakthrough thinking demonstrated
+- **Be appropriately critical**: Question whether the response truly meets each criterion
+
 EVALUATION PROCESS:
 1. **STEP 1**: Carefully analyze the content for each active criterion
-2. **STEP 2**: Identify specific strengths and weaknesses
-3. **STEP 3**: Provide actionable recommendations for improvement
-4. **STEP 4**: Assign scores based on the rubric (be fair but appropriately critical)
-5. **STEP 5**: Calculate overall score - PRIMARY FOCUS AREAS should heavily influence the final score
+2. **STEP 2**: Assess if each criterion meaningfully applies to this task (if not, score 1-2)
+3. **STEP 3**: Identify specific strengths and weaknesses
+4. **STEP 4**: Provide actionable recommendations for improvement
+5. **STEP 5**: Assign scores based on the rubric (be rigorous and appropriately critical)
+   - For standard criteria: populate the corresponding _score fields (e.g., clarity_score, soundness_score)
+   - For custom criteria: populate the custom_scores object with scores for EACH custom criterion listed in EVALUATION CRITERIA
+6. **STEP 6**: Calculate overall score - PRIMARY FOCUS AREAS should heavily influence the final score
 
 CRITICAL ASSESSMENT PRINCIPLES:
 - Be objective and evidence-based in your evaluation
@@ -628,6 +709,11 @@ CRITICAL ASSESSMENT PRINCIPLES:
 - Ensure recommendations are specific and implementable
 - PRIMARY FOCUS AREAS are the most important evaluation targets - weaknesses in these areas should significantly impact the overall score
 
+IMPORTANT - SCORING REQUIREMENTS:
+- You MUST provide individual scores (1-5) for EVERY criterion in the custom_scores object if custom criteria are present
+- Do NOT leave custom_scores as an empty object {{}} - populate it with scores for each custom criterion
+- Each custom criterion listed in EVALUATION CRITERIA must have a corresponding score in custom_scores
+
 RESPONSE FORMAT:
 Provide your assessment as a structured JSON response with the following format:
 
@@ -643,7 +729,7 @@ Provide your assessment as a structured JSON response with the following format:
     "effectiveness_score": <1-5 integer or null if not evaluated>,
     "relevance_score": <1-5 integer or null if not evaluated>,
     "completeness_score": <1-5 integer or null if not evaluated>,
-    "coherence_score": <1-5 integer or null if not evaluated>,
+    "coherence_score": <1-5 integer or null if not evaluated>,{self._build_custom_scores_format(custom_criteria)}
     "strengths": ["list of specific strengths identified"],
     "weaknesses": ["list of specific areas for improvement"],
     "actionable_feedback": ["list of specific actionable recommendations"],

abstractcore/providers/lmstudio_provider.py

@@ -2,6 +2,7 @@
 LM Studio provider implementation (OpenAI-compatible API).
 """
 
+import os
 import httpx
 import json
 import time
@@ -23,14 +24,19 @@ from ..events import EventType
 class LMStudioProvider(BaseProvider):
     """LM Studio provider using OpenAI-compatible API"""
 
-    def __init__(self, model: str = "local-model", base_url: str = "http://localhost:1234/v1", **kwargs):
+    def __init__(self, model: str = "local-model", base_url: Optional[str] = None, **kwargs):
         super().__init__(model, **kwargs)
         self.provider = "lmstudio"
 
         # Initialize tool handler
         self.tool_handler = UniversalToolHandler(model)
 
-        self.base_url = base_url.rstrip('/')
+        # Base URL priority: parameter > LMSTUDIO_BASE_URL > default
+        self.base_url = (
+            base_url or
+            os.getenv("LMSTUDIO_BASE_URL") or
+            "http://localhost:1234/v1"
+        ).rstrip('/')
 
         # Get timeout value - None means unlimited timeout
         timeout_value = getattr(self, '_timeout', None)

abstractcore/providers/ollama_provider.py

@@ -3,6 +3,7 @@ Ollama provider implementation.
 """
 
 import json
+import os
 import httpx
 import time
 from typing import List, Dict, Any, Optional, Union, Iterator, AsyncIterator, Type
@@ -23,11 +24,17 @@ from ..events import EventType
 class OllamaProvider(BaseProvider):
     """Ollama provider for local models with full integration"""
 
-    def __init__(self, model: str = "qwen3:4b-instruct-2507-q4_K_M", base_url: str = "http://localhost:11434", **kwargs):
+    def __init__(self, model: str = "qwen3:4b-instruct-2507-q4_K_M", base_url: Optional[str] = None, **kwargs):
         super().__init__(model, **kwargs)
         self.provider = "ollama"
 
-        self.base_url = base_url.rstrip('/')
+        # Base URL priority: parameter > OLLAMA_BASE_URL > OLLAMA_HOST > default
+        self.base_url = (
+            base_url or
+            os.getenv("OLLAMA_BASE_URL") or
+            os.getenv("OLLAMA_HOST") or
+            "http://localhost:11434"
+        ).rstrip('/')
         self.client = httpx.Client(timeout=self._timeout)
         self._async_client = None  # Lazy-loaded async client
 

abstractcore/providers/registry.py

@@ -354,6 +354,8 @@ class ProviderRegistry:
 
         This is used by the factory to create provider instances.
         """
+        from ..config import get_provider_config
+
         provider_info = self.get_provider_info(provider_name)
         if not provider_info:
             available_providers = ", ".join(self.list_provider_names())
@@ -362,8 +364,14 @@ class ProviderRegistry:
         provider_class = self.get_provider_class(provider_name)
         model = model or provider_info.default_model
 
+        # Get runtime config for this provider
+        runtime_config = get_provider_config(provider_name)
+
+        # Merge: runtime_config < kwargs (user kwargs take precedence)
+        merged_kwargs = {**runtime_config, **kwargs}
+
         try:
-            return provider_class(model=model, **kwargs)
+            return provider_class(model=model, **merged_kwargs)
         except ImportError as e:
             # Re-raise import errors with helpful message
             if provider_info.installation_extras:

abstractcore/utils/version.py

@@ -11,4 +11,4 @@ including when the package is installed from PyPI where pyproject.toml is not av
 
 # Package version - update this when releasing new versions
 # This must be manually synchronized with the version in pyproject.toml
-__version__ = "2.6.0"
+__version__ = "2.6.3"

{abstractcore-2.6.0.dist-info → abstractcore-2.6.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: abstractcore
-Version: 2.6.0
+Version: 2.6.3
 Summary: Unified interface to all LLM providers with essential infrastructure for tool calling, streaming, and model management
 Author-email: Laurent-Philippe Albou <contact@abstractcore.ai>
 Maintainer-email: Laurent-Philippe Albou <contact@abstractcore.ai>
@@ -795,6 +795,66 @@ summarizer document.pdf --provider anthropic --model claude-3-5-sonnet
 
 **Complete guide**: [Centralized Configuration](docs/centralized-config.md)
 
+### Environment Variables
+
+AbstractCore supports environment variables for provider base URLs, enabling remote servers, Docker deployments, and non-standard ports:
+
+```bash
+# Ollama on remote server
+export OLLAMA_BASE_URL="http://192.168.1.100:11434"
+# Alternative: OLLAMA_HOST is also supported
+export OLLAMA_HOST="http://192.168.1.100:11434"
+
+# LMStudio on non-standard port
+export LMSTUDIO_BASE_URL="http://localhost:1235/v1"
+
+# OpenAI-compatible proxy
+export OPENAI_BASE_URL="https://api.portkey.ai/v1"
+
+# Anthropic proxy
+export ANTHROPIC_BASE_URL="https://api.portkey.ai/v1"
+```
+
+**Priority**: Programmatic `base_url` parameter > Runtime configuration > Environment variable > Default value
+
+**Provider discovery**: `get_all_providers_with_models()` automatically respects these environment variables when checking provider availability.
+
+### Programmatic Configuration
+
+Configure provider settings at runtime without environment variables:
+
+```python
+from abstractcore.config import configure_provider, get_provider_config, clear_provider_config
+from abstractcore import create_llm
+
+# Set provider base URL programmatically
+configure_provider('ollama', base_url='http://192.168.1.100:11434')
+
+# All future create_llm() calls automatically use the configured URL
+llm = create_llm('ollama', model='llama3:8b')  # Uses http://192.168.1.100:11434
+
+# Query current configuration
+config = get_provider_config('ollama')
+print(config)  # {'base_url': 'http://192.168.1.100:11434'}
+
+# Clear configuration (revert to env var / default)
+configure_provider('ollama', base_url=None)
+# Or clear all providers
+clear_provider_config()
+```
+
+**Use Cases**:
+- **Web UI Settings**: Configure providers through settings pages
+- **Docker Startup**: Read from custom env vars and configure programmatically
+- **Testing**: Set mock server URLs for integration tests
+- **Multi-tenant**: Configure different base URLs per tenant
+
+**Priority System**:
+1. Constructor parameter (highest): `create_llm("ollama", base_url="...")`
+2. Runtime configuration: `configure_provider('ollama', base_url="...")`
+3. Environment variable: `OLLAMA_BASE_URL`
+4. Default value (lowest): `http://localhost:11434`
+
 ## Documentation
 
 **📚 Complete Documentation:** [docs/](docs/) - Full documentation index and navigation guide

{abstractcore-2.6.0.dist-info → abstractcore-2.6.3.dist-info}/RECORD

@@ -6,7 +6,7 @@ abstractcore/apps/app_config_utils.py,sha256=5GIvXnD996LFIV3-BpfkqII6UqYlStm7ZCg
 abstractcore/apps/deepsearch.py,sha256=UlmuBS9T4yNsz0V_iY08GNNDTstsI5OJNNV6c8CU6AE,23191
 abstractcore/apps/extractor.py,sha256=OfiqB9l_alH9xCGb6zOD__QJkDjdKOlLZngriVgmn7c,23749
 abstractcore/apps/intent.py,sha256=5ie_H9_K_ZxlA0oCu7ROUrsgwfzDNFgVUyBNec6YVRE,22813
-abstractcore/apps/judge.py,sha256=nOgxvn-BbhNY6xU9AlTeD1yidTh73AiVlSN7hQCVE2M,23169
+abstractcore/apps/judge.py,sha256=ZoBRGYjM24TrDALwV7MMDO4Cg2pGPtwRMXX5WyFhdVs,23840
 abstractcore/apps/summarizer.py,sha256=9aD6KH21w-tv_wGp9MaO2uyJuaU71OemW7KpqrG5t6w,14669
 abstractcore/architectures/__init__.py,sha256=-4JucAM7JkMWShWKkePoclxrUHRKgaG36UTguJihE0U,1046
 abstractcore/architectures/detection.py,sha256=jmpD04xcKotWCW7--jadBzCtD2a5dYJi1zljpxB9JmU,19813
@@ -26,16 +26,16 @@ abstractcore/compression/pil_text_renderer.py,sha256=IxVs5ZFXIJeXIQdS1hDQKJC6O2l
 abstractcore/compression/quality.py,sha256=bq7YI_5ywHfPnWSu1MmBRnV5Nxz8KBJGFvnfQOJSx5c,9415
 abstractcore/compression/text_formatter.py,sha256=5RE6JrLkHvYoDQlsYJSoqfbwAa3caMr2i_DXog6ovZs,27328
 abstractcore/compression/vision_compressor.py,sha256=5Ox3w_ee7fgPRDOpSQcooEGtuBKpQoAmWjwpLE2hoNU,12773
-abstractcore/config/__init__.py,sha256=4mHX5z5Sq8R8xh78tb9jjZLaz_oBNW1eh914OsdDTxs,318
+abstractcore/config/__init__.py,sha256=JQ4feacJV_brzf6qNnNPo5VbmXhdjIxH088jYLTp1ik,919
 abstractcore/config/main.py,sha256=oQxnNxo_78CusCuDKGgwal2T3S8MDpo3yzLSB1wpYkU,35573
-abstractcore/config/manager.py,sha256=JTN_qoNqRGKQoPH66nVGn3PIjgt-eSgsG9BndYIC8Dg,16752
+abstractcore/config/manager.py,sha256=O_zuskt4qe9bzaJ2dVoodYWJ3zbakaDu5ocbuGZuCoo,18388
 abstractcore/config/vision_config.py,sha256=jJzO4zBexh8SqSKp6YKOXdMDSv4AL4Ztl5Xi-5c4KyY,17869
 abstractcore/core/__init__.py,sha256=2h-86U4QkCQ4gzZ4iRusSTMlkODiUS6tKjZHiEXz6rM,684
 abstractcore/core/enums.py,sha256=BhkVnHC-X1_377JDmqd-2mnem9GdBLqixWlYzlP_FJU,695
 abstractcore/core/factory.py,sha256=ec7WGW2JKK-dhDplziTAeRkebEUFymtEEZ_bS5qkpqY,2798
 abstractcore/core/interface.py,sha256=-VAY0nlsTnWN_WghiuMC7iE7xUdZfYOg6KlgrAPi14Y,14086
 abstractcore/core/retry.py,sha256=xP38rabBqJImZ-yg60L5mKeg80ATvxmLG5Yp6lCeTpk,14566
-abstractcore/core/session.py,sha256=n9StBlMhSlETlEqQ401PpM8lK0W2ycCP4Zwrywl4Mhs,46147
+abstractcore/core/session.py,sha256=pgiwwgfpgBovwqJ0RkWRsS5TbroTvQEB0jkZnzdhhCY,47278
 abstractcore/core/types.py,sha256=jj44i07kMjdg9FQ3mA_fK6r_M0Lcgt1RQpy1Ra5w-eI,4578
 abstractcore/embeddings/__init__.py,sha256=hR3xZyqcRm4c2pq1dIa5lxj_-Bk70Zad802JQN4joWo,637
 abstractcore/embeddings/manager.py,sha256=bisyQJquM1HLQor8ZAfO9V_XWWHw0b4PjyAz9g7sS-4,52273
@@ -65,18 +65,18 @@ abstractcore/processing/__init__.py,sha256=QcACEnhnHKYCkFL1LNOW_uqBrwkTAmz5A61N4
 abstractcore/processing/basic_deepsearch.py,sha256=dzJQtH4k44XY9tvG0Z4JIlYt_s7HpbLdSPScha-t7vk,101036
 abstractcore/processing/basic_extractor.py,sha256=3x-3BdIHgLvqLnLF6K1-P4qVaLIpAnNIIutaJi7lDQM,49832
 abstractcore/processing/basic_intent.py,sha256=wD99Z7fE2RiYk6oyTZXojUbv-bz8HhKFIuIHYLLTw54,32455
-abstractcore/processing/basic_judge.py,sha256=tKWJrg_tY4vCHzWgXxz0ZjgLXBYYfpMcpG7vl03hJcM,32218
+abstractcore/processing/basic_judge.py,sha256=L1fc9H0-_88B1TULL-mlaNL7OydMgp-ru_zzzoGdr38,37220
 abstractcore/processing/basic_summarizer.py,sha256=XHNxMQ_8aLStTeUo6_2JaThlct12Htpz7ORmm0iuJsg,25495
 abstractcore/providers/__init__.py,sha256=O7gmT4p_jbzMjoZPhi_6RIMHQm-IMFX1XfcgySz3DSQ,1729
 abstractcore/providers/anthropic_provider.py,sha256=0-qZb0Es6-VLuVVl2j7IUjOuyRlgjQdJFulWfpi4qb4,31740
 abstractcore/providers/base.py,sha256=nWF1pxeUlT4ozlUqKG0rWOmLkfo-zQgfU7fv3AUSI08,68452
 abstractcore/providers/huggingface_provider.py,sha256=v4UUmODrnWKtTygzPh-lm4jSCAPms5VYJE5v7PWB4Lo,79458
-abstractcore/providers/lmstudio_provider.py,sha256=e53EF1kyIK4rMRrHZqeE-RfFbxap05iQYWOq_jjxJSk,33935
+abstractcore/providers/lmstudio_provider.py,sha256=92_vx7AVVt_oufJdHo3R0D_V2qyTKO2DKzi9-l4KzWs,34114
 abstractcore/providers/mlx_provider.py,sha256=afLCEwuw7r8OK4fD3OriyKMcWpxVIob_37ItmgAclfc,23123
 abstractcore/providers/model_capabilities.py,sha256=C4HIgvNTp9iIPiDeWyXo7vdzRkMdecRPoQi80yHSOL0,11955
-abstractcore/providers/ollama_provider.py,sha256=FoofSLtevTGxsjjiQw9Q7OWBjp4RJ8JHrFVefPnHyoA,33915
+abstractcore/providers/ollama_provider.py,sha256=Kg5au_tia0xFTXqUlqDNrSvwVpt2lXvfnVFou9K2FGQ,34144
 abstractcore/providers/openai_provider.py,sha256=Y-79mAtgDiDw6SqF2LhnWtlfuC_e6TxeF_tqJWAAyWo,36364
-abstractcore/providers/registry.py,sha256=KG7qjP76Z5t6k5ZsmqoDEbe3A39RJhhvExKPvSKMEms,19442
+abstractcore/providers/registry.py,sha256=z0FVaucJ6KmE6QAIkskH56jV-7hodWgj_G-u5_bcgp0,19732
 abstractcore/providers/streaming.py,sha256=HaGkoItPWXqgml3C-KiPc0hBNpztLzjl_ooECw11BHI,31370
 abstractcore/server/__init__.py,sha256=1DSAz_YhQtnKv7sNi5TMQV8GFujctDOabgvAdilQE0o,249
 abstractcore/server/app.py,sha256=ajG4yfMOHjqBafquLHeLTaMmEr01RXiBRxjFRTIT2j8,96602
@@ -98,11 +98,11 @@ abstractcore/utils/self_fixes.py,sha256=1VYxPq-q7_DtNl39NbrzUmyHpkhb9Q2SdnXUj4c0
 abstractcore/utils/structured_logging.py,sha256=Vm-HviSa42G9DJCWmaEv4a0QG3NMsADD3ictLOs4En0,19952
 abstractcore/utils/token_utils.py,sha256=eLwFmJ68p9WMFD_MHLMmeJRW6Oqx_4hKELB8FNQ2Mnk,21097
 abstractcore/utils/trace_export.py,sha256=MD1DHDWltpewy62cYzz_OSPAA6edZbZq7_pZbvxz_H8,9279
-abstractcore/utils/version.py,sha256=8FvB_bU--hAlMcCZyeDF2i2VlS9p4sYej4VBQOVtRR4,605
+abstractcore/utils/version.py,sha256=MLDRpkxfuzOdSqP9RhPQPGU3g3_lGxn36uZBllC5LY8,605
 abstractcore/utils/vlm_token_calculator.py,sha256=VBmIji_oiqOQ13IvVhNkb8E246tYMIXWVVOnl86Ne94,27978
-abstractcore-2.6.0.dist-info/licenses/LICENSE,sha256=PI2v_4HMvd6050uDD_4AY_8PzBnu2asa3RKbdDjowTA,1078
-abstractcore-2.6.0.dist-info/METADATA,sha256=YuVAqs9CI7NP8wjIsa0W2sXLWpNLOC5JYj_VEqJL2N8,41304
-abstractcore-2.6.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-abstractcore-2.6.0.dist-info/entry_points.txt,sha256=jXNdzeltVs23A2JM2e2HOiAHldHrsnud3EvPI5VffOs,658
-abstractcore-2.6.0.dist-info/top_level.txt,sha256=DiNHBI35SIawW3N9Z-z0y6cQYNbXd32pvBkW0RLfScs,13
-abstractcore-2.6.0.dist-info/RECORD,,
+abstractcore-2.6.3.dist-info/licenses/LICENSE,sha256=PI2v_4HMvd6050uDD_4AY_8PzBnu2asa3RKbdDjowTA,1078
+abstractcore-2.6.3.dist-info/METADATA,sha256=FSrM7xWLPCdW9mtHmMDB8alRirG1oJ4ieCswyDhZXdk,43479
+abstractcore-2.6.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+abstractcore-2.6.3.dist-info/entry_points.txt,sha256=jXNdzeltVs23A2JM2e2HOiAHldHrsnud3EvPI5VffOs,658
+abstractcore-2.6.3.dist-info/top_level.txt,sha256=DiNHBI35SIawW3N9Z-z0y6cQYNbXd32pvBkW0RLfScs,13
+abstractcore-2.6.3.dist-info/RECORD,,