hopeit-agents 0.2.0b1__tar.gz

hopeit_agents-0.2.0b1/PKG-INFO

@@ -0,0 +1,30 @@
+Metadata-Version: 2.4
+Name: hopeit-agents
+Version: 0.2.0b1
+Summary: Hopeit integration for building agentic APIs
+Author-email: Leo Smerling & Pablo Canto <contact@hopeit.com.ar>, Leo Smerling <contact@hopeit.com.ar>, Pablo Canto <contact@hopeit.com.ar>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/hopeit-git/hopeit.agents
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: AsyncIO
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: hopeit.engine>=0.30.1
+Requires-Dist: pydantic-ai-slim[openai]<3,>=2.9
+
+# hopeit-agents
+
+Shared Hopeit integration for agentic APIs built with `hopeit.engine` and Pydantic AI.
+
+The initial package provides a configuration-driven model factory for OpenAI and an Ollama
+server. Application code selects the provider with `AgentModelSettings`; agents and tools remain
+provider-independent.
+
+This project intentionally does not provide another agent loop, message hierarchy, tool
+registry, or tracing format. Those responsibilities remain with Pydantic AI.

hopeit_agents-0.2.0b1/README.md

@@ -0,0 +1,10 @@
+# hopeit-agents
+
+Shared Hopeit integration for agentic APIs built with `hopeit.engine` and Pydantic AI.
+
+The initial package provides a configuration-driven model factory for OpenAI and an Ollama
+server. Application code selects the provider with `AgentModelSettings`; agents and tools remain
+provider-independent.
+
+This project intentionally does not provide another agent loop, message hierarchy, tool
+registry, or tracing format. Those responsibilities remain with Pydantic AI.

hopeit_agents-0.2.0b1/pyproject.toml

@@ -0,0 +1,46 @@
+[project]
+name = "hopeit-agents"
+version = "0.2.0b1"
+requires-python = ">=3.11"
+
+description = "Hopeit integration for building agentic APIs"
+dynamic = ["readme"]
+
+dependencies = [
+    "hopeit.engine>=0.30.1",
+    "pydantic-ai-slim[openai]>=2.9,<3",
+]
+
+license = "Apache-2.0"
+authors = [
+    { name = "Leo Smerling & Pablo Canto", email = "contact@hopeit.com.ar" },
+    { name = "Leo Smerling", email = "contact@hopeit.com.ar" },
+    { name = "Pablo Canto", email = "contact@hopeit.com.ar" },
+]
+classifiers = [
+    "Intended Audience :: Developers",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Development Status :: 4 - Beta",
+    "Framework :: AsyncIO",
+]
+
+[project.urls]
+"Homepage" = "https://github.com/hopeit-git/hopeit.agents"
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["hopeit_agents*"]
+namespaces = true
+
+[tool.setuptools.package-data]
+hopeit_agents = ["py.typed"]
+
+[tool.setuptools.dynamic]
+readme = { file = ["README.md"], content-type = "text/markdown" }

hopeit_agents-0.2.0b1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

hopeit_agents-0.2.0b1/src/hopeit_agents/agent_model.py

@@ -0,0 +1,76 @@
+"""Configuration-driven model construction for Hopeit agents."""
+
+import os
+from collections.abc import Mapping
+from enum import StrEnum
+
+from hopeit.dataobjects import dataclass, dataobject
+from pydantic_ai.models import Model
+from pydantic_ai.models.ollama import OllamaModel
+from pydantic_ai.models.openai import OpenAIChatModel
+from pydantic_ai.providers.ollama import OllamaProvider
+from pydantic_ai.providers.openai import OpenAIProvider
+
+SETTINGS_KEY = "agent_model"
+
+
+class AgentModelProvider(StrEnum):
+    """Model providers supported by the common Hopeit configuration."""
+
+    OPENAI = "openai"
+    OLLAMA = "ollama"
+
+
+@dataobject
+@dataclass
+class AgentModelSettings:
+    """Settings used to construct the model shared by Hopeit agent events."""
+
+    provider: AgentModelProvider
+    model_name: str
+    base_url: str | None = None
+    api_key_env: str | None = None
+
+    def resolve_api_key(self, env: Mapping[str, str] | None = None) -> str | None:
+        """Resolve a provider API key from the configured environment variable."""
+        source = os.environ if env is None else env
+        env_name = self.api_key_env
+        if env_name is None:
+            env_name = (
+                "OPENAI_API_KEY" if self.provider == AgentModelProvider.OPENAI else "OLLAMA_API_KEY"
+            )
+        value = source.get(env_name)
+        return value if value else None
+
+    def resolve_base_url(self, env: Mapping[str, str] | None = None) -> str | None:
+        """Resolve an explicit base URL, with Ollama environment fallback."""
+        if self.base_url:
+            return self.base_url
+        if self.provider != AgentModelProvider.OLLAMA:
+            return None
+        source = os.environ if env is None else env
+        return source.get("OLLAMA_BASE_URL")
+
+
+def build_agent_model(
+    settings: AgentModelSettings,
+    *,
+    env: Mapping[str, str] | None = None,
+) -> Model:
+    """Build an OpenAI or Ollama model without leaking provider checks into agents."""
+    api_key = settings.resolve_api_key(env)
+    base_url = settings.resolve_base_url(env)
+
+    match settings.provider:
+        case AgentModelProvider.OPENAI:
+            return OpenAIChatModel(
+                settings.model_name,
+                provider=OpenAIProvider(base_url=base_url, api_key=api_key),
+            )
+        case AgentModelProvider.OLLAMA:
+            return OllamaModel(
+                settings.model_name,
+                provider=OllamaProvider(base_url=base_url, api_key=api_key),
+            )
+
+    raise ValueError(f"Unsupported agent model provider: {settings.provider}")

