recallrai 0.1.1__py3-none-any.whl → 0.3.0__py3-none-any.whl

recallrai-0.3.0.dist-info/RECORD

@@ -0,0 +1,23 @@
+recallrai/__init__.py,sha256=X1aM48GKDS_mx_OSD3P0FeWtNrfYpMfkTN5Sqik7w1g,273
+recallrai/client.py,sha256=VNQ-AgmgQIdV5pOfvU7KptYC34jA_tGW1Kt3XnJoa-M,5230
+recallrai/exceptions/__init__.py,sha256=d1LiuofGiGOP8rmzpvUKinKaa_o1cn2JThGr__Hwysw,1209
+recallrai/exceptions/auth.py,sha256=mnxps1GLljuERxzqBZXg_LZqOYUbTM47GLaW9noiP3w,554
+recallrai/exceptions/base.py,sha256=RMCEPqsR4xbdIXLm8DY3th6MHQTQFfowNOYKLgu4Fbc,716
+recallrai/exceptions/merge_conflicts.py,sha256=_rJ4ug6bmBLp7S08gTQHNTWvS1XNSDKf860SzsVyD3s,2265
+recallrai/exceptions/network.py,sha256=MLvfFhIK2cPvqb-Z0IHGUwCNPpwbeww12YO3p7G9T8c,1081
+recallrai/exceptions/server.py,sha256=E39B6-rNNOqFZ4yVdSExDDbqDEALdTbZ5123kaE1ngw,1765
+recallrai/exceptions/sessions.py,sha256=DJffJUhq4lGda-puzStnvLWJr5jlJ9cbIGhPdSNMzTI,1057
+recallrai/exceptions/users.py,sha256=GPoko9BtcnZ-4G9pbCuKvca7d769c64Npk_CEyMVLhM,1352
+recallrai/exceptions/validation.py,sha256=O54apJf4pUsKXbo3A7I2nXV4J-BEk4txrAUNw8vK15o,415
+recallrai/merge_conflict.py,sha256=cEi2-0rOTKQXu61tt1p2LVItyA7l05TyvRw_mfCNIhI,7682
+recallrai/models/__init__.py,sha256=7M9q2BUDVyzCP7UNFmwo5Jzfni8fXibVPUCpiyQwG2w,1010
+recallrai/models/merge_conflict.py,sha256=H0yG-Tja01-vmBrI7mNXrARrgQVxF-LEE1YsB9voXJY,5337
+recallrai/models/session.py,sha256=xtNLoohWG5pmABf40y0zhU8Bo3guS8S6hbh4jFjI8AA,4782
+recallrai/models/user.py,sha256=8amkmBFAV0w2dkFBdp8Zx8nbuzQX3CkhEdpNIDBrqIY,6289
+recallrai/session.py,sha256=sL3StMzjDg9yf5wNf4gCifueUxUMpb36WGEbrFJJKXs,13422
+recallrai/user.py,sha256=_wCi3-RlNaVgDbwfLCiBFNlISPcVifbazw20iZgITWg,19060
+recallrai/utils/__init__.py,sha256=NWqn-HBC3Ahv_0E00-aHGDrTPN0RN1cXrvIxwvQLtZQ,108
+recallrai/utils/http_client.py,sha256=MLkAp2nMBFngnCHL5z8v4K4Vp_huu-ekOrQYkknQMtU,4500
+recallrai-0.3.0.dist-info/METADATA,sha256=00DN0-4YELkT2Z6PV-Tq06xIcE4lHMDDQ5zLRRgdqx8,30262
+recallrai-0.3.0.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+recallrai-0.3.0.dist-info/RECORD,,

