flock-core 0.4.3__tar.gz → 0.4.503__tar.gz

{flock_core-0.4.3 → flock_core-0.4.503}/.env_template

@@ -2,9 +2,21 @@
 # Add keys for the providers you use (OpenAI, Anthropic, Gemini, Azure, etc.)
 # Refer to litellm documentation for specific variable names
 OPENAI_API_KEY="your-openai-api-key"
+# AZURE_API_KEY="your-azure-api-key" # For AzureOpenAI
 # ANTHROPIC_API_KEY="your-anthropic-api-key"
 # GOOGLE_API_KEY="your-google-api-key" # For Gemini
 
+# --- LLM Provider Endpoints (Optional) ---
+# Set specific endpoints if you are communicating through a proxy.
+# Or if you need the specific Endpoint for an Azure Deployment for example.
+# Flock uses Litellm under the hood to communicate with
+# different Providers.
+# For specific details see: https://docs.litellm.ai/docs/providers
+# Just Set the required Endpoints as if you were configuring litellm.
+# Example for Azure:
+# AZURE_API_BASE="http://your.deployment.endpoint.azure.com/
+
+
 # --- Default Flock Settings ---
 DEFAULT_MODEL="openai/gpt-4o" # Default LLM used if not specified by Agent/Flock
 

{flock_core-0.4.3 → flock_core-0.4.503}/.github/workflows/deploy-documentation.yml

@@ -2,7 +2,7 @@ name: Deploy MkDocs
 on:
   push:
     branches:
