agentr 0.1.3__tar.gz → 0.1.5__tar.gz

{agentr-0.1.3 → agentr-0.1.5}/.gitignore

@@ -1,14 +1,14 @@
-# Python-generated files
-__pycache__/
-*.py[oc]
-build/
-dist/
-wheels/
-*.egg-info
-
-# Virtual environments
-.venv
-
-# Environment variables
-.env
-.env.local
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Environment variables
+.env
+.env.local

{agentr-0.1.3 → agentr-0.1.5}/.python-version

@@ -1 +1 @@
-3.13
+3.13

agentr-0.1.5/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AgentR
+
+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.

agentr-0.1.5/PKG-INFO

@@ -0,0 +1,160 @@
+Metadata-Version: 2.4
+Name: agentr
+Version: 0.1.5
+Summary: AgentR is a Python framework for building MCP servers to serve agentic applications and LLM clients
+Author-email: Manoj Bajaj <manojbajaj95@gmail.com>
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: mcp>=1.5.0
+Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: typer>=0.15.2
+Description-Content-Type: text/markdown
+
+# AgentR
+
+AgentR is a Python framework for building MCP servers to serve agentic applications and LLM clients. It provides a clean abstraction for incorporating various API services as "applications" into your agent workflow.
+
+## 🌟 Features
+
+- **MCP (Model Context Protocol) Integration**: Seamlessly works with MCP server architecture
+- **Simplified API Integration**: Connect to services like GitHub, Google Calendar, Gmail, Reddit, Tavily, and more with minimal code
+- **Managed Authentication**: Built-in support for API keys and OAuth-based authentication flows
+- **Extensible Architecture**: Easily build and add new app integrations with minimal boilerplate
+- **Credential Management**: Flexible storage options for API credentials with memory and environment-based implementations
+
+## 🔧 Installation
+
+Install AgentR using pip:
+
+```bash
+pip install agentr
+```
+
+## 🚀 Quick Start
+
+### 1. Get an API Key
+Before using AgentR with services that require authorization (like GitHub, Gmail, etc.), you'll need an AgentR API key:
+
+Visit https://agentr.dev to create an account
+Generate an API key from your dashboard
+Set it as an environment variable or include it directly in your code:
+
+```bash
+export AGENTR_API_KEY="your_api_key_here"
+```
+
+### 2. Create a basic server
+
+```bash
+from agentr.server import TestServer
+
+# Define your applications list
+apps_list = [
+    {
+        "name": "tavily",
+        "integration": {
+            "name": "tavily_api_key",
+            "type": "api_key",
+            "store": {
+                "type": "environment",
+            }
+        },        
+    },
+    {
+        "name": "zenquotes",
+        "integration": None
+    },
+    {
+        "name": "github",
+        "integration": {
+            "name": "github",
+            "type": "agentr",
+        }
+    }
+]
+
+# Create a server with these applications
+server = TestServer(name="My Agent Server", description="A server for my agent apps", apps_list=apps_list)
+
+# Run the server
+if __name__ == "__main__":
+    server.run()
+```
+
+## 🧩 Available Applications
+AgentR comes with several pre-built applications:
+
+| Application | Description | Authentication Type |
+|-------------|-------------|---------------------|
+| GitHub | Star repositories and more | OAuth (AgentR) |
+| Google Calendar | Retrieve calendar events | OAuth (AgentR) |
+| Gmail | Send emails | OAuth (AgentR) |
+| Reddit | Access Reddit data | OAuth (AgentR) |
+| Resend | Send emails via Resend API | API Key |
+| Tavily | Web search capabilities | API Key |
+| ZenQuotes | Get inspirational quotes | None |
+
+> **Note**: More applications are coming soon! Stay tuned for updates to our application catalog.
+
+## 🔐 Integration Types
+AgentR supports two primary integration types:
+
+### 1. API Key Integration
+For services that authenticate via API keys:
+```python
+{
+    "name": "service_name",
+    "integration": {
+        "name": "service_api_key",
+        "type": "api_key",
+        "store": {
+            "type": "environment",  # or "memory"
+        }
+    }
+}
+```
+
+### 2. OAuth Integration (via AgentR)
+For services requiring OAuth flow:
+```python
+{
+    "name": "service_name",
+    "integration": {
+        "name": "service_name",
+        "type": "agentr"
+    }
+}
+```
+When using OAuth integrations, users will be directed to authenticate with the service provider through a secure flow managed by AgentR.
+
+## 🤖 CLI Usage
+AgentR includes a command-line interface for common operations:
+
+```bash
+# Get version information
+agentr version
+
+# Generate API client from OpenAPI schema
+agentr generate --schema path/to/openapi.yaml
+
+# Run the test server
+agentr run
+
+# Install AgentR for specific applications
+agentr install claude
+```
+
+## 📋 Requirements
+
+- Python 3.11+
+- Dependencies (automatically installed):
+  - loguru >= 0.7.3
+  - mcp >= 1.5.0
+  - pyyaml >= 6.0.2
+  - typer >= 0.15.2
+
+
+## 📝 License
+
+This project is licensed under the MIT License.

