recallrai 0.1.0__py3-none-any.whl → 0.2.0__py3-none-any.whl

recallrai/utils/http.py

@@ -1,167 +0,0 @@
-# Path: recallrai/utils/http.py
-# Description: HTTP client utilities for the RecallrAI SDK
-
-"""
-HTTP client utilities for making requests to the RecallrAI API.
-"""
-
-import json
-from typing import Any, Dict, Optional, Tuple, Union
-
-import httpx
-
-from .exceptions import (
-    AuthenticationError,
-    BadRequestError,
-    NotFoundError,
-    RateLimitError,
-    RecallrAIError,
-    ServerError,
-    ValidationError,
-)
-
-ACCEPTED_STATUS_CODES = [
-    200,  # OK
-    201,  # Created
-    204,  # No Content
-]
-
-class HTTPClient:
-    """HTTP client for making requests to the RecallrAI API."""
-
-    def __init__(
-        self,
-        api_key: str,
-        project_id: str,
-        base_url: str,
-        timeout: int = 30,
-    ):
-        """
-        Initialize the HTTP client.
-
-        Args:
-            api_key: Your RecallrAI API key
-            project_id: Your project ID
-            base_url: The base URL for the RecallrAI API
-            timeout: Request timeout in seconds
-        """
-        self.api_key = api_key
-        self.project_id = project_id
-        self.base_url = base_url.rstrip("/")
-        self.timeout = timeout
-        self.client = httpx.Client(
-            timeout=self.timeout,
-            headers={
-                "X-Api-Key": self.api_key,
-                "X-Project-Id": self.project_id,
-                "Content-Type": "application/json",
-                "Accept": "application/json",
-                "User-Agent": "RecallrAI-Python-SDK",
-                # TODO: "SDK-Version": "0.1.0",
-            },
-        )
-
-    def _handle_response(self, response: httpx.Response) -> Dict[str, Any]:
-        """
-        Handle the HTTP response and raise appropriate exceptions for errors.
-
-        Args:
-            response: The HTTP response from the API
-
-        Returns:
-            The parsed JSON response body
-            
-        Raises:
-            AuthenticationError: When the API key or project ID is invalid
-            NotFoundError: When the requested resource is not found
-            ValidationError: When the API rejects the request due to validation errors
-            RateLimitError: When the API rate limit has been exceeded
-            ServerError: When the API encounters an unexpected server error
-            RecallrAIError: For other types of errors
-        """
-        if response.status_code == 204:
-            return {}
-            
-        try:
-            data = response.json() if response.content else {}
-        except json.JSONDecodeError:
-            data = {}
-
-        error_detail = data.get("detail", "Unknown error")
-        
-        if response.status_code in ACCEPTED_STATUS_CODES:
-            return data
-        elif response.status_code == 400:
-            raise BadRequestError(message=f"Bad request: {error_detail}", details=data)
-        elif response.status_code == 401:
-            raise AuthenticationError(message="Invalid API key or project ID", details=data)
-        elif response.status_code == 404:
-            raise NotFoundError(message=f"Resource not found: {error_detail}", details=data)
-        elif response.status_code == 422:
-            raise ValidationError(message=f"Validation error: {error_detail}", details=data)
-        elif response.status_code == 429:
-            raise RateLimitError(message="API rate limit exceeded", details=data)
-        elif response.status_code >= 500:
-            raise ServerError(message=f"Server error: {error_detail}", details=data)
-        else:
-            raise RecallrAIError(
-                message=f"Unexpected error: {response.status_code} - {error_detail}",
-                details=data,
-            )
-
-    def request(
-        self,
-        method: str,
-        path: str,
-        params: Optional[Dict[str, Any]] = None,
-        data: Optional[Dict[str, Any]] = None,
-    ) -> Dict[str, Any]:
-        """
-        Make a request to the RecallrAI API.
-
-        Args:
-            method: HTTP method (GET, POST, PUT, DELETE)
-            path: API endpoint path
-            params: Query parameters
-            data: Request body data
-
-        Returns:
-            The parsed JSON response
-        """
-        url = f"{self.base_url}{path}"
-        
-        # Filter out None values in params and data
-        if params:
-            params = {k: v for k, v in params.items() if v is not None}
-        
-        if data:
-            data = {k: v for k, v in data.items() if v is not None}
-        
-        try:
-            response = self.client.request(
-                method=method,
-                url=url,
-                params=params,
-                json=data,
-            )
-            return self._handle_response(response)
-        except httpx.HTTPError as e:
-            raise RecallrAIError(f"HTTP error: {str(e)}")
-        except Exception as e:
-            raise RecallrAIError(f"Unexpected error: {str(e)}")
-
-    def get(self, path: str, params: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
-        """Make a GET request."""
-        return self.request("GET", path, params=params)
-
-    def post(self, path: str, data: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
-        """Make a POST request."""
-        return self.request("POST", path, data=data)
-
-    def put(self, path: str, data: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
-        """Make a PUT request."""
-        return self.request("PUT", path, data=data)
-
-    def delete(self, path: str) -> Dict[str, Any]:
-        """Make a DELETE request."""
-        return self.request("DELETE", path)

recallrai-0.1.0.dist-info/METADATA

@@ -1,268 +0,0 @@
-Metadata-Version: 2.3
-Name: recallrai
-Version: 0.1.0
-Summary: Official Python SDK for RecallrAI - Revolutionary contextual memory system that enables AI assistants to form meaningful connections between conversations, just like human memory.
-License: MIT
-Keywords: ai,memory,context,llm,mem0,getzep,zep
-Author: Devasheesh Mishra
-Author-email: devasheeshmishra4@gmail.com
-Requires-Python: >=3.8,<4.0
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-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: Programming Language :: Python :: 3.13
-Requires-Dist: httpx (>=0.25.0,<0.26.0)
-Requires-Dist: pydantic (>=2.4.0,<3.0.0)
-Project-URL: Homepage, https://recallrai.com
-Project-URL: Repository, https://github.com/recallrai/sdk-python
-Description-Content-Type: text/markdown
-
-# RecallrAI Python SDK
-
-Official Python SDK for RecallrAI – a revolutionary contextual memory system that enables AI assistants to form meaningful connections between conversations, just like human memory.
-
-## Installation
-
-Install the SDK via Poetry or pip:
-
-```bash
-poetry add recallrai
-# or
-pip install recallrai
-```
-
-## Initialization
-
-Create a client instance with your API key and project ID:
-
-```python
-from recallrai import RecallrAI
-
-api_key = "rai_yourapikey"
-project_id = "project-uuid"
-client = RecallrAI(api_key=api_key, project_id=project_id)
-```
-
-## User Management
-
-### Create a User
-
-```python
-from recallrai.user import User
-
-user_id = "user123"
-metadata = {"key": "value"}
-user = client.create_user(user_id=user_id, metadata=metadata)
-print("Created user:", user.user_id)
-```
-
-### Get a User
-
-```python
-user = client.get_user("user123")
-print("User metadata:", user.metadata)
-```
-
-### List Users
-
-```python
-user_list = client.list_users(offset=0, limit=10)
-for user in user_list.users:
-    print(user.user_id, user.metadata)
-```
-
-### Update a User
-
-```python
-# Update the user's metadata and/or change the user ID
-updated_user = client.update_user(user_id="user123", new_metadata={"role": "user"}, new_user_id="user1234")
-print("Updated user id:", updated_user.user_id)
-```
-
-### Delete a User
-
-```python
-client.delete_user("user1234")
-print("User deleted.")
-```
-
-## Session Management
-
-### Create a Session
-
-```python
-from recallrai.session import Session
-
-# Create a session for a user; auto_process_after_minutes set to -1 disables auto-processing.
-session = client.create_session(user_id="user123", auto_process_after_minutes=5)
-print("Created session id:", session.session_id)
-```
-
-### Get an Existing Session
-
-```python
-# Retrieve an existing session by its ID
-session = client.get_session(user_id="user123", session_id="session-uuid")
-print("Session status:", session.get_status())
-```
-
-### List Sessions
-
-```python
-session_list = client.list_sessions(user_id="user123", offset=0, limit=10)
-for session in session_list.sessions:
-    print(session.session_id, session.status)
-```
-
-### Session – Adding Messages
-
-#### Add a User Message
-
-```python
-session.add_user_message("Hello! How are you?")
-```
-
-### Session – Retrieving Context
-
-```python
-context = session.get_context()
-print("Memory used:", context.memory_used)
-print("Context:", context.context)
-```
-
-#### Add an Assistant Message
-
-```python
-session.add_assistant_message("I'm an assistant. How can I help you?")
-```
-
-### Session – Process Session
-
-```python
-session.process()
-```
-
-### Session – Get Status and Messages
-
-```python
-status = session.get_status()
-print("Session status:", status)
-
-messages = session.get_messages()
-for message in messages:
-    print(f"{message.role}: {message.content} at {message.timestamp}")
-```
-
-## Example Usage with LLMs
-
-```python
-import openai
-from recallrai import RecallrAI
-
-# Initialize RecallrAI and OpenAI clients
-recallrai_client = RecallrAI(api_key="rai_yourapikey", project_id="project-uuid")
-openai_client = openai.OpenAI(api_key="your-openai-api-key")
-
-def chat_with_memory(user_id, session_id=None):
-    # Get or create user
-    try:
-        user = recallrai_client.get_user(user_id)
-    except:
-        user = recallrai_client.create_user(user_id)
-    
-    # Create a new session or get an existing one
-    if session_id:
-        session = recallrai_client.get_session(user_id=user_id, session_id=session_id)
-    else:
-        session = recallrai_client.create_session(user_id=user_id, auto_process_after_minutes=30)
-        print(f"Created new session: {session.session_id}")
-    
-    print("Chat session started. Type 'exit' to end the conversation.")
-    
-    while True:
-        # Get user input
-        user_message = input("You: ")
-        if user_message.lower() == 'exit':
-            break
-        
-        # Add the user message to RecallrAI
-        session.add_user_message(user_message)
-        
-        # Get context from RecallrAI after adding the user message
-        context = session.get_context()
-        
-        # Create a system prompt that includes the context
-        system_prompt = f"""You are a helpful assistant with memory of previous conversations.
-        
-        MEMORIES ABOUT THE USER:
-        {context.context}
-        
-        You can use the above memories to provide better responses to the user.
-        Don't mention that you have access to memories unless you are explicitly asked."""
-        
-        # Get previous messages
-        previous_messages = session.get_messages()
-        previous_messages = [{"role": message.role, "content": message.content} for message in previous_messages]
-
-        # Call the LLM with the system prompt and user message
-        response = openai_client.chat.completions.create(
-            model="gpt-4o-mini",
-            messages=[
-                {"role": "system", "content": system_prompt},
-                **previous_messages,
-            ],
-            temperature=0.7
-        )
-        
-        assistant_message = response.choices[0].message.content
-        
-        # Print the assistant's response
-        print(f"Assistant: {assistant_message}")
-        
-        # Add the assistant's response to RecallrAI
-        session.add_assistant_message(assistant_message)
-    
-    # Process the session at the end of the conversation
-    print("Processing session to update memory...")
-    session.process()
-    print(f"Session ended. Session ID: {session.session_id}")
-    return session.session_id
-
-# Example usage
-if __name__ == "__main__":
-    user_id = "user123"
-    # To continue a previous session, uncomment below and provide the session ID
-    # previous_session_id = "previously-saved-session-uuid"
-    # session_id = chat_with_memory(user_id, previous_session_id)
-    
-    # Start a new session
-    session_id = chat_with_memory(user_id)
-    print(f"To continue this conversation later, use session ID: {session_id}")
-```
-
-## Exception Handling
-
-> Exception handling will be improved in future.
-Each operation may raise custom exceptions defined in the SDK:
-
-```python
-from recallrai.utils.exceptions import NotFoundError, ValidationError
-
-try:
-    user = client.get_user("nonexistent_id")
-except NotFoundError as e:
-    print("User not found:", e.message)
-except ValidationError as e:
-    print("Invalid input:", e.message)
-```
-
-## Conclusion
-
-This README outlines the basic usage of the RecallrAI SDK functions for user and session management. For additional documentation and advanced usage, please see the [official documentation](https://recallrai.com) or the source code repository on [GitHub](https://github.com/recallrai/sdk-python).
-

recallrai-0.1.0.dist-info/RECORD

@@ -1,13 +0,0 @@
-recallrai/__init__.py,sha256=lw4pmQKtKkfTZ50xY3Z3J9IRxaG1XMrvEsN-jSazeHY,385
-recallrai/client.py,sha256=lzD4DYL8kedr6P-9zJbf93CCt9PxmmHcSE2HzKBIU0w,6976
-recallrai/models/__init__.py,sha256=2wwbyVAY4IgBn1a7YcbA4i1_pXJpYPYuQo80N8PVTlI,361
-recallrai/models/session.py,sha256=Okn2tMmnl0UPL9q-Bl4cBaUcgs_U_nnvmKj3CHWavGY,3701
-recallrai/models/user.py,sha256=yu7HzceZ-U2Hp6lbRjA31SQsyfD3dmuBoQ9dVGvfZ14,2190
-recallrai/session.py,sha256=r045TL3a4_g0JjbCJ7VyRdhMX4JsUpVTDmMeeVwpGtY,5690
-recallrai/user.py,sha256=VwQhKSJrwEEV7LgGDHOIRbIfwRi7OE5V-F146CGD8kY,4035
-recallrai/utils/__init__.py,sha256=p_RBdfNvgBWQ62psiokCPCmZI5H7AQm8EJiRLxfHUjA,212
-recallrai/utils/exceptions.py,sha256=b-8ONmtUgcjJxUg68pXwnana-5zt4C0cR2rTliFBGBE,1581
-recallrai/utils/http.py,sha256=dGd4uUWtRDRBLZctNDNfdDr5njekMjCPBYSWcvKRpJM,5513
-recallrai-0.1.0.dist-info/METADATA,sha256=WU87emxQgZ4t5p8k9ipp8MwbbwDLWDmzrWyYzY_-TJg,7801
-recallrai-0.1.0.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
-recallrai-0.1.0.dist-info/RECORD,,