org.slashlib.py.inference.ollama 0.1.2__tar.gz

org_slashlib_py_inference_ollama-0.1.2/LICENSE.md

@@ -0,0 +1,23 @@
+[AI](AI.md) [CHANGELOG](CHANGELOG.md) [README](README.md)
+
+MIT License
+
+Copyright (c) 2026 Dirk Brenckmann, db-developer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

org_slashlib_py_inference_ollama-0.1.2/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: org.slashlib.py.inference.ollama
+Version: 0.1.2
+Summary: python inference handler for agents
+Author-email: Dirk Brenckmann <db.developer@gmx.de>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/org-slashlib/org.slashlib.py.inference.ollama
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: org.slashlib.py.agent>=0.1.5
+Requires-Dist: org.slashlib.py.configloader>=0.1.0
+Dynamic: license-file
+
+[Bottom](#license) [AI](AI.md) [CHANGELOG](CHANGELOG.md) [LICENSE](LICENSE.md)
+# org.slashlib.py.inference.ollama
+
+The official **Ollama** inference adapter for the `org.slashlib.py.agent` framework.
+
+[![PyPI version](https://img.shields.io/pypi/v/org.slashlib.py.inference.ollama.svg?color=blue)](https://pypi.org/project/org.slashlib.py.inference.ollama/) 
+[![PyPI-Test version](https://img.shields.io/badge/pypitest-latest-blue)](https://test.pypi.org/project/org.slashlib.py.inference.ollama/) 
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## 1. Overview & Architecture
+
+This project provides a specialized implementation of the `InferenceAdapter` interface from the core **Agent Framework**. By decoupling the Ollama logic from the main framework, we ensure a lightweight core and allow for independent updates to the inference logic.
+
+### Architectural Role
+- **Adapter Pattern**: Bridges the standardized framework calls to the Ollama-specific API.
+- **Provider Agnostic**: The framework consumes this adapter through a unified interface.
+- **Plugin-Based**: Leverages Python entry points for seamless, zero-config integration.
+
+---
+
+## 2. Prerequisites
+
+- **Ollama Service**: Must be installed and reachable (Default: `http://localhost:11434`).
+- **Python**: Version 3.10 or higher.
+- **Base Framework**: `org.slashlib.py.agent` must be installed in the same environment.
+
+---
+
+## 3. Installation
+
+### Production / Standard
+```bash
+pip install org.slashlib.py.inference.ollama
+```
+
+### Development (Editable Mode)
+If you are developing both the framework and this adapter, install both in editable mode to ensure the **Entry Points** are correctly registered in your current Python environment:
+
+```bash
+# 1. Install the framework
+cd path/to/org.slashlib.py.agent
+pip install -e .
+
+# 2. Install this adapter
+cd path/to/org.slashlib.py.inference.ollama
+pip install -e .
+```
+
+---
+
+## 4. Integration Logic (Entry Points)
+
+This adapter is designed to be \"invisible\" to the end user. It registers itself via the `pyproject.toml` entry points:
+
+```toml
+[project.entry-points.\"org.slashlib.py.agent.inference\"]
+ollama = \"org.slashlib.py.inference.ollama.adapter:OllamaInferenceAdapter\"
+```
+
+The framework automatically scans this group and maps the name `ollama` to the `OllamaInferenceAdapter` class.
+
+---
+
+## 5. Configuration
+
+The adapter's behavior is controlled via the framework's configuration loader (usually `pyproject.json`).
+
+| Key | Type | Default | Description |
+| :--- | :--- | :--- | :--- |
+| `model` | string | (required) | The name of the Ollama model (e.g., \"llama3\", \"gemma\"). |
+| `think` | boolean | `true` | Enables/Disables thinking process visibility if supported. |
+| `timeout` | float | `600.0` | Connection timeout in seconds. |
+
+**Example `pyproject.json`:**
+```json
+{
+  \"adapter\": {
+    \"ollama\": {
+      \"model\": \"gemma\",
+      \"think\": true,
+      \"timeout\": 300.0
+    }
+  }
+}
+```
+
+---
+
+## 6. Usage Example
+
+You do not need to import any classes from this package directly. Use the Framework's factory method:
+
+```python
+import asyncio
+from org.slashlib.py.agent.agent import Agent
+
+async def main():
+    # Load the agent - the framework resolves 'ollama' via Entry Points
+    my_agent = Agent.from_plugin(
+        identifier=\"my-local-assistant\",
+        plugin_name=\"ollama\"
+    )
+
+    # All standard Agent methods are now available
+    response = await my_agent.chat(\"How does the plugin system work?\")
+    print(f\"Assistant: {response.content}\")
+
+if __name__ == \"__main__\":
+    asyncio.run(main())
+```
+
+---
+
+## 7. Development & Testing
+
+### Testing with Pytest
+```bash
+pytest tests/
+```
+
+### Logging
+The adapter logs under the namespace `org.slashlib.py.inference.ollama`.
+
+---
+
+## 8. Documentation & Obsidian
+
+The project root is fully prepared as an **Obsidian Vault**.
+
+---
+
+## License
+
+Distributed under the **MIT License**. See `LICENSE.md` for more information.
+
+---
+© 2026 org.slashlib

org_slashlib_py_inference_ollama-0.1.2/README.md

@@ -0,0 +1,139 @@
+[Bottom](#license) [AI](AI.md) [CHANGELOG](CHANGELOG.md) [LICENSE](LICENSE.md)
+# org.slashlib.py.inference.ollama
+
+The official **Ollama** inference adapter for the `org.slashlib.py.agent` framework.
+
+[![PyPI version](https://img.shields.io/pypi/v/org.slashlib.py.inference.ollama.svg?color=blue)](https://pypi.org/project/org.slashlib.py.inference.ollama/) 
+[![PyPI-Test version](https://img.shields.io/badge/pypitest-latest-blue)](https://test.pypi.org/project/org.slashlib.py.inference.ollama/) 
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## 1. Overview & Architecture
+
+This project provides a specialized implementation of the `InferenceAdapter` interface from the core **Agent Framework**. By decoupling the Ollama logic from the main framework, we ensure a lightweight core and allow for independent updates to the inference logic.
+
+### Architectural Role
+- **Adapter Pattern**: Bridges the standardized framework calls to the Ollama-specific API.
+- **Provider Agnostic**: The framework consumes this adapter through a unified interface.
+- **Plugin-Based**: Leverages Python entry points for seamless, zero-config integration.
+
+---
+
+## 2. Prerequisites
+
+- **Ollama Service**: Must be installed and reachable (Default: `http://localhost:11434`).
+- **Python**: Version 3.10 or higher.
+- **Base Framework**: `org.slashlib.py.agent` must be installed in the same environment.
+
+---
+
+## 3. Installation
+
+### Production / Standard
+```bash
+pip install org.slashlib.py.inference.ollama
+```
+
+### Development (Editable Mode)
+If you are developing both the framework and this adapter, install both in editable mode to ensure the **Entry Points** are correctly registered in your current Python environment:
+
+```bash
+# 1. Install the framework
+cd path/to/org.slashlib.py.agent
+pip install -e .
+
+# 2. Install this adapter
+cd path/to/org.slashlib.py.inference.ollama
+pip install -e .
+```
+
+---
+
+## 4. Integration Logic (Entry Points)
+
+This adapter is designed to be \"invisible\" to the end user. It registers itself via the `pyproject.toml` entry points:
+
+```toml
+[project.entry-points.\"org.slashlib.py.agent.inference\"]
+ollama = \"org.slashlib.py.inference.ollama.adapter:OllamaInferenceAdapter\"
+```
+
+The framework automatically scans this group and maps the name `ollama` to the `OllamaInferenceAdapter` class.
+
+---
+
+## 5. Configuration
+
+The adapter's behavior is controlled via the framework's configuration loader (usually `pyproject.json`).
+
+| Key | Type | Default | Description |
+| :--- | :--- | :--- | :--- |
+| `model` | string | (required) | The name of the Ollama model (e.g., \"llama3\", \"gemma\"). |
+| `think` | boolean | `true` | Enables/Disables thinking process visibility if supported. |
+| `timeout` | float | `600.0` | Connection timeout in seconds. |
+
+**Example `pyproject.json`:**
+```json
+{
+  \"adapter\": {
+    \"ollama\": {
+      \"model\": \"gemma\",
+      \"think\": true,
+      \"timeout\": 300.0
+    }
+  }
+}
+```
+
+---
+
+## 6. Usage Example
+
+You do not need to import any classes from this package directly. Use the Framework's factory method:
+
+```python
+import asyncio
+from org.slashlib.py.agent.agent import Agent
+
+async def main():
+    # Load the agent - the framework resolves 'ollama' via Entry Points
+    my_agent = Agent.from_plugin(
+        identifier=\"my-local-assistant\",
+        plugin_name=\"ollama\"
+    )
+
+    # All standard Agent methods are now available
+    response = await my_agent.chat(\"How does the plugin system work?\")
+    print(f\"Assistant: {response.content}\")
+
+if __name__ == \"__main__\":
+    asyncio.run(main())
+```
+
+---
+
+## 7. Development & Testing
+
+### Testing with Pytest
+```bash
+pytest tests/
+```
+
+### Logging
+The adapter logs under the namespace `org.slashlib.py.inference.ollama`.
+
+---
+
+## 8. Documentation & Obsidian
+
+The project root is fully prepared as an **Obsidian Vault**.
+
+---
+
+## License
+
+Distributed under the **MIT License**. See `LICENSE.md` for more information.
+
+---
+© 2026 org.slashlib

org_slashlib_py_inference_ollama-0.1.2/pyproject.toml

@@ -0,0 +1,51 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "org.slashlib.py.inference.ollama"
+version = "0.1.2"
+license = "MIT"
+dependencies = [
+  "org.slashlib.py.agent>=0.1.5",
+  "org.slashlib.py.configloader>=0.1.0"
+]
+authors = [
+  { name="Dirk Brenckmann", email="db.developer@gmx.de" },
+]
+description = "python inference handler for agents"
+readme = "README.md"
+requires-python = ">=3.10"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+
+[project.entry-points."org.slashlib.py.agent.inference"]
+ollama-inference-adapter = "org.slashlib.py.inference.ollama.adapter:OllamaInferenceAdapter"
+
+[project.urls]
+"Homepage" = "https://github.com/org-slashlib/org.slashlib.py.inference.ollama"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+pythonpath = ["."]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+addopts = """
+  -v  
+  --cov 
+  --cov=src/org/slashlib/py/inference/ollama 
+  --cov-report=term-missing 
+  --cov-report=xml:docs/reports/coverage/xml
+  --cov-report=html:docs/reports/coverage/html
+"""
+
+[tool.coverage.run]
+data_file = "docs/reports/coverage/.coverage"
+source = ["src/org/slashlib/py/inference/ollama"]
+
+[tool.coverage.report]
+show_missing = true

org_slashlib_py_inference_ollama-0.1.2/setup.cfg

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

org_slashlib_py_inference_ollama-0.1.2/src/org/slashlib/py/inference/ollama/__init__.py

@@ -0,0 +1,21 @@
+# -*- coding: utf-8 -*-
+# file src/org/slashlib/py/inference/ollama/__init__.py
+# @AI:
+# - INTEGRITY RULES:
+#   - STRICT PRESERVATION: Do not remove, move, or modify ANY existing lines of code or comments 
+#     unless they are the explicit target of the requested change. 
+#   - DEBUG MARKERS: Commented-out code (e.g., debug prints) MUST be kept exactly where they are.
+#   - WHITESPACE & STRUCTURE: Maintain all original empty lines and the existing file structure. 
+#     Structural integrity takes precedence over "clean code" or "elegance".
+#   - LEAD-IN/OUT: The very first and last lines (and all comments in between) are immutable anchors.
+# - MAINTENANCE:
+#   - Only update pydoc strings (args, returns, raises) if the function signature changes.
+#   - Do NOT delete existing examples or descriptions in pydoc.
+# - LANGUAGE: en-US for all comments and documentation.
+
+from org.slashlib.py.inference.ollama.adapter import OllamaInferenceAdapter
+from org.slashlib.py.inference.ollama.result  import OllamaInferenceResult
+
+__all__ = ["OllamaInferenceAdapter", "OllamaInferenceResult"]
+
+# end of file src/org/slashlib/py/inference/ollama/__init__.py

org_slashlib_py_inference_ollama-0.1.2/src/org/slashlib/py/inference/ollama/adapter.py

@@ -0,0 +1,113 @@
+# -*- coding: utf-8 -*-
+# file src/org/slashlib/py/inference/ollama/adapter.py
+# @AI:
+# - INTEGRITY RULES:
+#   - STRICT PRESERVATION: Do not remove, move, or modify ANY existing lines of code or comments 
+#     unless they are the explicit target of the requested change. 
+#   - DEBUG MARKERS: Commented-out code (e.g., debug prints) MUST be kept exactly where they are.
+#   - WHITESPACE & STRUCTURE: Maintain all original empty lines and the existing file structure. 
+#     Structural integrity takes precedence over "clean code" or "elegance".
+#   - LEAD-IN/OUT: The very first and last lines (and all comments in between) are immutable anchors.
+# - MAINTENANCE:
+#   - Only update pydoc strings (args, returns, raises) if the function signature changes.
+#   - Do NOT delete existing examples or descriptions in pydoc.
+# - LANGUAGE: en-US for all comments and documentation.
+#
+
+# Python imports
+import logging
+import pathlib
+import typing
+
+# Third party imports
+import ollama
+import org.slashlib.py.agent as agent
+import org.slashlib.py.configloader as config
+
+# Internal imports
+from org.slashlib.py.inference.ollama.result import OllamaInferenceResult
+
+class OllamaInferenceAdapter(agent.InferenceAdapter):
+    """
+    Inference Adapter for the Ollama API.
+
+    Handles asynchronous communication with an Ollama server, including 
+    parameter resolution from config and error mapping to the neutral 
+    inference exception hierarchy.
+    """
+
+    def __init__(self):
+        """
+        Initialize the adapter and its logger.
+        """
+        self.log = logging.getLogger(f"org.slashlib.py.inference.ollama.{pathlib.Path(__file__).stem}.{self.__class__.__name__}")
+
+    async def chat(
+        self, 
+        model: typing.Optional[str] = None, 
+        messages: typing.List[typing.Dict[str, typing.Any]] = None, 
+        tools: typing.Optional[typing.List[typing.Dict[str, typing.Any]]] = None,
+        **kwargs
+    ) -> agent.InferenceResult:
+        """
+        Sends a chat request to Ollama and returns a validated result.
+
+        Resolves model parameters using a priority chain: 
+        1. Explicit kwargs, 2. Method arguments, 3. pyproject.json via configloader.
+
+        Args:
+            model (Optional[str]): The model name. Defaults to config value.
+            messages (List[Dict[str, Any]]): The message history/context.
+            tools (Optional[List[Dict[str, Any]]]): JSON schemas of available tools.
+            **kwargs: Additional parameters like 'timeout' or 'think'.
+
+        Returns:
+            agent.InferenceResult: An instance of OllamaInferenceResult.
+
+        Raises:
+            agent.InferenceConfigError: If the model is not found or config is invalid.
+            agent.InferenceConnectionError: If the Ollama server is unreachable or times out.
+            agent.InferencePayloadError: If the response from Ollama is malformed.
+            agent.InferenceError: For any other unexpected errors during agent.
+        """
+        # Resolve parameters: priority is kwargs -> method arg -> pyproject.json
+        target_model = model or kwargs.get("model", config.resolve("adapter.ollama.model"))
+        timeout = kwargs.get("timeout", config.resolve("adapter.ollama.timeout"))
+        think = kwargs.get("think", config.resolve("adapter.ollama.think"))
+
+        try:
+            self.log.debug(f"Ollama request: timeout={timeout}, model={target_model}, messages={messages}, tools={tools}, think={think}")
+            
+            client = ollama.AsyncClient(timeout=timeout)
+            response = await client.chat(
+                model=target_model,
+                messages=messages,
+                tools=tools,
+                think=think
+            )
+
+            self.log.debug(f"Ollama response: {response}")
+            
+            message = response.get("message")
+            if not message:
+                raise agent.InferencePayloadError(f"Ollama API returned an empty response for model '{target_model}'.")
+
+            return OllamaInferenceResult(message)
+
+        except (ollama.ResponseError) as e:
+            self.log.error(f"Ollama logical/config error: {e}", exc_info=True)
+            raise agent.InferenceConfigError(f"Ollama model or config invalid: {str(e)}")
+        except (ollama.RequestError) as e:
+            self.log.error(f"Ollama communication error: {e}", exc_info=True)
+            raise agent.InferenceConnectionError(f"Failed to connect to Ollama: {str(e)}")
+        except agent.InferenceError:
+            # Re-raise internal inference errors to prevent them from being caught by the general Exception block
+            raise
+        except Exception as e:
+            self.log.error(f"Unexpected error in OllamaInferenceAdapter: {e}", exc_info=True)
+            raise agent.InferenceError(f"Internal adapter error: {str(e)}")
+
+
+__all__ = ["OllamaInferenceAdapter"]
+
+# end of file file src/org/slashlib/py/inference/ollama/adapter.py

org_slashlib_py_inference_ollama-0.1.2/src/org/slashlib/py/inference/ollama/result.py

@@ -0,0 +1,105 @@
+# -*- coding: utf-8 -*-
+# file src/org/slashlib/py/inference/ollama/result.py
+# @AI:
+# - INTEGRITY RULES:
+#   - STRICT PRESERVATION: Do not remove, move, or modify ANY existing lines of code or comments 
+#     unless they are the explicit target of the requested change. 
+#   - DEBUG MARKERS: Commented-out code (e.g., debug prints) MUST be kept exactly where they are.
+#   - WHITESPACE & STRUCTURE: Maintain all original empty lines and the existing file structure. 
+#     Structural integrity takes precedence over "clean code" or "elegance".
+#   - LEAD-IN/OUT: The very first and last lines (and all comments in between) are immutable anchors.
+# - MAINTENANCE:
+#   - Only update pydoc strings (args, returns, raises) if the function signature changes.
+#   - Do NOT delete existing examples or descriptions in pydoc.
+# - LANGUAGE: en-US for all comments and documentation.
+#
+
+# Python imports
+import logging
+import pathlib
+import typing
+
+# Third party imports
+
+# Internal imports
+import org.slashlib.py.agent as agent
+
+
+class OllamaInferenceResult(agent.InferenceResult):
+    """
+    Specific implementation of InferenceResult for Ollama.
+
+    This class takes the raw dictionary response from the Ollama API, 
+    validates its mandatory fields (role, content/tool_calls), and 
+    provides standardized accessors for the Agent.
+    """
+
+    def __init__(self, raw_response: typing.Dict[str, typing.Any]):
+        """
+        Initialize and validate the Ollama response.
+
+        Args:
+            raw_response (Dict[str, Any]): The 'message' part of the Ollama API response.
+
+        Raises:
+            agent.InferencePayloadError: If the 'role' is missing or if both 
+                'content' and 'tool_calls' are empty/None.
+        """
+        self.log = logging.getLogger(f"org.slashlib.py.inference.ollama.{pathlib.Path(__file__).stem}.{self.__class__.__name__}")
+        self._role = raw_response.get("role")
+        self._content = raw_response.get("content")
+        self._tool_calls = raw_response.get("tool_calls")
+
+        if not self._role:
+            raise agent.InferencePayloadError(f"Invalid Ollama response: 'role' is missing. Data: {raw_response}")
+        
+        # Note: content can be None if tool_calls are present, which is valid.
+        if self._content is None and not self._tool_calls:
+            raise agent.InferencePayloadError(f"Invalid Ollama response: Both 'content' and 'tool_calls' are empty.")
+
+    @property
+    def role(self) -> str:
+        """
+        The role of the message sender.
+
+        Returns:
+            str: Typically 'assistant'.
+        """
+        return self._role
+
+    @property
+    def content(self) -> typing.Optional[str]:
+        """
+        The text content of the model's response.
+
+        Returns:
+            Optional[str]: The message text or None if only tool calls are present.
+        """
+        return self._content
+
+    @property
+    def tool_calls(self) -> typing.Optional[typing.List[typing.Dict[str, typing.Any]]]:
+        """
+        A list of tool calls generated by the model.
+
+        Returns:
+            Optional[List[Dict[str, Any]]]: Standardized tool call objects or None.
+        """
+        return self._tool_calls
+
+    def to_dict(self) -> typing.Dict[str, typing.Any]:
+        """
+        Converts the result into a standardized dictionary.
+
+        Returns:
+            Dict[str, Any]: A dictionary containing 'role', 'content', and 'tool_calls'.
+        """
+        return {
+            "role": self._role,
+            "content": self._content,
+            "tool_calls": self._tool_calls
+        }
+
+__all__ = ["OllamaInferenceResult"]
+
+# end of file src/org/slashlib/py/inference/ollama/result.py

org_slashlib_py_inference_ollama-0.1.2/src/org.slashlib.py.inference.ollama.egg-info/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: org.slashlib.py.inference.ollama
+Version: 0.1.2
+Summary: python inference handler for agents
+Author-email: Dirk Brenckmann <db.developer@gmx.de>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/org-slashlib/org.slashlib.py.inference.ollama
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: org.slashlib.py.agent>=0.1.5
+Requires-Dist: org.slashlib.py.configloader>=0.1.0
+Dynamic: license-file
+
+[Bottom](#license) [AI](AI.md) [CHANGELOG](CHANGELOG.md) [LICENSE](LICENSE.md)
+# org.slashlib.py.inference.ollama
+
+The official **Ollama** inference adapter for the `org.slashlib.py.agent` framework.
+
+[![PyPI version](https://img.shields.io/pypi/v/org.slashlib.py.inference.ollama.svg?color=blue)](https://pypi.org/project/org.slashlib.py.inference.ollama/) 
+[![PyPI-Test version](https://img.shields.io/badge/pypitest-latest-blue)](https://test.pypi.org/project/org.slashlib.py.inference.ollama/) 
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## 1. Overview & Architecture
+
+This project provides a specialized implementation of the `InferenceAdapter` interface from the core **Agent Framework**. By decoupling the Ollama logic from the main framework, we ensure a lightweight core and allow for independent updates to the inference logic.
+
+### Architectural Role
+- **Adapter Pattern**: Bridges the standardized framework calls to the Ollama-specific API.
+- **Provider Agnostic**: The framework consumes this adapter through a unified interface.
+- **Plugin-Based**: Leverages Python entry points for seamless, zero-config integration.
+
+---
+
+## 2. Prerequisites
+
+- **Ollama Service**: Must be installed and reachable (Default: `http://localhost:11434`).
+- **Python**: Version 3.10 or higher.
+- **Base Framework**: `org.slashlib.py.agent` must be installed in the same environment.
+
+---
+
+## 3. Installation
+
+### Production / Standard
+```bash
+pip install org.slashlib.py.inference.ollama
+```
+
+### Development (Editable Mode)
+If you are developing both the framework and this adapter, install both in editable mode to ensure the **Entry Points** are correctly registered in your current Python environment:
+
+```bash
+# 1. Install the framework
+cd path/to/org.slashlib.py.agent
+pip install -e .
+
+# 2. Install this adapter
+cd path/to/org.slashlib.py.inference.ollama
+pip install -e .
+```
+
+---
+
+## 4. Integration Logic (Entry Points)
+
+This adapter is designed to be \"invisible\" to the end user. It registers itself via the `pyproject.toml` entry points:
+
+```toml
+[project.entry-points.\"org.slashlib.py.agent.inference\"]
+ollama = \"org.slashlib.py.inference.ollama.adapter:OllamaInferenceAdapter\"
+```
+
+The framework automatically scans this group and maps the name `ollama` to the `OllamaInferenceAdapter` class.
+
+---
+
+## 5. Configuration
+
+The adapter's behavior is controlled via the framework's configuration loader (usually `pyproject.json`).
+
+| Key | Type | Default | Description |
+| :--- | :--- | :--- | :--- |
+| `model` | string | (required) | The name of the Ollama model (e.g., \"llama3\", \"gemma\"). |
+| `think` | boolean | `true` | Enables/Disables thinking process visibility if supported. |
+| `timeout` | float | `600.0` | Connection timeout in seconds. |
+
+**Example `pyproject.json`:**
+```json
+{
+  \"adapter\": {
+    \"ollama\": {
+      \"model\": \"gemma\",
+      \"think\": true,
+      \"timeout\": 300.0
+    }
+  }
+}
+```
+
+---
+
+## 6. Usage Example
+
+You do not need to import any classes from this package directly. Use the Framework's factory method:
+
+```python
+import asyncio
+from org.slashlib.py.agent.agent import Agent
+
+async def main():
+    # Load the agent - the framework resolves 'ollama' via Entry Points
+    my_agent = Agent.from_plugin(
+        identifier=\"my-local-assistant\",
+        plugin_name=\"ollama\"
+    )
+
+    # All standard Agent methods are now available
+    response = await my_agent.chat(\"How does the plugin system work?\")
+    print(f\"Assistant: {response.content}\")
+
+if __name__ == \"__main__\":
+    asyncio.run(main())
+```
+
+---
+
+## 7. Development & Testing
+
+### Testing with Pytest
+```bash
+pytest tests/
+```
+
+### Logging
+The adapter logs under the namespace `org.slashlib.py.inference.ollama`.
+
+---
+
+## 8. Documentation & Obsidian
+
+The project root is fully prepared as an **Obsidian Vault**.
+
+---
+
+## License
+
+Distributed under the **MIT License**. See `LICENSE.md` for more information.
+
+---
+© 2026 org.slashlib

org_slashlib_py_inference_ollama-0.1.2/src/org.slashlib.py.inference.ollama.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE.md
+README.md
+pyproject.toml
+src/org.slashlib.py.inference.ollama.egg-info/PKG-INFO
+src/org.slashlib.py.inference.ollama.egg-info/SOURCES.txt
+src/org.slashlib.py.inference.ollama.egg-info/dependency_links.txt
+src/org.slashlib.py.inference.ollama.egg-info/entry_points.txt
+src/org.slashlib.py.inference.ollama.egg-info/requires.txt
+src/org.slashlib.py.inference.ollama.egg-info/top_level.txt
+src/org/slashlib/py/inference/ollama/__init__.py
+src/org/slashlib/py/inference/ollama/adapter.py
+src/org/slashlib/py/inference/ollama/result.py

org_slashlib_py_inference_ollama-0.1.2/src/org.slashlib.py.inference.ollama.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

org_slashlib_py_inference_ollama-0.1.2/src/org.slashlib.py.inference.ollama.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[org.slashlib.py.agent.inference]
+ollama-inference-adapter = org.slashlib.py.inference.ollama.adapter:OllamaInferenceAdapter

org_slashlib_py_inference_ollama-0.1.2/src/org.slashlib.py.inference.ollama.egg-info/requires.txt

@@ -0,0 +1,2 @@
+org.slashlib.py.agent>=0.1.5
+org.slashlib.py.configloader>=0.1.0

org_slashlib_py_inference_ollama-0.1.2/src/org.slashlib.py.inference.ollama.egg-info/top_level.txt

@@ -0,0 +1 @@
+org