agentr-0.1.5/README.md

@@ -0,0 +1,147 @@
+# AgentR
+
+AgentR is a Python framework for building MCP servers to serve agentic applications and LLM clients. It provides a clean abstraction for incorporating various API services as "applications" into your agent workflow.
+
+## 🌟 Features
+
+- **MCP (Model Context Protocol) Integration**: Seamlessly works with MCP server architecture
+- **Simplified API Integration**: Connect to services like GitHub, Google Calendar, Gmail, Reddit, Tavily, and more with minimal code
+- **Managed Authentication**: Built-in support for API keys and OAuth-based authentication flows
+- **Extensible Architecture**: Easily build and add new app integrations with minimal boilerplate
+- **Credential Management**: Flexible storage options for API credentials with memory and environment-based implementations
+
+## 🔧 Installation
+
+Install AgentR using pip:
+
+```bash
+pip install agentr
+```
+
+## 🚀 Quick Start
+
+### 1. Get an API Key
+Before using AgentR with services that require authorization (like GitHub, Gmail, etc.), you'll need an AgentR API key:
+
+Visit https://agentr.dev to create an account
+Generate an API key from your dashboard
+Set it as an environment variable or include it directly in your code:
+
+```bash
+export AGENTR_API_KEY="your_api_key_here"
+```
+
+### 2. Create a basic server
+
+```bash
+from agentr.server import TestServer
+
+# Define your applications list
+apps_list = [
+    {
+        "name": "tavily",
+        "integration": {
+            "name": "tavily_api_key",
+            "type": "api_key",
+            "store": {
+                "type": "environment",
+            }
+        },        
+    },
+    {
+        "name": "zenquotes",
+        "integration": None
+    },
+    {
+        "name": "github",
+        "integration": {
+            "name": "github",
+            "type": "agentr",
+        }
+    }
+]
+
+# Create a server with these applications
+server = TestServer(name="My Agent Server", description="A server for my agent apps", apps_list=apps_list)
+
+# Run the server
+if __name__ == "__main__":
+    server.run()
+```
+
+## 🧩 Available Applications
+AgentR comes with several pre-built applications:
+
+| Application | Description | Authentication Type |
+|-------------|-------------|---------------------|
+| GitHub | Star repositories and more | OAuth (AgentR) |
+| Google Calendar | Retrieve calendar events | OAuth (AgentR) |
+| Gmail | Send emails | OAuth (AgentR) |
+| Reddit | Access Reddit data | OAuth (AgentR) |
+| Resend | Send emails via Resend API | API Key |
+| Tavily | Web search capabilities | API Key |
+| ZenQuotes | Get inspirational quotes | None |
+
+> **Note**: More applications are coming soon! Stay tuned for updates to our application catalog.
+
+## 🔐 Integration Types
+AgentR supports two primary integration types:
+
+### 1. API Key Integration
+For services that authenticate via API keys:
+```python
+{
+    "name": "service_name",
+    "integration": {
+        "name": "service_api_key",
+        "type": "api_key",
+        "store": {
+            "type": "environment",  # or "memory"
+        }
+    }
+}
+```
+
+### 2. OAuth Integration (via AgentR)
+For services requiring OAuth flow:
+```python
+{
+    "name": "service_name",
+    "integration": {
+        "name": "service_name",
+        "type": "agentr"
+    }
+}
+```
+When using OAuth integrations, users will be directed to authenticate with the service provider through a secure flow managed by AgentR.
+
+## 🤖 CLI Usage
+AgentR includes a command-line interface for common operations:
+
+```bash
+# Get version information
+agentr version
+
+# Generate API client from OpenAPI schema
+agentr generate --schema path/to/openapi.yaml
+
+# Run the test server
+agentr run
+
+# Install AgentR for specific applications
+agentr install claude
+```
+
+## 📋 Requirements
+
+- Python 3.11+
+- Dependencies (automatically installed):
+  - loguru >= 0.7.3
+  - mcp >= 1.5.0
+  - pyyaml >= 6.0.2
+  - typer >= 0.15.2
+
+
+## 📝 License
+
+This project is licensed under the MIT License.

