fix interface

.github/README.md

@@ -1,7 +1,16 @@
+
+> [!IMPORTANT]
+> **You are reading the Github README!**
+> 
+> - 📚 **Documentation**: See our [technical documentation](https://deepcritical.github.io/GradioDemo/) for detailed information
+> - 📖 **Demo README**: Check out the [Demo README](..README.md) for setup, configuration, and contribution guidelines
+> - 🏆 **Hackathon Submission**: Keep reading below for more information about our MCP Hackathon submission
+
+
 <div align="center">
 
 [![GitHub](https://img.shields.io/github/stars/DeepCritical/GradioDemo?style=for-the-badge&logo=github&logoColor=white&label=🐙%20GitHub&labelColor=181717&color=181717)](https://github.com/DeepCritical/GradioDemo)
-[![Documentation](https://img.shields.io/badge/📚%20Docs-0080FF?style=for-the-badge&logo=readthedocs&logoColor=white&labelColor=0080FF&color=0080FF)](docs/index.md)
+[![Documentation](https://img.shields.io/badge/Docs-0080FF?style=for-the-badge&logo=readthedocs&logoColor=white&labelColor=0080FF&color=0080FF)](deepcritical.github.io/GradioDemo/)
 [![Demo](https://img.shields.io/badge/🚀%20Demo-FFD21E?style=for-the-badge&logo=huggingface&logoColor=white&labelColor=FFD21E&color=FFD21E)](https://huggingface.co/spaces/DataQuests/DeepCritical)
 [![codecov](https://codecov.io/gh/DeepCritical/GradioDemo/graph/badge.svg?token=B1f05RCGpz)](https://codecov.io/gh/DeepCritical/GradioDemo)
 [![Join us on Discord](https://img.shields.io/discord/1109943800132010065?label=Discord&logo=discord&style=flat-square)](https://discord.gg/qdfnvSPcqP) 
@@ -24,7 +33,7 @@ uv sync --all-extras
 
 ```bash
 # Start the Gradio app
-uv run gradio gradio src/app.py
+gradio run "src/app.py"
 ```
 
 Open your browser to `http://localhost:7860`.

.github/workflows/ci.yml

@@ -44,12 +44,14 @@ jobs:
       - name: Run unit tests (No OpenAI/Anthropic, HuggingFace only)
         env:
           HF_TOKEN: ${{ secrets.HF_TOKEN }}
+          LLM_PROVIDER: huggingface
         run: |
           uv run pytest tests/unit/ -v -m "not openai and not anthropic and not embedding_provider" --tb=short -p no:logfire --cov --cov-branch --cov-report=xml
 
       - name: Run local embeddings tests
         env:
           HF_TOKEN: ${{ secrets.HF_TOKEN }}
+          LLM_PROVIDER: huggingface
         run: |
           uv run pytest tests/ -v -m "local_embeddings" --tb=short -p no:logfire --cov --cov-branch --cov-report=xml --cov-append || true
         continue-on-error: true  # Allow failures if dependencies not available
@@ -57,6 +59,7 @@ jobs:
       - name: Run HuggingFace integration tests
         env:
           HF_TOKEN: ${{ secrets.HF_TOKEN }}
+          LLM_PROVIDER: huggingface
         run: |
           uv run pytest tests/integration/ -v -m "huggingface and not embedding_provider" --tb=short -p no:logfire --cov --cov-branch --cov-report=xml --cov-append || true
         continue-on-error: true  # Allow failures if HF_TOKEN not set
@@ -64,6 +67,7 @@ jobs:
       - name: Run non-OpenAI/Anthropic integration tests (excluding embedding providers)
         env:
           HF_TOKEN: ${{ secrets.HF_TOKEN }}
+          LLM_PROVIDER: huggingface
         run: |
           uv run pytest tests/integration/ -v -m "integration and not openai and not anthropic and not embedding_provider" --tb=short -p no:logfire --cov --cov-branch --cov-report=xml --cov-append || true
         continue-on-error: true  # Allow failures if dependencies not available

README.md

@@ -26,14 +26,14 @@ tags:
 > [!IMPORTANT]
 > **You are reading the Gradio Demo README!**
 > 
-> - 📚 **Documentation**: See our [technical documentation](docs/index.md) for detailed information
+> - 📚 **Documentation**: See our [technical documentation](deepcritical.github.io/GradioDemo/) for detailed information
 > - 📖 **Complete README**: Check out the [full README](.github/README.md) for setup, configuration, and contribution guidelines
 > - 🏆 **Hackathon Submission**: Keep reading below for more information about our MCP Hackathon submission
 
 <div align="center">
 
 [![GitHub](https://img.shields.io/github/stars/DeepCritical/GradioDemo?style=for-the-badge&logo=github&logoColor=white&label=🐙%20GitHub&labelColor=181717&color=181717)](https://github.com/DeepCritical/GradioDemo)
-[![Documentation](https://img.shields.io/badge/📚%20Docs-0080FF?style=for-the-badge&logo=readthedocs&logoColor=white&labelColor=0080FF&color=0080FF)](docs/index.md)
+[![Documentation](https://img.shields.io/badge/📚%20Docs-0080FF?style=for-the-badge&logo=readthedocs&logoColor=white&labelColor=0080FF&color=0080FF)](deepcritical.github.io/GradioDemo/)
 [![Demo](https://img.shields.io/badge/🚀%20Demo-FFD21E?style=for-the-badge&logo=huggingface&logoColor=white&labelColor=FFD21E&color=FFD21E)](https://huggingface.co/spaces/DataQuests/DeepCritical)
 [![codecov](https://codecov.io/gh/DeepCritical/GradioDemo/graph/badge.svg?token=B1f05RCGpz)](https://codecov.io/gh/DeepCritical/GradioDemo)
 [![Join us on Discord](https://img.shields.io/discord/1109943800132010065?label=Discord&logo=discord&style=flat-square)](https://discord.gg/qdfnvSPcqP) 
@@ -63,7 +63,7 @@ For this hackathon we're proposing a simple yet powerful Deep Research Agent tha
 ## Important information
 
 - **[readme](.github\README.md)**: configure, deploy , contribute and learn more here.
-- **[docs]**: want to know how all this works ? read our detailed technical documentation here.
+- **[docs](deepcritical.github.io/GradioDemo/)**: want to know how all this works ? read our detailed technical documentation here.
 - **[demo](https://huggingface/spaces/DataQuests/DeepCritical)**: Try our demo on huggingface
 - **[team](### Team)**: Join us , or follow us !
 - **[video]**: See our demo video
@@ -117,7 +117,7 @@ For this hackathon we're proposing a simple yet powerful Deep Research Agent tha
 ## Links
 
 [![GitHub](https://img.shields.io/github/stars/DeepCritical/GradioDemo?style=for-the-badge&logo=github&logoColor=white&label=🐙%20GitHub&labelColor=181717&color=181717)](https://github.com/DeepCritical/GradioDemo)
-[![Documentation](https://img.shields.io/badge/📚%20Docs-0080FF?style=for-the-badge&logo=readthedocs&logoColor=white&labelColor=0080FF&color=0080FF)](docs/index.md)
+[![Documentation](https://img.shields.io/badge/📚%20Docs-0080FF?style=for-the-badge&logo=readthedocs&logoColor=white&labelColor=0080FF&color=0080FF)](deepcritical.github.io/GradioDemo/)
 [![Demo](https://img.shields.io/badge/🚀%20Demo-FFD21E?style=for-the-badge&logo=huggingface&logoColor=white&labelColor=FFD21E&color=FFD21E)](https://huggingface.co/spaces/DataQuests/DeepCritical)
 [![codecov](https://codecov.io/gh/DeepCritical/GradioDemo/graph/badge.svg?token=B1f05RCGpz)](https://codecov.io/gh/DeepCritical/GradioDemo)
 [![Join us on Discord](https://img.shields.io/discord/1109943800132010065?label=Discord&logo=discord&style=flat-square)](https://discord.gg/qdfnvSPcqP) 

src/agent_factory/judges.py

@@ -54,16 +54,25 @@ def get_model() -> Any:
 
     Explicitly passes API keys from settings to avoid requiring
     users to export environment variables manually.
+    
+    Falls back to HuggingFace if the configured provider's API key is missing,
+    which is important for CI/testing environments.
     """
     llm_provider = settings.llm_provider
 
     if llm_provider == "anthropic":
         if not _ANTHROPIC_AVAILABLE:
-            raise ImportError(
-                "Anthropic models are not available. "
-                "Please install with: uv add 'pydantic-ai[anthropic]' or use 'openai'/'huggingface' as the LLM provider."
-            )
-        return AnthropicModel(settings.anthropic_model, api_key=settings.anthropic_api_key)  # type: ignore[call-arg]
+            logger.warning("Anthropic not available, falling back to HuggingFace")
+        elif settings.anthropic_api_key:
+            return AnthropicModel(settings.anthropic_model, api_key=settings.anthropic_api_key)  # type: ignore[call-arg]
+        else:
+            logger.warning("ANTHROPIC_API_KEY not set, falling back to HuggingFace")
+
+    if llm_provider == "openai":
+        if settings.openai_api_key:
+            return OpenAIModel(settings.openai_model, api_key=settings.openai_api_key)  # type: ignore[call-overload]
+        else:
+            logger.warning("OPENAI_API_KEY not set, falling back to HuggingFace")
 
     if llm_provider == "huggingface":
         if not _HUGGINGFACE_AVAILABLE:
@@ -80,12 +89,9 @@ def get_model() -> Any:
         provider = HuggingFaceProvider(hf_client=hf_client)  # type: ignore[misc]
         return HuggingFaceModel(model_name, provider=provider)  # type: ignore[misc]
 
-    if llm_provider == "openai":
-        return OpenAIModel(settings.openai_model, api_key=settings.openai_api_key)  # type: ignore[call-overload]
-
-    # Default to HuggingFace if provider is unknown or not specified
+    # Default to HuggingFace if provider is unknown or not specified, or if API key is missing
     if llm_provider != "huggingface":
-        logger.warning("Unknown LLM provider, defaulting to HuggingFace", provider=llm_provider)
+        logger.warning("Unknown LLM provider or missing API key, defaulting to HuggingFace", provider=llm_provider)
 
     if not _HUGGINGFACE_AVAILABLE:
         raise ImportError(

src/utils/config.py

@@ -24,7 +24,7 @@ class Settings(BaseSettings):
     openai_api_key: str | None = Field(default=None, description="OpenAI API key")
     anthropic_api_key: str | None = Field(default=None, description="Anthropic API key")
     llm_provider: Literal["openai", "anthropic", "huggingface"] = Field(
-        default="openai", description="Which LLM provider to use"
+        default="huggingface", description="Which LLM provider to use (defaults to HuggingFace for CI/testing)"
     )
     openai_model: str = Field(default="gpt-5.1", description="OpenAI model name")
     anthropic_model: str = Field(

tests/conftest.py

@@ -1,6 +1,7 @@
 """Shared pytest fixtures for all tests."""
 
-from unittest.mock import AsyncMock
+import os
+from unittest.mock import AsyncMock, patch
 
 import pytest
 
@@ -62,3 +63,19 @@ def integration_test_timeout():
     # This fixture runs automatically for all tests
     # Individual tests can override with asyncio.wait_for
     pass
+
+
+@pytest.fixture(autouse=True)
+def default_to_huggingface(monkeypatch):
+    """Ensure tests default to HuggingFace provider unless explicitly overridden.
+    
+    This prevents tests from requiring OpenAI/Anthropic API keys.
+    Tests can override by setting LLM_PROVIDER in their environment or mocking settings.
+    """
+    # Only set if not already set (allows tests to override)
+    if "LLM_PROVIDER" not in os.environ:
+        monkeypatch.setenv("LLM_PROVIDER", "huggingface")
+    
+    # Set a dummy HF_TOKEN if not set (prevents errors, but tests should mock actual API calls)
+    if "HF_TOKEN" not in os.environ:
+        monkeypatch.setenv("HF_TOKEN", "dummy_token_for_testing")

tests/unit/orchestrator/test_graph_orchestrator.py

@@ -210,7 +210,18 @@ class TestGraphOrchestrator:
 
         # Create flow and patch its run method to raise exception
         mock_judge = MagicMock()
-        with patch("src.orchestrator.research_flow.create_judge_handler", return_value=mock_judge):
+        with (
+            patch("src.orchestrator.research_flow.create_judge_handler", return_value=mock_judge),
+            patch("src.orchestrator.research_flow.create_knowledge_gap_agent") as mock_kg,
+            patch("src.orchestrator.research_flow.create_tool_selector_agent") as mock_ts,
+            patch("src.orchestrator.research_flow.create_thinking_agent") as mock_thinking,
+            patch("src.orchestrator.research_flow.create_writer_agent") as mock_writer,
+        ):
+            # Mock all agents to avoid needing API keys
+            mock_kg.return_value = MagicMock()
+            mock_ts.return_value = MagicMock()
+            mock_thinking.return_value = MagicMock()
+            mock_writer.return_value = MagicMock()
             original_flow = IterativeResearchFlow(
                 max_iterations=2,
                 max_time_minutes=5,