hopeit_agents-0.2.0b1/src/hopeit_agents/py.typed

@@ -0,0 +1 @@
+

hopeit_agents-0.2.0b1/src/hopeit_agents.egg-info/PKG-INFO

@@ -0,0 +1,30 @@
+Metadata-Version: 2.4
+Name: hopeit-agents
+Version: 0.2.0b1
+Summary: Hopeit integration for building agentic APIs
+Author-email: Leo Smerling & Pablo Canto <contact@hopeit.com.ar>, Leo Smerling <contact@hopeit.com.ar>, Pablo Canto <contact@hopeit.com.ar>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/hopeit-git/hopeit.agents
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: AsyncIO
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: hopeit.engine>=0.30.1
+Requires-Dist: pydantic-ai-slim[openai]<3,>=2.9
+
+# hopeit-agents
+
+Shared Hopeit integration for agentic APIs built with `hopeit.engine` and Pydantic AI.
+
+The initial package provides a configuration-driven model factory for OpenAI and an Ollama
+server. Application code selects the provider with `AgentModelSettings`; agents and tools remain
+provider-independent.
+
+This project intentionally does not provide another agent loop, message hierarchy, tool
+registry, or tracing format. Those responsibilities remain with Pydantic AI.

hopeit_agents-0.2.0b1/src/hopeit_agents.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+src/hopeit_agents/agent_model.py
+src/hopeit_agents/py.typed
+src/hopeit_agents.egg-info/PKG-INFO
+src/hopeit_agents.egg-info/SOURCES.txt
+src/hopeit_agents.egg-info/dependency_links.txt
+src/hopeit_agents.egg-info/requires.txt
+src/hopeit_agents.egg-info/top_level.txt
+test/test_agent_model.py

hopeit_agents-0.2.0b1/src/hopeit_agents.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

hopeit_agents-0.2.0b1/src/hopeit_agents.egg-info/requires.txt

@@ -0,0 +1,2 @@
+hopeit.engine>=0.30.1
+pydantic-ai-slim[openai]<3,>=2.9

hopeit_agents-0.2.0b1/src/hopeit_agents.egg-info/top_level.txt

@@ -0,0 +1 @@
+hopeit_agents

hopeit_agents-0.2.0b1/test/test_agent_model.py

@@ -0,0 +1,42 @@
+"""Tests for the shared agent model factory."""
+
+from pydantic_ai.models.ollama import OllamaModel
+from pydantic_ai.models.openai import OpenAIChatModel
+
+from hopeit_agents.agent_model import (
+    SETTINGS_KEY,
+    AgentModelProvider,
+    AgentModelSettings,
+    build_agent_model,
+)
+
+
+def test_agent_model_settings_key_is_provider_neutral() -> None:
+    assert SETTINGS_KEY == "agent_model"
+
+
+def test_build_openai_model_from_configuration() -> None:
+    settings = AgentModelSettings(
+        provider=AgentModelProvider.OPENAI,
+        model_name="gpt-5.2",
+        api_key_env="TEST_OPENAI_API_KEY",
+    )
+
+    model = build_agent_model(settings, env={"TEST_OPENAI_API_KEY": "test-key"})
+
+    assert isinstance(model, OpenAIChatModel)
+    assert model.system == "openai"
+    assert str(model.base_url) == "https://api.openai.com/v1/"
+
+
+def test_build_ollama_model_from_configuration() -> None:
+    settings = AgentModelSettings(
+        provider=AgentModelProvider.OLLAMA,
+        model_name="qwen3",
+    )
+
+    model = build_agent_model(settings, env={"OLLAMA_BASE_URL": "http://localhost:11434/v1"})
+
+    assert isinstance(model, OllamaModel)
+    assert model.system == "ollama"
+    assert str(model.base_url) == "http://localhost:11434/v1/"