{agentr-0.1.3 → agentr-0.1.5}/pyproject.toml

@@ -1,23 +1,23 @@
-[project]
-name = "agentr"
-version = "0.1.3"
-description = "Add your description here"
-readme = "README.md"
-authors = [
-    { name = "Manoj Bajaj", email = "manojbajaj95@gmail.com" }
-]
-requires-python = ">=3.11"
-dependencies = [
-    "loguru>=0.7.3",
-    "mcp>=1.5.0",
-    "pyyaml>=6.0.2",
-    "typer>=0.15.2",
-]
-
-[project.scripts]
-agentr = "agentr.cli:app"
-
-
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
+[project]
+name = "agentr"
+version = "0.1.5"
+description = "AgentR is a Python framework for building MCP servers to serve agentic applications and LLM clients"
+readme = "README.md"
+authors = [
+    { name = "Manoj Bajaj", email = "manojbajaj95@gmail.com" }
+]
+requires-python = ">=3.11"
+dependencies = [
+    "loguru>=0.7.3",
+    "mcp>=1.5.0",
+    "pyyaml>=6.0.2",
+    "typer>=0.15.2",
+]
+
+[project.scripts]
+agentr = "agentr.cli:app"
+
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

agentr-0.1.5/src/agentr/__init__.py

@@ -0,0 +1,2 @@
+def main():
+    print("hello")

{agentr-0.1.3 → agentr-0.1.5}/src/agentr/application.py

@@ -1,57 +1,57 @@
-from abc import ABC, abstractmethod
-from agentr.integration import Integration
-import httpx
-
-class Application(ABC):
-    """
-    Application is collection of tools that can be used by an agent.
-    """
-    def __init__(self, name: str, **kwargs):
-        self.name = name
-
-    @abstractmethod
-    def list_tools(self):
-        pass
-
-
-class APIApplication(Application):
-    """
-    APIApplication is an application that uses an API to interact with the world.
-    """
-    def __init__(self, name: str, integration: Integration = None, **kwargs):
-        super().__init__(name, **kwargs)
-        self.integration = integration
-
-    def _get_headers(self):
-        return {}
-    
-    def _get(self, url, params=None):
-        headers = self._get_headers()
-        response = httpx.get(url, headers=headers, params=params)
-        response.raise_for_status()
-        return response
-    
-    def _post(self, url, data):
-        headers = self._get_headers()
-        response = httpx.post(url, headers=headers, json=data)
-        response.raise_for_status()
-        return response
-
-    def _put(self, url, data):
-        headers = self._get_headers()
-        response = httpx.put(url, headers=headers, json=data)
-        response.raise_for_status()
-        return response
-
-    def _delete(self, url):
-        headers = self._get_headers()
-        response = httpx.delete(url, headers=headers)
-        response.raise_for_status()
-        return response
-
-    def validate(self):
-        pass
-    
-    @abstractmethod
-    def list_tools(self):
+from abc import ABC, abstractmethod
+from agentr.integration import Integration
+import httpx
+
+class Application(ABC):
+    """
+    Application is collection of tools that can be used by an agent.
+    """
+    def __init__(self, name: str, **kwargs):
+        self.name = name
+
+    @abstractmethod
+    def list_tools(self):
+        pass
+
+
+class APIApplication(Application):
+    """
+    APIApplication is an application that uses an API to interact with the world.
+    """
+    def __init__(self, name: str, integration: Integration = None, **kwargs):
+        super().__init__(name, **kwargs)
+        self.integration = integration
+
+    def _get_headers(self):
+        return {}
+    
+    def _get(self, url, params=None):
+        headers = self._get_headers()
+        response = httpx.get(url, headers=headers, params=params)
+        response.raise_for_status()
+        return response
+    
+    def _post(self, url, data):
+        headers = self._get_headers()
+        response = httpx.post(url, headers=headers, json=data)
+        response.raise_for_status()
+        return response
+
+    def _put(self, url, data):
+        headers = self._get_headers()
+        response = httpx.put(url, headers=headers, json=data)
+        response.raise_for_status()
+        return response
+
+    def _delete(self, url):
+        headers = self._get_headers()
+        response = httpx.delete(url, headers=headers)
+        response.raise_for_status()
+        return response
+
+    def validate(self):
+        pass
+    
+    @abstractmethod
+    def list_tools(self):
         pass