{recallrai-0.1.1.dist-info → recallrai-0.3.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.1.1
+Generator: poetry-core 2.2.1
 Root-Is-Purelib: true
 Tag: py3-none-any

recallrai-0.1.1.dist-info/METADATA

@@ -1,440 +0,0 @@
-Metadata-Version: 2.3
-Name: recallrai
-Version: 0.1.1
-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.exceptions import UserAlreadyExistsError
-try:
-    user = client.create_user(user_id="user123", metadata={"name": "John Doe"})
-    print(f"Created user: {user.user_id}")
-    print(f"User metadata: {user.metadata}")
-    print(f"Created at: {user.created_at}")
-except UserAlreadyExistsError as e:
-    print(f"Error: {e}")
-```
-
-### Get a User
-
-```python
-from recallrai.exceptions import UserNotFoundError
-try:
-    user = client.get_user("user123")
-    print(f"User metadata: {user.metadata}")
-    print(f"Last active: {user.last_active_at}")
-except UserNotFoundError as e:
-    print(f"Error: {e}")
-```
-
-### List Users
-
-```python
-user_list = client.list_users(offset=0, limit=10)
-print(f"Total users: {user_list.total}")
-print(f"Has more users: {user_list.has_more}")
-
-for user in user_list.users:
-    print(f"User ID: {user.user_id}")
-    print(f"Metadata: {user.metadata}")
-    print(f"Created at: {user.created_at}")
-    print(f"Last active: {user.last_active_at}")
-    print("---")
-```
-
-### Update a User
-
-```python
-from recallrai.exceptions import UserNotFoundError, UserAlreadyExistsError
-try:
-    user = client.get_user("user123")
-    updated_user = user.update(
-        new_metadata={"name": "John Doe", "role": "admin"},
-        new_user_id="john_doe"
-    )
-    print(f"Updated user ID: {updated_user.user_id}")
-    print(f"Updated metadata: {updated_user.metadata}")
-except UserNotFoundError as e:
-    print(f"Error: {e}")
-except UserAlreadyExistsError as e:
-    print(f"Error: {e}")
-```
-
-### Delete a User
-
-```python
-from recallrai.exceptions import UserNotFoundError
-try:
-    user = client.get_user("john_doe")
-    user.delete()
-    print("User deleted successfully")
-except UserNotFoundError as e:
-    print(f"Error: {e}")
-```
-
-## Session Management
-
-### Create a Session
-
-```python
-from recallrai.exceptions import UserNotFoundError
-from recallrai.session import Session
-
-try:
-    # First, get the user
-    user = client.get_user("user123")
-    
-    # Create a session for the user; auto_process_after_minutes set to -1 disables auto-processing
-    session: Session = user.create_session(auto_process_after_minutes=5)
-    print("Created session id:", session.session_id)
-except UserNotFoundError as e:
-    print(f"Error: {e}")
-```
-
-### Get an Existing Session
-
-```python
-from recallrai.exceptions import UserNotFoundError, SessionNotFoundError
-
-try:
-    # First, get the user
-    user = client.get_user("user123")
-    
-    # Retrieve an existing session by its ID
-    session = user.get_session(session_id="session-uuid")
-    print("Session status:", session.get_status())
-except UserNotFoundError as e:
-    print(f"Error: {e}")
-except SessionNotFoundError as e:
-    print(f"Error: {e}")
-```
-
-### List Sessions
-
-```python
-from recallrai.exceptions import UserNotFoundError
-
-try:
-    # First, get the user
-    user = client.get_user("user123")
-    
-    # List sessions for this user
-    session_list = user.list_sessions(offset=0, limit=10)
-    for session in session_list.sessions:
-        print(session.session_id, session.status)
-except UserNotFoundError as e:
-    print(f"Error: {e}")
-```
-
-### Session – Adding Messages
-
-```python
-from recallrai.exceptions import UserNotFoundError, SessionNotFoundError, InvalidSessionStateError
-
-try:
-    # Add a user message
-    session.add_user_message("Hello! How are you?")
-    
-    # Add an assistant message
-    session.add_assistant_message("I'm an assistant. How can I help you?")
-except UserNotFoundError as e:
-    print(f"Error: {e}")
-except SessionNotFoundError as e:
-    print(f"Error: {e}")
-except InvalidSessionStateError as e:
-    print(f"Error: {e}")
-```
-
-### Session – Retrieving Context
-
-```python
-from recallrai.exceptions import UserNotFoundError, SessionNotFoundError
-
-try:
-    context = session.get_context()
-    print("Memory used:", context.memory_used)
-    print("Context:", context.context)
-except UserNotFoundError as e:
-    print(f"Error: {e}")
-except SessionNotFoundError as e:
-    print(f"Error: {e}")
-```
-
-### Session – Process Session
-
-```python
-from recallrai.exceptions import UserNotFoundError, SessionNotFoundError, InvalidSessionStateError
-
-try:
-    session.process()
-except UserNotFoundError as e:
-    print(f"Error: {e}")
-except SessionNotFoundError as e:
-    print(f"Error: {e}")
-except InvalidSessionStateError as e:
-    print(f"Error: {e}")
-```
-
-### Session – Get Status and Messages
-
-```python
-from recallrai.exceptions import UserNotFoundError, SessionNotFoundError
-from recallrai.models import SessionStatus
-
-try:
-    status = session.get_status()
-    print("Session status:", status)
-    
-    # Check if the session is in a specific state
-    if status == SessionStatus.PROCESSED:
-        print("Session has been processed")
-    
-    messages = session.get_messages()
-    for message in messages:
-        print(f"{message.role}: {message.content} at {message.timestamp}")
-except UserNotFoundError as e:
-    print(f"Error: {e}")
-except SessionNotFoundError as e:
-    print(f"Error: {e}")
-```
-
-## Example Usage with LLMs
-
-```python
-import openai
-from recallrai import RecallrAI
-from recallrai.exceptions import UserNotFoundError
-
-# Initialize RecallrAI and OpenAI clients
-rai_client = RecallrAI(
-    api_key="rai_yourapikey", 
-    project_id="your-project-uuid"
-)
-oai_client = openai.OpenAI(api_key="your-openai-api-key")
-
-def chat_with_memory(user_id, session_id=None):
-    # Get or create user
-    try:
-        user = rai_client.get_user(user_id)
-    except UserNotFoundError:
-        user = rai_client.create_user(user_id)
-    
-    # Create a new session or get an existing one
-    if session_id:
-        session = user.get_session(session_id=session_id)
-    else:
-        session = user.create_session(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 conversation history
-        response = oai_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
-
-The RecallrAI SDK implements a comprehensive exception hierarchy to help you handle different error scenarios gracefully:
-
-### Base Exception
-
-- **RecallrAIError**: The base exception for all SDK-specific errors. All other exceptions inherit from this.
-
-### Authentication Errors
-
-- **AuthenticationError**: Raised when there's an issue with your API key or project ID authentication.
-
-### Network-Related Errors
-
-- **NetworkError**: Base exception for all network-related issues.
-- **TimeoutError**: Occurs when a request takes too long to complete.
-- **ConnectionError**: Happens when the SDK cannot establish a connection to the RecallrAI API.
-
-### Server Errors
-
-- **ServerError**: Base class for server-side errors.
-- **InternalServerError**: Raised when the RecallrAI API returns a 5xx error code.
-
-### User-Related Errors
-
-- **UserError**: Base for all user-related exceptions.
-- **UserNotFoundError**: Raised when attempting to access a user that doesn't exist.
-- **UserAlreadyExistsError**: Occurs when creating a user with an ID that already exists.
-
-### Session-Related Errors
-
-- **SessionError**: Base for all session-related exceptions.
-- **SessionNotFoundError**: Raised when attempting to access a non-existent session.
-- **InvalidSessionStateError**: Occurs when performing an operation that's not valid for the current session state (e.g., adding a message to a processed session).
-
-### Input Validation Errors
-
-- **ValidationError**: Raised when provided data doesn't meet the required format or constraints.
-
-### Importing Exceptions
-
-You can import exceptions directly from the `recallrai.exceptions` module:
-
-```python
-# Import specific exceptions
-from recallrai.exceptions import UserNotFoundError, SessionNotFoundError
-
-# Import all exceptions
-from recallrai.exceptions import (
-    RecallrAIError,
-    AuthenticationError,
-    NetworkError,
-    TimeoutError,
-    ConnectionError,
-    ServerError, 
-    InternalServerError,
-    SessionError, 
-    SessionNotFoundError, 
-    InvalidSessionStateError,
-    UserError, 
-    UserNotFoundError, 
-    UserAlreadyExistsError,
-    ValidationError,
-)
-```
-
-### Best Practices for Error Handling
-
-When implementing error handling with the RecallrAI SDK, consider these best practices:
-
-1. **Handle specific exceptions first**: Catch more specific exceptions before general ones.
-
-   ```python
-   try:
-       # SDK operation
-   except UserNotFoundError:
-       # Specific handling
-   except RecallrAIError:
-       # General fallback
-   ```
-
-2. **Implement retry logic for transient errors**: Network and timeout errors might be temporary.
-
-3. **Log detailed error information**: Exceptions contain useful information for debugging.
-
-4. **Handle common user flows**: For example, check if a user exists before operations, or create them if they don't:
-
-   ```python
-   try:
-       user = client.get_user(user_id)
-   except UserNotFoundError:
-       user = client.create_user(user_id)
-   ```
-
-For more detailed information on specific exceptions, refer to the API documentation.
-
-## 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.1.dist-info/RECORD

@@ -1,20 +0,0 @@
-recallrai/__init__.py,sha256=i9HGT5lijm1r9n0iDEHacTYYT1Haq8tu_H0gfsp_-FM,386
-recallrai/client.py,sha256=E68i0jz2uXG50gYZgiM30bt9EQqVvEuw1mTpqxUpwLU,4667
-recallrai/exceptions/__init__.py,sha256=uE-7ywJ1dIJPdUTJisVRXwMzgv6AMgTEpRfDe_d9-1c,782
-recallrai/exceptions/auth.py,sha256=dLabhdTmCBtpp0Ghv3iIw6f3xQn2XXjKCFm1WsiIqXc,700
-recallrai/exceptions/base.py,sha256=0JCs0DoXpMD0XXjrmRR0CXBGxanYpIqBYMbH4d1fndk,1049
-recallrai/exceptions/network.py,sha256=QriByZFgXPEeYfpl_ozxTtzNwHfHtUlPSVb2pAymCx0,1562
-recallrai/exceptions/server.py,sha256=jLINK_3CoOwqKyzKtGB5DwxyZj5S8U2z6zYCZePWqbk,2416
-recallrai/exceptions/sessions.py,sha256=EwcdzxpDxDjUZVu-etgnayWFq2ADmybKfEQuweLw1VE,1777
-recallrai/exceptions/users.py,sha256=kpIhgt92cmW9AOazkD4hgvF8PPq2aYRridtO5pyto8M,1835
-recallrai/exceptions/validation.py,sha256=H0Nnv_RDeah3KzLhB13Ozu0q2cFMJIO-kfl3PWnCpyc,625
-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=Hsj80eyXyj25V-iW3feOIPyQqk5R0JGOcbahqNy-IUM,11053
-recallrai/user.py,sha256=Au3IYTxgyCv35zKrI2MRMMNXWFwBArUCu8W_pN9U9Tc,7714
-recallrai/utils/__init__.py,sha256=buNqocqVT4o62oOOlAE8YOlzUAhbQbbDC3Y2FxIgVAc,157
-recallrai/utils/http_client.py,sha256=QFp9syfIANbNjaVXOiZhj0koX4yGlR5bNxG8AihYvn4,3960
-recallrai-0.1.1.dist-info/METADATA,sha256=6vq_LjhduhyZlMSDxvVkz5GfFctTbhU_R32cHcYMWVM,13265
-recallrai-0.1.1.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
-recallrai-0.1.1.dist-info/RECORD,,