memorisdk 1.0.1__tar.gz → 2.0.0__tar.gz

{memorisdk-1.0.1 → memorisdk-2.0.0}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: memorisdk
-Version: 1.0.1
+Version: 2.0.0
 Summary: The Open-Source Memory Layer for AI Agents & Multi-Agent Systems
-Author-email: Memori Team <contact@memori.dev>
+Author-email: GibsonAI Team <noc@gibsonai.com>
 License: Apache-2.0
 Project-URL: Homepage, https://github.com/GibsonAI/memori
-Project-URL: Documentation, https://gibsonai.github.io/memori
+Project-URL: Documentation, https://memori.gibsonai.com/docs
 Project-URL: Repository, https://github.com/GibsonAI/memori.git
 Project-URL: Bug Tracker, https://github.com/GibsonAI/memori/issues
 Project-URL: Changelog, https://github.com/GibsonAI/memori/blob/main/CHANGELOG.md
@@ -31,8 +31,9 @@ License-File: LICENSE
 Requires-Dist: loguru>=0.6.0
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: python-dotenv>=1.0.0
-Requires-Dist: click>=8.0.0
+Requires-Dist: sqlalchemy>=2.0.0
 Requires-Dist: openai>=1.0.0
+Requires-Dist: litellm>=1.0.0
 Provides-Extra: dev
 Requires-Dist: black>=23.0; extra == "dev"
 Requires-Dist: ruff>=0.1.0; extra == "dev"
@@ -40,6 +41,9 @@ Requires-Dist: isort>=5.9.0; extra == "dev"
 Requires-Dist: mypy>=1.0; extra == "dev"
 Requires-Dist: pre-commit>=2.15; extra == "dev"
 Requires-Dist: types-PyYAML>=6.0.0; extra == "dev"
+Requires-Dist: pytest>=6.0; extra == "dev"
+Requires-Dist: pytest-cov>=2.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.18.0; extra == "dev"
 Provides-Extra: docs
 Requires-Dist: mkdocs>=1.5.0; extra == "docs"
 Requires-Dist: mkdocs-material>=9.0.0; extra == "docs"
@@ -50,15 +54,31 @@ Provides-Extra: postgres
 Requires-Dist: psycopg2-binary>=2.9.0; extra == "postgres"
 Provides-Extra: mysql
 Requires-Dist: PyMySQL>=1.0.0; extra == "mysql"
+Provides-Extra: databases
+Requires-Dist: psycopg2-binary>=2.9.0; extra == "databases"
+Requires-Dist: PyMySQL>=1.0.0; extra == "databases"
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.3.0; extra == "anthropic"
+Provides-Extra: litellm
+Requires-Dist: litellm>=1.0.0; extra == "litellm"
 Provides-Extra: integrations
 Requires-Dist: litellm>=1.0.0; extra == "integrations"
 Requires-Dist: anthropic>=0.3.0; extra == "integrations"
+Provides-Extra: demos
+Requires-Dist: streamlit>=1.28.0; extra == "demos"
+Requires-Dist: pandas>=2.0.0; extra == "demos"
+Requires-Dist: plotly>=5.17.0; extra == "demos"
+Requires-Dist: crewai>=0.152.0; extra == "demos"
+Requires-Dist: crewai-tools>=0.59.0; extra == "demos"
 Provides-Extra: all
 Requires-Dist: black>=23.0; extra == "all"
 Requires-Dist: ruff>=0.1.0; extra == "all"
 Requires-Dist: isort>=5.9.0; extra == "all"
 Requires-Dist: mypy>=1.0; extra == "all"
 Requires-Dist: pre-commit>=2.15; extra == "all"
+Requires-Dist: pytest>=6.0; extra == "all"
+Requires-Dist: pytest-cov>=2.0; extra == "all"
+Requires-Dist: pytest-asyncio>=0.18.0; extra == "all"
 Requires-Dist: mkdocs>=1.5.0; extra == "all"
 Requires-Dist: mkdocs-material>=9.0.0; extra == "all"
 Requires-Dist: mkdocs-git-revision-date-localized-plugin>=1.2.0; extra == "all"
@@ -68,17 +88,43 @@ Requires-Dist: psycopg2-binary>=2.9.0; extra == "all"
 Requires-Dist: PyMySQL>=1.0.0; extra == "all"
 Requires-Dist: litellm>=1.0.0; extra == "all"
 Requires-Dist: anthropic>=0.3.0; extra == "all"
+Requires-Dist: streamlit>=1.28.0; extra == "all"
+Requires-Dist: pandas>=2.0.0; extra == "all"
+Requires-Dist: plotly>=5.17.0; extra == "all"
 Dynamic: license-file
 