{agentr-0.1.3 → agentr-0.1.5}/src/agentr/applications/github/app.py

@@ -1,52 +1,56 @@
-from agentr.integration import Integration
-from agentr.application import APIApplication
-from loguru import logger
-
-
-class GithubApp(APIApplication):
-    def __init__(self, integration: Integration) -> None:
-        super().__init__(name="github", integration=integration)
-
-    def _get_headers(self):
-        if not self.integration:
-            raise ValueError("Integration not configured")
-        credentials = self.integration.get_credentials()
-        if not credentials:
-            logger.warning("No credentials found")
-            return self.integration.authorize()
-        if "headers" in credentials:
-            return credentials["headers"]
-        return {
-            "Authorization": f"Bearer {credentials['access_token']}",
-            "Accept": "application/vnd.github.v3+json"
-        }
-    
-
-    def star_repository(self, repo_full_name: str) -> str:
-        """Star a GitHub repository
-        
-            Args:
-                repo_full_name: The full name of the repository (e.g. 'owner/repo')
-                
-            Returns:
-            
-                A confirmation message
-        """
-        try:
-            url = f"https://api.github.com/user/starred/{repo_full_name}"
-            response = self._put(url, data={})
-            
-            if response.status_code == 204:
-                return f"Successfully starred repository {repo_full_name}"
-            elif response.status_code == 404:
-                return f"Repository {repo_full_name} not found"
-            else:
-                logger.error(response.text)
-                return f"Error starring repository: {response.text}"
-        except Exception as e:
-            logger.error(e)
-            return f"Error starring repository: {e}"
-
-    
-    def list_tools(self):
+from agentr.integration import Integration
+from agentr.application import APIApplication
+from loguru import logger
+from agentr.exceptions import NotAuthorizedError
+
+class GithubApp(APIApplication):
+    def __init__(self, integration: Integration) -> None:
+        super().__init__(name="github", integration=integration)
+
+    def _get_headers(self):
+        if not self.integration:
+            raise ValueError("Integration not configured")
+        credentials = self.integration.get_credentials()
+        if not credentials:
+            logger.warning("No credentials found")
+            action = self.integration.authorize()
+            raise NotAuthorizedError(action)
+        if "headers" in credentials:
+            return credentials["headers"]
+        return {
+            "Authorization": f"Bearer {credentials['access_token']}",
+            "Accept": "application/vnd.github.v3+json"
+        }
+    
+
+    def star_repository(self, repo_full_name: str) -> str:
+        """Star a GitHub repository
+        
+            Args:
+                repo_full_name: The full name of the repository (e.g. 'owner/repo')
+                
+            Returns:
+            
+                A confirmation message
+        """
+        try:
+            url = f"https://api.github.com/user/starred/{repo_full_name}"
+            response = self._put(url, data={})
+            
+            if response.status_code == 204:
+                return f"Successfully starred repository {repo_full_name}"
+            elif response.status_code == 404:
+                return f"Repository {repo_full_name} not found"
+            else:
+                logger.error(response.text)
+                return f"Error starring repository: {response.text}"
+        except NotAuthorizedError as e:
+            return e.message
+        except Exception as e:
+            logger.error(e)
+            raise e
+       
+
+    
+    def list_tools(self):
         return [self.star_repository]