abbenay-client 2026.6.5a0__tar.gz

abbenay_client-2026.6.5a0/.gitignore

@@ -0,0 +1,39 @@
+# Build output
+dist/
+
+# Bootstrap tools (downloaded by ./bootstrap.sh)
+.build-tools/
+
+# Node.js
+node_modules/
+out/
+*.tsbuildinfo
+
+# VS Code Extension
+*.vsix
+.vscode-test/
+packages/vscode/bin/
+
+# Daemon
+packages/daemon/dist/
+
+# OS
+.DS_Store
+
+# Coverage
+coverage/
+
+# Logs
+*.log
+
+# Environment
+.env
+.env.local
+
+# Python
+__pycache__/
+*.pyc
+.venv/
+.build-venv/
+*.egg-info/
+.pytest_cache/.superpowers/

abbenay_client-2026.6.5a0/PKG-INFO

@@ -0,0 +1,121 @@
+Metadata-Version: 2.4
+Name: abbenay-client
+Version: 2026.6.5a0
+Summary: Abbenay gRPC client for Python
+Project-URL: Homepage, https://github.com/redhat-developer/abbenay
+Project-URL: Documentation, https://github.com/redhat-developer/abbenay/tree/main/packages/python#readme
+Project-URL: Repository, https://github.com/redhat-developer/abbenay
+Project-URL: Changelog, https://github.com/redhat-developer/abbenay/releases
+Project-URL: Issues, https://github.com/redhat-developer/abbenay/issues
+Author: Abbenay Contributors
+License-Expression: MIT
+Keywords: abbenay,ai,client,grpc,llm
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Requires-Dist: grpcio>=1.60.0
+Requires-Dist: protobuf>=4.25.0
+Provides-Extra: dev
+Requires-Dist: grpcio-tools>=1.60.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Abbenay Python Client
+
+A Python gRPC client for the Abbenay daemon.
+
+## Installation
+
+Install from [PyPI](https://pypi.org/project/abbenay-client/):
+
+```bash
+pip install abbenay-client
+```
+
+> **Note:** The pip package is `abbenay-client` but the Python import is
+> `abbenay_grpc`:
+>
+> ```python
+> from abbenay_grpc import AbbenayClient
+> ```
+
+Cross-platform: works on Linux, macOS, and Windows with Python 3.9+.
+
+## Quick Start
+
+```python
+import asyncio
+from abbenay_grpc import AbbenayClient
+
+async def main():
+    async with AbbenayClient() as client:
+        async for chunk in client.chat("openai/gpt-4o", "Hello!"):
+            if chunk.type == "text":
+                print(chunk.text, end="")
+        print()
+
+asyncio.run(main())
+```
+
+## Event Loop Lifecycle
+
+`grpc.aio` channels are bound to the event loop that was active at
+`connect()` time.  If you call `asyncio.run()` more than once (which
+creates and destroys loops), call `reconnect()` in the new loop:
+
+```python
+async def preflight():
+    async with AbbenayClient() as client:
+        await client.health_check()
+
+asyncio.run(preflight())  # loop created and closed
+
+async def main():
+    client = AbbenayClient()
+    await client.connect()  # auto-detects dead channel, reconnects
+    # ... or explicitly: await client.reconnect()
+```
+
+## Connecting to a Container
+
+When the daemon runs in a container, connect via TCP instead of the
+default Unix socket:
+
+```python
+async with AbbenayClient(host="localhost", port=50051) as client:
+    async for chunk in client.chat("openrouter/anthropic/claude-sonnet-4", "Hello!"):
+        if chunk.text:
+            print(chunk.text, end="")
+```
+
+The container must be started with `--grpc-port 50051` (the default
+`Containerfile` CMD does this) and the port published (`-p 50051:50051`).
+
+See [docs/CONTAINER.md](../../docs/CONTAINER.md) for full container
+deployment instructions.
+
+## Features
+
+- **Chat**: Streaming chat with any configured model
+- **Sessions**: Create, list, fork, and manage chat sessions
+- **Models**: List available models from all providers
+- **Tools**: Dynamic MCP server registration and tool filtering
+- **Secrets**: Manage API keys via keychain
+- **Configuration**: Get/update daemon config
+
+## Requirements
+
+- Python 3.9+
+- Abbenay daemon running (`abbenay daemon`)
+
+## License
+
+MIT

abbenay_client-2026.6.5a0/README.md

@@ -0,0 +1,91 @@
+# Abbenay Python Client
+
+A Python gRPC client for the Abbenay daemon.
+
+## Installation
+
+Install from [PyPI](https://pypi.org/project/abbenay-client/):
+
+```bash
+pip install abbenay-client
+```
+
+> **Note:** The pip package is `abbenay-client` but the Python import is
+> `abbenay_grpc`:
+>
+> ```python
+> from abbenay_grpc import AbbenayClient
+> ```
+
+Cross-platform: works on Linux, macOS, and Windows with Python 3.9+.
+
+## Quick Start
+
+```python
+import asyncio
+from abbenay_grpc import AbbenayClient
+
+async def main():
+    async with AbbenayClient() as client:
+        async for chunk in client.chat("openai/gpt-4o", "Hello!"):
+            if chunk.type == "text":
+                print(chunk.text, end="")
+        print()
+
+asyncio.run(main())
+```
+
+## Event Loop Lifecycle
+
+`grpc.aio` channels are bound to the event loop that was active at
+`connect()` time.  If you call `asyncio.run()` more than once (which
+creates and destroys loops), call `reconnect()` in the new loop:
+
+```python
+async def preflight():
+    async with AbbenayClient() as client:
+        await client.health_check()
+
+asyncio.run(preflight())  # loop created and closed
+
+async def main():
+    client = AbbenayClient()
+    await client.connect()  # auto-detects dead channel, reconnects
+    # ... or explicitly: await client.reconnect()
+```
+
+## Connecting to a Container
+
+When the daemon runs in a container, connect via TCP instead of the
+default Unix socket:
+
+```python
+async with AbbenayClient(host="localhost", port=50051) as client:
+    async for chunk in client.chat("openrouter/anthropic/claude-sonnet-4", "Hello!"):
+        if chunk.text:
+            print(chunk.text, end="")
+```
+
+The container must be started with `--grpc-port 50051` (the default
+`Containerfile` CMD does this) and the port published (`-p 50051:50051`).
+
+See [docs/CONTAINER.md](../../docs/CONTAINER.md) for full container
+deployment instructions.
+
+## Features
+
+- **Chat**: Streaming chat with any configured model
+- **Sessions**: Create, list, fork, and manage chat sessions
+- **Models**: List available models from all providers
+- **Tools**: Dynamic MCP server registration and tool filtering
+- **Secrets**: Manage API keys via keychain
+- **Configuration**: Get/update daemon config
+
+## Requirements
+
+- Python 3.9+
+- Abbenay daemon running (`abbenay daemon`)
+
+## License
+
+MIT

abbenay_client-2026.6.5a0/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "abbenay-client"
+version = "2026.6.5a0"
+description = "Abbenay gRPC client for Python"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+keywords = ["abbenay", "llm", "grpc", "ai", "client"]
+authors = [
+    { name = "Abbenay Contributors" }
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "grpcio>=1.60.0",
+    "protobuf>=4.25.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "grpcio-tools>=1.60.0",
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.23.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/redhat-developer/abbenay"
+Documentation = "https://github.com/redhat-developer/abbenay/tree/main/packages/python#readme"
+Repository = "https://github.com/redhat-developer/abbenay"
+Changelog = "https://github.com/redhat-developer/abbenay/releases"
+Issues = "https://github.com/redhat-developer/abbenay/issues"
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/abbenay_grpc"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"

abbenay_client-2026.6.5a0/src/abbenay_grpc/__init__.py

@@ -0,0 +1,51 @@
+"""Abbenay gRPC Client for Python.
+
+This module provides a Python client for communicating with the Abbenay daemon
+via gRPC over Unix Domain Sockets.
+
+Daemon paths:
+    Socket: $XDG_RUNTIME_DIR/abbenay/daemon.sock (or ~/.abbenay/daemon.sock)
+    PID file: $XDG_RUNTIME_DIR/abbenay/abbenay.pid (or ~/.abbenay/abbenay.pid)
+
+Example usage:
+
+    from abbenay_grpc import AbbenayClient
+
+    # Check if daemon is running
+    if not AbbenayClient.is_daemon_running():
+        print("Start the daemon: abbenay daemon")
+    
+    async with AbbenayClient() as client:
+        # Chat with a model
+        async for chunk in client.chat("openai/gpt-4o", "Hello!"):
+            print(chunk.text, end="")
+        
+        # Create a session
+        session = await client.create_session("openai/gpt-4o")
+        
+        # List sessions
+        sessions = await client.list_sessions()
+        for s in sessions:
+            print(f"{s.id}: {s.topic}")
+"""
+
+from .client import (
+    AbbenayClient,
+    AbbenayError,
+    ConnectionError,
+    NotFoundError,
+    ChatChunk,
+    Session,
+    Model,
+)
+
+__all__ = [
+    "AbbenayClient",
+    "AbbenayError",
+    "ConnectionError",
+    "NotFoundError",
+    "ChatChunk",
+    "Session",
+    "Model",
+]
+__version__ = "2026.6.5a0"