hud-python 0.4.0__tar.gz → 0.4.1__tar.gz

{hud_python-0.4.0 → hud_python-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hud-python
-Version: 0.4.0
+Version: 0.4.1
 Summary: SDK for the HUD platform.
 Project-URL: Homepage, https://github.com/hud-evals/hud-python
 Project-URL: Bug Tracker, https://github.com/hud-evals/hud-python/issues
@@ -129,11 +129,12 @@ OSS RL environment + evals toolkit. Wrap software as environments, run benchmark
 # Core installation - MCP servers, telemetry, basic tools for environment design
 pip install hud-python
 
-# Agent installation - Adds AI providers, telemetry, datasets
+# Agent installation - Adds AI providers, datasets
 pip install "hud-python[agent]"
 
 # CLI utilities
 uv tool install hud-python
+# uv tool update-shell
 
 # From source (latest)
 git clone https://github.com/hud-evals/hud-python
@@ -162,19 +163,20 @@ from hud.datasets import Task  # See docs: https://docs.hud.so/reference/tasks
 
 async def main() -> None:
     with hud.trace("Quick Start 2048"): # All telemetry works for any MCP-based agent (see https://app.hud.so)
-        task = Task(
-            prompt="Reach 64 in 2048.",
-            mcp_config={
+        task = {
+            "prompt": "Reach 64 in 2048.",
+            "mcp_config": {
                 "hud": {
-                    "url": "https://mcp.hud.so",  # HUD's cloud MCP server (see https://docs.hud.so/core-concepts/architecture)
+                    "url": "https://mcp.hud.so/v3/mcp",  # HUD's cloud MCP server (see https://docs.hud.so/core-concepts/architecture)
                     "headers": {
-                        "Authorization": f"Bearer {os.getenv('HUD_API_KEY')}",  # Get your key at https://app.hud.so
-                        "Mcp-Image": "hudpython/hud-text-2048:v1.1"  # Docker image from https://hub.docker.com/u/hudpython
+                        "Authorization": f"Bearer {settings.api_key}",  # Get your key at https://app.hud.so
+                        "Mcp-Image": "hudpython/hud-text-2048:v1.2"  # Docker image from https://hub.docker.com/u/hudpython
                     }
                 }
             },
-            evaluate_tool={"name": "evaluate", "arguments": {"name": "max_number", "target": 64}},
-        )
+            "evaluate_tool": {"name": "evaluate", "arguments": {"name": "max_number", "arguments": {"target": 64}}},
+        }
+        task = Task(**task)
 
         # 1. Define the client explicitly:
         client = MCPClient(mcp_config=task.mcp_config)
@@ -189,7 +191,7 @@ async def main() -> None:
         # result = await ClaudeAgent().run(task)
 
         print(f"Reward: {result.reward}")
-        await client.close()
+        await client.shutdown()
 
 asyncio.run(main())
 ```
@@ -346,7 +348,7 @@ result = await ClaudeAgent().run({  # See all agents: https://docs.hud.so/refere
     "prompt": "Please explore this environment",
     "mcp_config": {
         "my-environment": {
-            "url": "https://mcp.hud.so",
+            "url": "https://mcp.hud.so/v3/mcp",
             "headers": {
                 "Authorization": f"Bearer {os.getenv('HUD_API_KEY')}",
                 "Mcp-Image": "my-name/my-environment:latest"

{hud_python-0.4.0 → hud_python-0.4.1}/README.md

@@ -37,11 +37,12 @@ OSS RL environment + evals toolkit. Wrap software as environments, run benchmark
 # Core installation - MCP servers, telemetry, basic tools for environment design
 pip install hud-python
 
-# Agent installation - Adds AI providers, telemetry, datasets
+# Agent installation - Adds AI providers, datasets
 pip install "hud-python[agent]"
 
 # CLI utilities
 uv tool install hud-python
+# uv tool update-shell
 
 # From source (latest)
 git clone https://github.com/hud-evals/hud-python
@@ -70,19 +71,20 @@ from hud.datasets import Task  # See docs: https://docs.hud.so/reference/tasks
 
 async def main() -> None:
     with hud.trace("Quick Start 2048"): # All telemetry works for any MCP-based agent (see https://app.hud.so)
-        task = Task(
-            prompt="Reach 64 in 2048.",
-            mcp_config={
+        task = {
+            "prompt": "Reach 64 in 2048.",
+            "mcp_config": {
                 "hud": {
-                    "url": "https://mcp.hud.so",  # HUD's cloud MCP server (see https://docs.hud.so/core-concepts/architecture)
+                    "url": "https://mcp.hud.so/v3/mcp",  # HUD's cloud MCP server (see https://docs.hud.so/core-concepts/architecture)
                     "headers": {
-                        "Authorization": f"Bearer {os.getenv('HUD_API_KEY')}",  # Get your key at https://app.hud.so
-                        "Mcp-Image": "hudpython/hud-text-2048:v1.1"  # Docker image from https://hub.docker.com/u/hudpython
+                        "Authorization": f"Bearer {settings.api_key}",  # Get your key at https://app.hud.so
+                        "Mcp-Image": "hudpython/hud-text-2048:v1.2"  # Docker image from https://hub.docker.com/u/hudpython
                     }
                 }
             },
-            evaluate_tool={"name": "evaluate", "arguments": {"name": "max_number", "target": 64}},
-        )
+            "evaluate_tool": {"name": "evaluate", "arguments": {"name": "max_number", "arguments": {"target": 64}}},
+        }
+        task = Task(**task)
 
         # 1. Define the client explicitly:
         client = MCPClient(mcp_config=task.mcp_config)
@@ -97,7 +99,7 @@ async def main() -> None:
         # result = await ClaudeAgent().run(task)
 
         print(f"Reward: {result.reward}")
-        await client.close()
+        await client.shutdown()
 
 asyncio.run(main())
 ```
@@ -254,7 +256,7 @@ result = await ClaudeAgent().run({  # See all agents: https://docs.hud.so/refere
     "prompt": "Please explore this environment",
     "mcp_config": {
         "my-environment": {
-            "url": "https://mcp.hud.so",
+            "url": "https://mcp.hud.so/v3/mcp",
             "headers": {
                 "Authorization": f"Bearer {os.getenv('HUD_API_KEY')}",
                 "Mcp-Image": "my-name/my-environment:latest"

{hud_python-0.4.0 → hud_python-0.4.1}/environments/browser/README.md

@@ -41,7 +41,7 @@ import hud
 from hud.clients import MCPClient
 from hud.agents import ClaudeAgent
 
-BASE_URL = "https://mcp.hud.so"
+BASE_URL = "https://mcp.hud.so/v3/mcp"
 HUD_API_KEY = os.getenv("HUD_API_KEY")
 
 async def main():

{hud_python-0.4.0 → hud_python-0.4.1}/environments/text_2048/pyproject.toml

@@ -3,7 +3,7 @@ name = "hud-text-2048"
 version = "0.1.0"
 description = "Text-based 2048 game environment for hud"
 requires-python = ">=3.11"
-dependencies = [ "hud-python @ git+https://github.com/hud-evals/hud-python.git@l/text-2048", "numpy",]
+dependencies = [ "hud-python", "numpy",]
 
 [build-system]
 requires = [ "hatchling",]

{hud_python-0.4.0 → hud_python-0.4.1}/hud/agents/__init__.py

@@ -3,7 +3,6 @@ from __future__ import annotations
 from .art import ArtHUDAgent
 from .base import MCPAgent
 from .claude import ClaudeAgent
-from .langchain import LangChainAgent
 from .openai import OperatorAgent
 from .openai_chat_generic import GenericOpenAIChatAgent
 
@@ -11,7 +10,6 @@ __all__ = [
     "ArtHUDAgent",
     "ClaudeAgent",
     "GenericOpenAIChatAgent",
-    "LangChainAgent",
     "MCPAgent",
     "OperatorAgent",
 ]

{hud_python-0.4.0 → hud_python-0.4.1}/hud/cli/init.py

@@ -37,7 +37,7 @@ version = "0.1.0"
 description = "A minimal HUD environment"
 requires-python = ">=3.11"
 dependencies = [
-    "hud-python @ git+https://github.com/hud-evals/hud-python.git",
+    "hud-python",
 ]
 
 [build-system]
@@ -259,7 +259,7 @@ def create_environment(name: str | None, directory: str, force: bool) -> None:
         console.print("   [cyan]hud dev[/cyan]")
     else:
         console.print("1. Enter the directory:")
-        console.print(f"   [cyan]cd {target_dir.relative_to(Path.cwd())}[/cyan]")
+        console.print(f"   [cyan]cd {target_dir}[/cyan]")
         console.print("\n2. Start development server:")
         console.print("   [cyan]hud dev[/cyan]")
 

{hud_python-0.4.0 → hud_python-0.4.1}/hud/cli/push.py

@@ -348,15 +348,6 @@ def push_environment(
     console.print("Test locally:")
     console.print(f"  [cyan]hud run {image}[/cyan]\n")
 
-    console.print("Use in MCP configs:")
-    console.print("  Claude Desktop:")
-    console.print(
-        f'    [cyan]{{"docker": {{"image": "{pushed_digest}", "command": "auto"}}}}[/cyan]\n'
-    )
-
-    console.print("  Via HUD (recommended):")
-    console.print(f'    [cyan]{{"hud": {{"registry": "{pushed_digest}"}}}}[/cyan]\n')
-
     console.print("Share environment:")
     console.print(
         "  Share the updated [cyan]hud.lock.yaml[/cyan] for others to reproduce your exact environment"  # noqa: E501

{hud_python-0.4.0 → hud_python-0.4.1}/hud/clients/base.py

@@ -128,8 +128,33 @@ class BaseHUDClient(AgentMCPClient):
 
         logger.debug("Initializing MCP client...")
 
-        # Subclasses implement connection
-        await self._connect(self._mcp_config)
+        try:
+            # Subclasses implement connection
+            await self._connect(self._mcp_config)
+        except RuntimeError as e:
+            # Re-raise authentication errors with clear message
+            if "Authentication failed" in str(e):
+                raise
+            raise
+        except Exception as e:
+            # Check for authentication errors in the exception chain
+            error_msg = str(e)
+            if "401" in error_msg or "Unauthorized" in error_msg:
+                # Check if connecting to HUD API
+                for server_config in self._mcp_config.values():
+                    url = server_config.get("url", "")
+                    if "mcp.hud.so" in url:
+                        raise RuntimeError(
+                            "Authentication failed for HUD API. "
+                            "Please ensure your HUD_API_KEY environment variable is set correctly. "
+                            "You can get an API key at https://app.hud.so"
+                        ) from e
+                # Generic 401 error
+                raise RuntimeError(
+                    f"Authentication failed (401 Unauthorized). "
+                    f"Please check your credentials or API key."
+                ) from e
+            raise
 
         # Common hud behavior - fetch telemetry
         await self._fetch_telemetry()

{hud_python-0.4.0 → hud_python-0.4.1}/hud/clients/fastmcp.py

@@ -82,7 +82,27 @@ class FastMCPHUDClient(BaseHUDClient):
 
         if self._stack is None:
             self._stack = AsyncExitStack()
-            await self._stack.enter_async_context(self._client)
+            try:
+                await self._stack.enter_async_context(self._client)
+            except Exception as e:
+                # Check for authentication errors
+                error_msg = str(e)
+                if "401" in error_msg or "Unauthorized" in error_msg:
+                    # Check if connecting to HUD API
+                    for server_config in mcp_config.values():
+                        url = server_config.get("url", "")
+                        if "mcp.hud.so" in url:
+                            raise RuntimeError(
+                                "Authentication failed for HUD API. "
+                                "Please ensure your HUD_API_KEY environment variable is set correctly. "
+                                "You can get an API key at https://app.hud.so"
+                            ) from e
+                    # Generic 401 error
+                    raise RuntimeError(
+                        f"Authentication failed (401 Unauthorized). "
+                        f"Please check your credentials or API key."
+                    ) from e
+                raise
 
             # Configure validation for output schemas based on client setting
             from mcp.client.session import ValidationOptions

{hud_python-0.4.0 → hud_python-0.4.1}/hud/utils/tests/test_version.py

@@ -5,4 +5,4 @@ def test_import():
     """Test that the package can be imported."""
     import hud
 
-    assert hud.__version__ == "0.4.0"
+    assert hud.__version__ == "0.4.1"

{hud_python-0.4.0 → hud_python-0.4.1}/hud/version.py

@@ -4,4 +4,4 @@ Version information for the HUD SDK.
 
 from __future__ import annotations
 
-__version__ = "0.4.0"
+__version__ = "0.4.1"

{hud_python-0.4.0 → hud_python-0.4.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "hud-python"
-version = "0.4.0"
+version = "0.4.1"
 description = "SDK for the HUD platform."
 readme = "README.md"
 requires-python = ">=3.11, <3.14"