-# Memori
-
-**The Open-Source Memory Layer for AI Agents & Multi-Agent Systems v1.2**
-
-*Give your AI agents structured, persistent memory with intelligent context injection - no more repeating yourself!*
-
-[![PyPI version](https://badge.fury.io/py/memori.svg)](https://badge.fury.io/py/memori)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![GibsonAI](https://github.com/user-attachments/assets/878e341b-5a93-4489-a398-abeca91b6b11)](https://gibsonai.com/)
+
+# memori
+
+<p align="center">
+  <strong>Open-Source Memory Engine for LLMs, AI Agents & Multi-Agent Systems</strong>
+</p>
+
+<p align="center">
+  <i>Make LLMs context-aware with human-like memory, dual-mode retrieval, and automatic context injection.</i>
+</p>
+
+<p align="center">
+  <a href="https://memori.gibsonai.com/docs">Learn more</a>
+  ·
+  <a href="https://www.gibsonai.com/discord">Join Discord</a>
+</p>
+
+<p align="center">
+  <a href="https://badge.fury.io/py/memorisdk">
+    <img src="https://badge.fury.io/py/memori.svg" alt="PyPI version">
+  </a>
+  <a href="https://pepy.tech/projects/memorisdk">
+    <img src="https://static.pepy.tech/badge/memorisdk" alt="Downloads">
+  </a>
+  <a href="https://opensource.org/licenses/MIT">
+    <img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT">
+  </a>
+  <a href="https://www.python.org/downloads/">
+    <img src="https://img.shields.io/badge/python-3.8+-blue.svg" alt="Python 3.8+">
+  </a>
+</p>
 
 ---
 
@@ -92,32 +138,72 @@ Dynamic: license-file
 
 ## ⚡ Quick Start
 
+Install Memori:
+
 ```bash
 pip install memorisdk
 ```
 
+### Example with OpenAI
+
+1. Install OpenAI:
+
+```bash
+pip install openai
+```
+
+2. Set OpenAI API Key:
+
+```bash
+export OPENAI_API_KEY="sk-your-openai-key-here"
+```
+
+3. Run this Python script:
+
 ```python
 from memori import Memori
+from openai import OpenAI
 
-# Create your workspace memory with conscious mode
-office_work = Memori(
-    database_connect="sqlite:///office_memory.db",
-    conscious_ingest=True,  # Short-term working memory (one-shot context)
-    openai_api_key="your-key"
-)
+# Initialize OpenAI client
+openai_client = OpenAI()
 
-office_work.enable()  # Start recording conversations
+# Initialize memory
+memori = Memori(conscious_ingest=True)
+memori.enable()
 
-# Use ANY LLM library - context automatically injected!
-from litellm import completion
+print("=== First Conversation - Establishing Context ===")
+response1 = openai_client.chat.completions.create(
+    model="gpt-4o-mini",
+    messages=[{
+        "role": "user", 
+        "content": "I'm working on a Python FastAPI project"
+    }]
+)
 
-response = completion(
-    model="gpt-4o", 
-    messages=[{"role": "user", "content": "Help me with Python testing"}]
+print("Assistant:", response1.choices[0].message.content)
+print("\n" + "="*50)
+print("=== Second Conversation - Memory Provides Context ===")
+
+response2 = openai_client.chat.completions.create(
+    model="gpt-4o-mini", 
+    messages=[{
+        "role": "user",
+        "content": "Help me add user authentication"
+    }]
 )
-# ✨ Short-term working memory automatically included once per session
+print("Assistant:", response2.choices[0].message.content)
+print("\n💡 Notice: Memori automatically knows about your FastAPI Python project!")
 ```
 
+---
+
+**🚀 Ready to explore more?**
+- [📖 Examples](#examples) - Basic usage patterns and code samples
+- [🔌 Framework Integrations](#framework-integrations) - LangChain, Agno & CrewAI examples  
+- [🎮 Interactive Demos](#interactive-demos) - Live applications & tutorials
+
+---
+
 ## 🧠 How It Works
 
 ### 1. **Universal Recording**
@@ -284,15 +370,15 @@ Works with **ANY** LLM library:
 ```python
 memori.enable()  # Enable universal recording
 
-# LiteLLM (recommended)
-from litellm import completion
-completion(model="gpt-4", messages=[...])
-
 # OpenAI
-import openai
-client = openai.OpenAI()
+from openai import OpenAI
+client = OpenAI()
 client.chat.completions.create(...)
 
+# LiteLLM
+from litellm import completion
+completion(model="gpt-4", messages=[...])
+
 # Anthropic  
 import anthropic
 client = anthropic.Anthropic()
@@ -365,7 +451,7 @@ memori/
 └── tools/          # Memory search tools
 ```
 
-## 🚀 Examples
+## Examples
 
 - **[Basic Usage](./examples/basic_usage.py)** - Simple memory setup with conscious ingestion
 - **[Personal Assistant](./examples/personal_assistant.py)** - AI assistant with intelligent memory
@@ -373,9 +459,33 @@ memori/
 - **[Advanced Config](./examples/advanced_config.py)** - Production configuration
 - **[Interactive Demo](./memori_example.py)** - Live conscious ingestion showcase
 
+## Framework Integrations
+
+Memori works seamlessly with popular AI frameworks:
+
+| Framework | Description | Example | Features |
+|-----------|-------------|---------|----------|
+| 🤖 [Agno](./examples/integrations/agno_example.py) | Memory-enhanced agent framework integration with persistent conversations | Simple chat agent with memory search | Memory tools, conversation persistence, contextual responses |
+| 👥 [CrewAI](./examples/integrations/crewai_example.py) | Multi-agent system with shared memory across agent interactions | Collaborative agents with memory | Agent coordination, shared memory, task-based workflows |
+| 🌊 [Digital Ocean AI](./examples/integrations/digital_ocean_example.py) | Memory-enhanced customer support using Digital Ocean's AI platform | Customer support assistant with conversation history | Context injection, session continuity, support analytics |
+| 🔗 [LangChain](./examples/integrations/langchain_example.py) | Enterprise-grade agent framework with advanced memory integration | AI assistant with LangChain tools and memory | Custom tools, agent executors, memory persistence, error handling |
+| � [OpenAI Agent](./examples/integrations/openai_agent_example.py) | Memory-enhanced OpenAI Agent with function calling and user preference tracking | Interactive assistant with memory search and user info storage | Function calling tools, memory search, preference tracking, async conversations |
+| �🚀 [Swarms](./examples/integrations/swarms_example.py) | Multi-agent system framework with persistent memory capabilities | Memory-enhanced Swarms agents with auto/conscious ingestion | Agent memory persistence, multi-agent coordination, contextual awareness |
+
+## Interactive Demos
+
+Explore Memori's capabilities through these interactive demonstrations:
+
+| Title | Description | Tools Used | Live Demo |
+|------------|-------------|------------|-----------|
+| 🌟 [Personal Diary Assistant](./demos/personal_diary_assistant/) | A comprehensive diary assistant with mood tracking, pattern analysis, and personalized recommendations. | Streamlit, LiteLLM, OpenAI, SQLite | [Run Demo](https://personal-diary-assistant.streamlit.app/) |
+| 🌍 [Travel Planner Agent](./demos/travel_planner/) | Intelligent travel planning with CrewAI agents, real-time web search, and memory-based personalization. Plans complete itineraries with budget analysis. | CrewAI, Streamlit, OpenAI, SQLite |  |
+| 🧑‍🔬 [Researcher Agent](./demos/researcher_agent/) | Advanced AI research assistant with persistent memory, real-time web search, and comprehensive report generation. Builds upon previous research sessions. | Agno, Streamlit, OpenAI, ExaAI, SQLite | [Run Demo](https://researcher-agent-memori.streamlit.app/) |
+
 ## 🤝 Contributing
 
-See [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup and guidelines.
+- See [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup and guidelines.
+- Community: [Discord](https://www.gibsonai.com/discord)
 
 ## 📄 License
 

{memorisdk-1.0.1 → memorisdk-2.0.0}/README.md

@@ -1,12 +1,35 @@
-# Memori
-
-**The Open-Source Memory Layer for AI Agents & Multi-Agent Systems v1.2**
-
-*Give your AI agents structured, persistent memory with intelligent context injection - no more repeating yourself!*
-
-[![PyPI version](https://badge.fury.io/py/memori.svg)](https://badge.fury.io/py/memori)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![GibsonAI](https://github.com/user-attachments/assets/878e341b-5a93-4489-a398-abeca91b6b11)](https://gibsonai.com/)
+
+# memori
+
+<p align="center">
+  <strong>Open-Source Memory Engine for LLMs, AI Agents & Multi-Agent Systems</strong>
+</p>
+
+<p align="center">
+  <i>Make LLMs context-aware with human-like memory, dual-mode retrieval, and automatic context injection.</i>
+</p>
+
+<p align="center">
+  <a href="https://memori.gibsonai.com/docs">Learn more</a>
+  ·
+  <a href="https://www.gibsonai.com/discord">Join Discord</a>
+</p>
+
+<p align="center">
+  <a href="https://badge.fury.io/py/memorisdk">
+    <img src="https://badge.fury.io/py/memori.svg" alt="PyPI version">
+  </a>
+  <a href="https://pepy.tech/projects/memorisdk">
+    <img src="https://static.pepy.tech/badge/memorisdk" alt="Downloads">
+  </a>
+  <a href="https://opensource.org/licenses/MIT">
+    <img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT">
+  </a>
+  <a href="https://www.python.org/downloads/">
+    <img src="https://img.shields.io/badge/python-3.8+-blue.svg" alt="Python 3.8+">
+  </a>
+</p>
 
 ---
 
@@ -20,32 +43,72 @@
 
 ## ⚡ Quick Start
 
+Install Memori:
+
 ```bash
 pip install memorisdk
 ```
 
+### Example with OpenAI
+
+1. Install OpenAI:
+
+```bash
+pip install openai
+```
+
+2. Set OpenAI API Key:
+
+```bash
+export OPENAI_API_KEY="sk-your-openai-key-here"
+```
+
+3. Run this Python script:
+
 ```python
 from memori import Memori
+from openai import OpenAI
 
-# Create your workspace memory with conscious mode
-office_work = Memori(
-    database_connect="sqlite:///office_memory.db",
-    conscious_ingest=True,  # Short-term working memory (one-shot context)
-    openai_api_key="your-key"
-)
+# Initialize OpenAI client
+openai_client = OpenAI()
 
-office_work.enable()  # Start recording conversations
+# Initialize memory
+memori = Memori(conscious_ingest=True)
+memori.enable()
 
-# Use ANY LLM library - context automatically injected!
-from litellm import completion
+print("=== First Conversation - Establishing Context ===")
+response1 = openai_client.chat.completions.create(
+    model="gpt-4o-mini",
+    messages=[{
+        "role": "user", 
+        "content": "I'm working on a Python FastAPI project"
+    }]
+)
 
-response = completion(
-    model="gpt-4o", 
-    messages=[{"role": "user", "content": "Help me with Python testing"}]
+print("Assistant:", response1.choices[0].message.content)
+print("\n" + "="*50)
+print("=== Second Conversation - Memory Provides Context ===")
+
+response2 = openai_client.chat.completions.create(
+    model="gpt-4o-mini", 
+    messages=[{
+        "role": "user",
+        "content": "Help me add user authentication"
+    }]
 )
-# ✨ Short-term working memory automatically included once per session
+print("Assistant:", response2.choices[0].message.content)
+print("\n💡 Notice: Memori automatically knows about your FastAPI Python project!")
 ```
 
+---
+
+**🚀 Ready to explore more?**
+- [📖 Examples](#examples) - Basic usage patterns and code samples
+- [🔌 Framework Integrations](#framework-integrations) - LangChain, Agno & CrewAI examples  
+- [🎮 Interactive Demos](#interactive-demos) - Live applications & tutorials
+
+---
+
 ## 🧠 How It Works
 
 ### 1. **Universal Recording**
@@ -212,15 +275,15 @@ Works with **ANY** LLM library:
 ```python
 memori.enable()  # Enable universal recording
 
-# LiteLLM (recommended)
-from litellm import completion
-completion(model="gpt-4", messages=[...])
-
 # OpenAI
-import openai
-client = openai.OpenAI()
+from openai import OpenAI
+client = OpenAI()
 client.chat.completions.create(...)
 
+# LiteLLM
+from litellm import completion
+completion(model="gpt-4", messages=[...])
+
 # Anthropic  
 import anthropic
 client = anthropic.Anthropic()
@@ -293,7 +356,7 @@ memori/
 └── tools/          # Memory search tools
 ```
 
-## 🚀 Examples
+## Examples
 
 - **[Basic Usage](./examples/basic_usage.py)** - Simple memory setup with conscious ingestion
 - **[Personal Assistant](./examples/personal_assistant.py)** - AI assistant with intelligent memory
@@ -301,9 +364,33 @@ memori/
 - **[Advanced Config](./examples/advanced_config.py)** - Production configuration
 - **[Interactive Demo](./memori_example.py)** - Live conscious ingestion showcase
 
+## Framework Integrations
+
+Memori works seamlessly with popular AI frameworks:
+
+| Framework | Description | Example | Features |
+|-----------|-------------|---------|----------|
+| 🤖 [Agno](./examples/integrations/agno_example.py) | Memory-enhanced agent framework integration with persistent conversations | Simple chat agent with memory search | Memory tools, conversation persistence, contextual responses |
+| 👥 [CrewAI](./examples/integrations/crewai_example.py) | Multi-agent system with shared memory across agent interactions | Collaborative agents with memory | Agent coordination, shared memory, task-based workflows |
+| 🌊 [Digital Ocean AI](./examples/integrations/digital_ocean_example.py) | Memory-enhanced customer support using Digital Ocean's AI platform | Customer support assistant with conversation history | Context injection, session continuity, support analytics |
+| 🔗 [LangChain](./examples/integrations/langchain_example.py) | Enterprise-grade agent framework with advanced memory integration | AI assistant with LangChain tools and memory | Custom tools, agent executors, memory persistence, error handling |
+| � [OpenAI Agent](./examples/integrations/openai_agent_example.py) | Memory-enhanced OpenAI Agent with function calling and user preference tracking | Interactive assistant with memory search and user info storage | Function calling tools, memory search, preference tracking, async conversations |
+| �🚀 [Swarms](./examples/integrations/swarms_example.py) | Multi-agent system framework with persistent memory capabilities | Memory-enhanced Swarms agents with auto/conscious ingestion | Agent memory persistence, multi-agent coordination, contextual awareness |
+
+## Interactive Demos
+
+Explore Memori's capabilities through these interactive demonstrations:
+
+| Title | Description | Tools Used | Live Demo |
+|------------|-------------|------------|-----------|
+| 🌟 [Personal Diary Assistant](./demos/personal_diary_assistant/) | A comprehensive diary assistant with mood tracking, pattern analysis, and personalized recommendations. | Streamlit, LiteLLM, OpenAI, SQLite | [Run Demo](https://personal-diary-assistant.streamlit.app/) |
+| 🌍 [Travel Planner Agent](./demos/travel_planner/) | Intelligent travel planning with CrewAI agents, real-time web search, and memory-based personalization. Plans complete itineraries with budget analysis. | CrewAI, Streamlit, OpenAI, SQLite |  |
+| 🧑‍🔬 [Researcher Agent](./demos/researcher_agent/) | Advanced AI research assistant with persistent memory, real-time web search, and comprehensive report generation. Builds upon previous research sessions. | Agno, Streamlit, OpenAI, ExaAI, SQLite | [Run Demo](https://researcher-agent-memori.streamlit.app/) |
+
 ## 🤝 Contributing
 
-See [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup and guidelines.
+- See [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup and guidelines.
+- Community: [Discord](https://www.gibsonai.com/discord)
 
 ## 📄 License
 
@@ -311,4 +398,4 @@ MIT License - see [LICENSE](./LICENSE) for details.
 
 ---
 
-*Made for developers who want their AI agents to remember and learn*
+*Made for developers who want their AI agents to remember and learn*

{memorisdk-1.0.1 → memorisdk-2.0.0}/memori/__init__.py

@@ -5,13 +5,11 @@ Professional-grade memory layer with comprehensive error handling, configuration
 management, and modular architecture for production AI systems.
 """
 
-__version__ = "1.0.0"
+__version__ = "2.0.0"
 __author__ = "Harshal More"
 __email__ = "harshalmore2468@gmail.com"
 
-# Memory agents
-from .agents.memory_agent import MemoryAgent
-from .agents.retrieval_agent import MemorySearchEngine
+from typing import Any, Optional
 
 # Configuration system
 from .config import (
@@ -72,7 +70,22 @@ from .utils import (  # Pydantic models; Enhanced exceptions; Validators and hel
     get_logger,
 )
 
-__all__ = [
+# Memory agents (dynamically imported to avoid import errors)
+MemoryAgent: Optional[Any] = None
+MemorySearchEngine: Optional[Any] = None
+_AGENTS_AVAILABLE = False
+
+try:
+    from .agents.memory_agent import MemoryAgent
+    from .agents.retrieval_agent import MemorySearchEngine
+
+    _AGENTS_AVAILABLE = True
+except ImportError:
+    # Agents are not available, use placeholder None values
+    pass
+
+# Build __all__ list dynamically based on available components
+_all_components = [
     # Core
     "Memori",
     "DatabaseManager",
@@ -82,9 +95,6 @@ __all__ = [
     "AgentSettings",
     "LoggingSettings",
     "ConfigManager",
-    # Agents
-    "MemoryAgent",
-    "MemorySearchEngine",
     # Database
     "SQLiteConnector",
     "PostgreSQLConnector",
@@ -138,3 +148,9 @@ __all__ = [
     "LoggingManager",
     "get_logger",
 ]
+
+# Add agents only if available
+if _AGENTS_AVAILABLE:
+    _all_components.extend(["MemoryAgent", "MemorySearchEngine"])
+
+__all__ = _all_components