memorisdk 1.0.1__py3-none-any.whl → 1.0.2__py3-none-any.whl

memori/core/memory.py

@@ -89,6 +89,7 @@ class Memori:
         self.search_engine = None
         self.conscious_agent = None
         self._background_task = None
+        self._conscious_init_pending = False
 
         if conscious_ingest or auto_ingest:
             try:
@@ -168,16 +169,44 @@ class Memori:
                 "Conscious-ingest: Starting conscious agent analysis at startup"
             )
 
-            # Run conscious agent analysis in background
-            if self._background_task is None or self._background_task.done():
-                self._background_task = asyncio.create_task(
-                    self._run_conscious_initialization()
+            # Check if there's a running event loop
+            try:
+                loop = asyncio.get_running_loop()
+                # If we're in an event loop, create the task
+                if self._background_task is None or self._background_task.done():
+                    self._background_task = loop.create_task(
+                        self._run_conscious_initialization()
+                    )
+                    logger.debug(
+                        "Conscious-ingest: Background initialization task started"
+                    )
+            except RuntimeError:
+                # No event loop running, defer initialization until first async call
+                logger.debug(
+                    "Conscious-ingest: No event loop available, deferring initialization"
                 )
-                logger.debug("Conscious-ingest: Background initialization task started")
+                self._conscious_init_pending = True
 
         except Exception as e:
             logger.error(f"Failed to initialize conscious memory: {e}")
 
+    def _check_deferred_initialization(self):
+        """Check and handle deferred conscious memory initialization"""
+        if self._conscious_init_pending and self.conscious_agent:
+            try:
+                loop = asyncio.get_running_loop()
+                if self._background_task is None or self._background_task.done():
+                    self._background_task = loop.create_task(
+                        self._run_conscious_initialization()
+                    )
+                    logger.debug(
+                        "Conscious-ingest: Deferred initialization task started"
+                    )
+                    self._conscious_init_pending = False
+            except RuntimeError:
+                # Still no event loop, keep pending
+                pass
+
     async def _run_conscious_initialization(self):
         """Run conscious agent initialization in background"""
         try:
@@ -475,6 +504,8 @@ class Memori:
     def _inject_openai_context(self, kwargs):
         """Inject context for OpenAI calls"""
         try:
+            # Check for deferred conscious initialization
+            self._check_deferred_initialization()
             # Extract user input from messages
             user_input = ""
             for msg in reversed(kwargs.get("messages", [])):
@@ -513,6 +544,8 @@ class Memori:
     def _inject_anthropic_context(self, kwargs):
         """Inject context for Anthropic calls"""
         try:
+            # Check for deferred conscious initialization
+            self._check_deferred_initialization()
             # Extract user input from messages
             user_input = ""
             for msg in reversed(kwargs.get("messages", [])):
@@ -563,6 +596,8 @@ class Memori:
             mode: "conscious" (one-shot short-term) or "auto" (continuous retrieval)
         """
         try:
+            # Check for deferred conscious initialization
+            self._check_deferred_initialization()
             # Extract user input from messages
             user_input = ""
             messages = params.get("messages", [])

{memorisdk-1.0.1.dist-info → memorisdk-1.0.2.dist-info}/METADATA

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: memorisdk
-Version: 1.0.1
+Version: 1.0.2
 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
@@ -70,15 +70,38 @@ Requires-Dist: litellm>=1.0.0; extra == "all"
 Requires-Dist: anthropic>=0.3.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://gibsonai.github.io/memori/">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 +115,69 @@ Dynamic: license-file
 
 ## ⚡ Quick Start
 
+Install Memori:
+
 ```bash
 pip install memorisdk
 ```
 
+### Example with LiteLLM
+
+1. Install LiteLLM:
+
+```bash
+pip install litellm
+```
+
+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 litellm import completion
 
-# 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 memory
+memori = Memori(conscious_ingest=True)
+memori.enable()
 
-office_work.enable()  # Start recording conversations
+print("=== First Conversation - Establishing Context ===")
+response1 = completion(
+    model="gpt-4o-mini",
+    messages=[{
+        "role": "user", 
+        "content": "I'm working on a Python FastAPI project"
+    }]
+)
 
-# Use ANY LLM library - context automatically injected!
-from litellm import completion
+print("Assistant:", response1.choices[0].message.content)
+print("\n" + "="*50)
+print("=== Second Conversation - Memory Provides Context ===")
 
-response = completion(
-    model="gpt-4o", 
-    messages=[{"role": "user", "content": "Help me with Python testing"}]
+response2 = completion(
+    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**
@@ -365,7 +425,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 +433,32 @@ 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 |
+| 🚀 [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.dist-info → memorisdk-1.0.2.dist-info}/RECORD

@@ -8,7 +8,7 @@ memori/config/manager.py,sha256=xi8d8xW3obyV6v9UHDG6idSAymge8yWxGW11e2mI0nQ,1038
 memori/config/settings.py,sha256=nrrWD4hwdbtYlIPtJFHgGyMudGP-hz9sA-KBW_7ZZbE,9724
 memori/core/__init__.py,sha256=jvhHn-KL3bzRHs11-4B0BCKH6gkAf6Gf_G59If8fD0M,157
 memori/core/database.py,sha256=eok8lvXvFbHk_H2TEiYnRAX5nVE0xQgE0TUigRfGovs,36248
-memori/core/memory.py,sha256=nYPqO4dCzKEzVxYKJn4OvrSz7zq3vQ3gUpGkpZ1B88A,53313
+memori/core/memory.py,sha256=8xF7Yi1k13OkNGisc_ehY_iuU3E0qTHiSc_mnw2iouk,54955
 memori/database/__init__.py,sha256=kMLxwfRfTVvw0oV1kl9v-Dkyqm6ggcsMV6hltqdrN3k,189
 memori/database/connectors/__init__.py,sha256=tG283nMRMWWM3B4WBfi7PMYnSUcH2Go5C88O91dOjcE,275
 memori/database/connectors/mysql_connector.py,sha256=P9tahYczjgfm_0iZpD1OxekeXLXnbpKt9M9EEe9NAjU,4861
@@ -36,9 +36,9 @@ memori/utils/logging.py,sha256=HXf3UrE0cm72KvFwyCjE7237opIxdNqzqxQQauhrX34,7131
 memori/utils/pydantic_models.py,sha256=U9nVy3Dko1X_dS4PpA7z2aacqegSSwOmZvQzPuVRcA0,8047
 memori/utils/schemas.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 memori/utils/validators.py,sha256=2btILpEh2yBS_6rytp2B2epFxMT4876SibS0yNj6bKI,11287
-memorisdk-1.0.1.dist-info/licenses/LICENSE,sha256=gyrDaYsSODngoYE1l68l_UfjppS-oYDrf1MvY1JGhgE,10430
-memorisdk-1.0.1.dist-info/METADATA,sha256=NlWPctmdLlWel35LPLNMIgKjzbpSsHCebqZ5mU_nsUk,12989
-memorisdk-1.0.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-memorisdk-1.0.1.dist-info/entry_points.txt,sha256=ir3aWDbFfKGKQlnJCW440GQ2saYNznptoXWheOUtu5c,43
-memorisdk-1.0.1.dist-info/top_level.txt,sha256=Nm3ad0isbJYBzTEce-O_gmkAEiTbAbyilgAhRt8IoGA,7
-memorisdk-1.0.1.dist-info/RECORD,,
+memorisdk-1.0.2.dist-info/licenses/LICENSE,sha256=gyrDaYsSODngoYE1l68l_UfjppS-oYDrf1MvY1JGhgE,10430
+memorisdk-1.0.2.dist-info/METADATA,sha256=KlUMw305S5PF68k0fxmS4ByYTLmEPrguzlr3FyzgqbI,16784
+memorisdk-1.0.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+memorisdk-1.0.2.dist-info/entry_points.txt,sha256=ir3aWDbFfKGKQlnJCW440GQ2saYNznptoXWheOUtu5c,43
+memorisdk-1.0.2.dist-info/top_level.txt,sha256=Nm3ad0isbJYBzTEce-O_gmkAEiTbAbyilgAhRt8IoGA,7
+memorisdk-1.0.2.dist-info/RECORD,,