-      - master  # or master
+      - main  # or master
       - docs/*  # or docs/*
 
 jobs:

{flock_core-0.4.3 → flock_core-0.4.503}/.github/workflows/deploy-whiteduck-pypi.yml

@@ -5,7 +5,7 @@ name: Publish Python Package
 on:
   push:
     branches:
-      - master # Replace with your default branch
+      - main # Replace with your default branch
     paths:
       - 'pyproject.toml'  # Only trigger on changes to pyproject.toml (version number)
 

{flock_core-0.4.3 → flock_core-0.4.503}/.vscode/launch.json

@@ -12,7 +12,7 @@
         },
         {
             "name": "Attach to debugpy",
-            "type": "python",
+            "type": "debugpy",
             "subProcess": true,
             "request": "attach",
             "connect": {

{flock_core-0.4.3 → flock_core-0.4.503}/.vscode/settings.json

@@ -16,7 +16,7 @@
     "terminal.integrated.fontFamily": "'Jetbrains Mono', 'FiraCode Nerd Font', 'Hack Nerd Font', 'monospace'",
     "editor.renderWhitespace": "none",
     //"terminal.integrated.lineHeight": 1.5,
-    "editor.fontSize": 15.5,
+    "editor.fontSize": 12,
     "editor.fontLigatures": true,
     "editor.lineHeight": 1.5,
     "editor.minimap.enabled": false,
@@ -90,5 +90,6 @@
         "tag:yaml.org,2002:python/name:pymdownx.superfences.fence_code_format",
         "tag:yaml.org,2002:python/object/apply:pymdownx.slugs.slugify mapping"
     ],
-    "editor.guides.indentation": false
+    "editor.guides.indentation": false,
+    "python.REPL.enableREPLSmartSend": false
 }

{flock_core-0.4.3 → flock_core-0.4.503}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flock-core
-Version: 0.4.3
+Version: 0.4.503
 Summary: Declarative LLM Orchestration at Scale
 Author-email: Andre Ratzenberger <andre.ratzenberger@whiteduck.de>
 License-File: LICENSE
@@ -21,9 +21,9 @@ Requires-Dist: litellm==1.69.3
 Requires-Dist: loguru>=0.7.3
 Requires-Dist: markdown2>=2.5.3
 Requires-Dist: matplotlib>=3.10.0
+Requires-Dist: mcp>=1.7.1
 Requires-Dist: mem0ai[graph]>=0.1.101
 Requires-Dist: msgpack>=1.1.0
-Requires-Dist: notion-client>=2.3.0
 Requires-Dist: openai==1.75.0
 Requires-Dist: opentelemetry-api>=1.30.0
 Requires-Dist: opentelemetry-exporter-jaeger-proto-grpc>=1.21.0
@@ -36,7 +36,7 @@ Requires-Dist: pillow>=10.4.0
 Requires-Dist: prometheus-client>=0.21.1
 Requires-Dist: psutil>=6.1.1
 Requires-Dist: pydantic-settings>=2.7.1
-Requires-Dist: pydantic>=2.10.5
+Requires-Dist: pydantic==2.10.5
 Requires-Dist: python-box>=7.3.2
 Requires-Dist: python-decouple>=3.8
 Requires-Dist: python-dotenv>=1.0.1
@@ -44,8 +44,10 @@ Requires-Dist: python-fasthtml>=0.12.6
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: questionary>=2.1.0
 Requires-Dist: rich>=13.9.4
+Requires-Dist: rouge-score>=0.1.2
 Requires-Dist: sentence-transformers>=3.4.1
 Requires-Dist: temporalio>=1.9.0
+Requires-Dist: thefuzz>=0.22.1
 Requires-Dist: tiktoken>=0.8.0
 Requires-Dist: toml>=0.10.2
 Requires-Dist: tqdm>=4.67.1
@@ -250,6 +252,43 @@ if __name__ == "__main__":
 <img width="300" alt="image" src="https://github.com/user-attachments/assets/34c2fe2f-6dd2-498c-a826-1687cb158755" />
 </p>
 
+### MCP Support - Declaratively connect to 1000s of different tools!
+
+Create a server
+
+```python 
+ws_fetch_server = FlockFactory.create_mcp_server(
+    name="fetch_server",
+    enable_tools_feature=True,
+    connection_params=FlockFactory.WebsocketParams(
+        url="ws://localhost:4001/message"
+    ),
+```
+
+Add it to Flock
+
+```python 
+flock = Flock(
+    name="mcp_testbed",
+    servers=[
+        ws_fetch_server
+    ]
+)
+```
+
+And tell the flock agents which server to use
+
+```python 
+webcrawler_agent = FlockFactory.create_default_agent(
+    name="webcrawler_agent",
+    description="Expert for looking up and retrieving web content",
+    input="query: str | User-Query, initial_url: Optional[str] | Optional url to start search from.",
+    output="answer: str | Answer to user-query, page_url: str | The url of the page where the answer was found on, page_content: str | Markdown content of the page where the answer was found.",
+    servers=[ws_fetch_server], # servers are passed here.
+)
+```
+
+Done! The Flock agent has now access to every tool the server offers.
 
 
 ### 🚀 REST API – Deploy Flock Agents as REST API Endpoints
@@ -325,7 +364,6 @@ Take note how even custom types like `FantasyCharacter` are serialized so the ta
 name: pydantic_example
 model: openai/gpt-4o
 enable_temporal: false
-enable_logging: false
 show_flock_banner: false
 temporal_start_in_process_worker: true
 agents:

{flock_core-0.4.3 → flock_core-0.4.503}/README.md

@@ -174,6 +174,43 @@ if __name__ == "__main__":
 <img width="300" alt="image" src="https://github.com/user-attachments/assets/34c2fe2f-6dd2-498c-a826-1687cb158755" />
 </p>
 
+### MCP Support - Declaratively connect to 1000s of different tools!
+
+Create a server
+
+```python 
+ws_fetch_server = FlockFactory.create_mcp_server(
+    name="fetch_server",
+    enable_tools_feature=True,
+    connection_params=FlockFactory.WebsocketParams(
+        url="ws://localhost:4001/message"
+    ),
+```
+
+Add it to Flock
+
+```python 
+flock = Flock(
+    name="mcp_testbed",
+    servers=[
+        ws_fetch_server
+    ]
+)
+```
+
+And tell the flock agents which server to use
+
+```python 
+webcrawler_agent = FlockFactory.create_default_agent(
+    name="webcrawler_agent",
+    description="Expert for looking up and retrieving web content",
+    input="query: str | User-Query, initial_url: Optional[str] | Optional url to start search from.",
+    output="answer: str | Answer to user-query, page_url: str | The url of the page where the answer was found on, page_content: str | Markdown content of the page where the answer was found.",
+    servers=[ws_fetch_server], # servers are passed here.
+)
+```
+
+Done! The Flock agent has now access to every tool the server offers.
 
 
 ### 🚀 REST API – Deploy Flock Agents as REST API Endpoints
@@ -249,7 +286,6 @@ Take note how even custom types like `FantasyCharacter` are serialized so the ta
 name: pydantic_example
 model: openai/gpt-4o
 enable_temporal: false
-enable_logging: false
 show_flock_banner: false
 temporal_start_in_process_worker: true
 agents:

{flock_core-0.4.3 → flock_core-0.4.503}/docs/getting-started/configuration.md

@@ -80,12 +80,15 @@ You can also override or set configurations directly when creating Flock or Floc
 ### Configure Flock instance
 ```python
 from flock.core import Flock, FlockAgent, FlockFactory
+from flock.core.logging.logging import configure_logging
+
+# Only show error logs
+configure_logging("ERROR")
 
 my_flock = Flock(
     name="ConfiguredFlock",
     model="anthropic/claude-3-sonnet-20240229", # Override default model
     enable_temporal=False, # Force local execution
-    enable_logging=True    # Enable logging for this flock instance
 )
 ```
 

{flock_core-0.4.3 → flock_core-0.4.503}/docs/guides/temporal-configuration.md

@@ -152,9 +152,9 @@ async def main():
     )
 
     # 2. Create Flock with Temporal Config
+    configure_logging("ERROR")  # show only errors
     flock = Flock(
         enable_temporal=True, # MUST be True to use Temporal config
-        enable_logging=True,
         temporal_config=workflow_config
     )
 

{flock_core-0.4.3 → flock_core-0.4.503}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "flock-core"
-version = "0.4.3"
+version = "0.4.503"
 description = "Declarative LLM Orchestration at Scale"
 readme = "README.md"
 authors = [
@@ -24,8 +24,8 @@ dependencies = [
     "litellm==1.69.3",
     "loguru>=0.7.3",
     "matplotlib>=3.10.0",
+    "mcp>=1.7.1",
     "msgpack>=1.1.0",
-    "notion-client>=2.3.0",
     "opentelemetry-api>=1.30.0",
     "opentelemetry-exporter-jaeger>=1.21.0",
     "opentelemetry-exporter-jaeger-proto-grpc>=1.21.0",
@@ -37,7 +37,7 @@ dependencies = [
     "pillow>=10.4.0",
     "prometheus-client>=0.21.1",
     "psutil>=6.1.1",
-    "pydantic>=2.10.5",
+    "pydantic==2.10.5",
     "pydantic-settings>=2.7.1",
     "python-box>=7.3.2",
     "python-decouple>=3.8",
@@ -46,8 +46,10 @@ dependencies = [
     "pyyaml>=6.0",
     "questionary>=2.1.0",
     "rich>=13.9.4",
+    "rouge-score>=0.1.2",
     "sentence-transformers>=3.4.1",
     "temporalio>=1.9.0",
+    "thefuzz>=0.22.1",
     "tiktoken>=0.8.0",
     "toml>=0.10.2",
     "tqdm>=4.67.1",

{flock_core-0.4.3 → flock_core-0.4.503}/src/flock/cli/create_flock.py

@@ -74,19 +74,12 @@ def create_flock():
     # ).ask()
     enable_temporal = False
 
-    # Logging configuration
-    enable_logging = questionary.confirm(
-        "Enable logging?",
-        default=True,
-    ).ask()
-
     # Create the Flock instance
     flock = Flock(
         name=flock_name,
         model=model,
         description=description,
         enable_temporal=enable_temporal,
-        enable_logging=enable_logging,
     )
 
     console.print("\n[green]✓[/] Flock created successfully!")

{flock_core-0.4.3 → flock_core-0.4.503}/src/flock/cli/execute_flock.py

@@ -12,6 +12,7 @@ from rich.console import Console
 from rich.panel import Panel
 
 from flock.core.flock import Flock
+from flock.core.logging.logging import configure_logging
 from flock.core.util.cli_helper import init_console
 
 # Create console instance
@@ -109,9 +110,16 @@ def execute_flock(flock: Flock):
 
     # Logging options
     enable_logging = questionary.confirm(
-        "Enable detailed logging?",
+        "Enable logging?",
         default=False,
     ).ask()
+    if enable_logging:
+        log_level = questionary.select(
+            "Minimum log level:",
+            choices=["DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL"],
+            default="ERROR",
+        ).ask()
+        configure_logging(flock_level=log_level, external_level=log_level)
 
     # Preview input
     console.print("\n[bold]Input Preview:[/]")
@@ -130,10 +138,7 @@ def execute_flock(flock: Flock):
     console.print("\n[bold]Executing Flock...[/]")
 
     try:
-        # Handle logging settings
-        if enable_logging:
-            # Enable logging through the logging configuration method
-            flock._configure_logging(True)
+        # Logging was configured earlier if enabled
 
         # Run the Flock
         result = flock.run(
@@ -509,9 +514,16 @@ def execute_flock_batch(flock: Flock):
 
     # Logging options
     enable_logging = questionary.confirm(
-        "Enable detailed logging?",
+        "Enable logging?",
         default=False,
     ).ask()
+    if enable_logging:
+        log_level = questionary.select(
+            "Minimum log level:",
+            choices=["DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL"],
+            default="ERROR",
+        ).ask()
+        configure_logging(log_level)
 
     # Preview configuration
     console.print("\n[bold]Batch Configuration Preview:[/]")
@@ -554,9 +566,7 @@ def execute_flock_batch(flock: Flock):
     console.print("\n[bold]Executing Batch...[/]")
 
     try:
-        # Handle logging settings
-        if enable_logging:
-            flock._configure_logging(True)
+        # Logging was already configured above if enabled
 
         # Run the batch
         results = flock.run_batch(

{flock_core-0.4.3 → flock_core-0.4.503}/src/flock/core/__init__.py

@@ -14,6 +14,12 @@ from flock.core.flock_registry import (
     flock_type,
     get_registry,
 )
+from flock.core.mcp.flock_mcp_server import (
+    FlockMCPServerBase,
+)
+from flock.core.mcp.flock_mcp_tool_base import FlockMCPToolBase
+from flock.core.mcp.mcp_client import FlockMCPClientBase
+from flock.core.mcp.mcp_client_manager import FlockMCPClientManagerBase
 
 __all__ = [
     "Flock",
@@ -22,6 +28,11 @@ __all__ = [
     "FlockEvaluator",
     "FlockEvaluatorConfig",
     "FlockFactory",
+    "FlockMCPClientBase",
+    "FlockMCPClientManagerBase",
+    "FlockMCPServerBase",
+    "FlockMCPServerConfig",
+    "FlockMCPToolBase",
     "FlockModule",
     "FlockModuleConfig",
     "FlockRegistry",