Quick Start Guide#

from memofai import create_moa_client

# Initialize client
client = create_moa_client(
    api_token='moa_your_token_here',  # Replace with your token!
    environment='production'
)

# Create a workspace
print("📁 Creating workspace...")
workspace = client.workspaces.create({
    'name': 'Quick Start Project',
    'description': 'My first Memof.ai app!'
})
print(f"✅ Workspace created: {workspace['name']} (ID: {workspace['id']})")

# Create a bot
print("\n🤖 Creating bot...")
bot = client.bots.create({
    'name': 'Quick Start Bot',
    'workspace_id': workspace['id'],
    'description': 'Learning to remember things!'
})
print(f"✅ Bot created: {bot['name']} (ID: {bot['id']})")

# Store some memories
print("\n🧠 Storing memories...")
memories_to_store = [
    "User prefers Python over JavaScript",
    "User loves clean, readable code",
    "User is building an AI application",
    "User's favorite framework is FastAPI"
]

for content in memories_to_store:
    memory = client.memories.create({
        'bot_id': bot['id'],
        'content': content
    })
    print(f"  ✓ Stored: {content}")

# Search memories
print("\n🔍 Searching memories...")
results = client.memories.search({
    'bot_id': bot['id'],
    'query': 'programming language preferences',
    'limit': 5
})

print(f"\n📊 Found {len(results)} relevant memories:")
for i, result in enumerate(results, 1):
    print(f"{i}. {result['content']}")

print("\n🎉 Success! Your AI now has permanent memory!")

# Python
client = create_moa_client(
    api_token='moa_...',
    environment='production'  # ← Important!
)

import time

# Add small delay
time.sleep(0.1)  # 100ms between requests

# ✅ Good
"User Sarah from Acme Corp prefers email communication, timezone EST"

# ❌ Bad  
"user email"

# You can search by concept, not exact words!
search(query="customer contact preferences")
# Will find: "Sarah prefers email", "John likes phone calls", etc.

# Different bots for different purposes
user_context_bot = create_bot('User Context')
conversation_bot = create_bot('Conversation History')
knowledge_bot = create_bot('Product Knowledge')

# ✅ Store important stuff
"User is working on authentication module"

# ❌ Don't store everything
"User pressed button"  # Too granular!

# ✅ With context
"Customer reported login issue on 2025-01-15, resolved with password reset"

# ❌ Without context
"login issue"  # When? Who? How resolved?

from memofai import create_moa_client
import os

class UserMemoryManager:
    """Manages memories for a user in your app"""
    
    def __init__(self, user_id: str):
        self.client = create_moa_client(
            api_token=os.getenv('MEMOFAI_TOKEN'),
            environment='production'
        )
        self.user_id = user_id
        self.bot_id = self._get_or_create_bot()
    
    def _get_or_create_bot(self):
        """Get or create bot for this user"""
        # In production, you'd cache this!
        bots = self.client.bots.list()
        user_bot = next(
            (b for b in bots if b['name'] == f'user_{self.user_id}'),
            None
        )
        
        if not user_bot:
            workspace = self.client.workspaces.list()[0]
            user_bot = self.client.bots.create({
                'name': f'user_{self.user_id}',
                'workspace_id': workspace['id']
            })
        
        return user_bot['id']
    
    def remember(self, content: str):
        """Store a memory"""
        return self.client.memories.create({
            'bot_id': self.bot_id,
            'content': content
        })
    
    def recall(self, query: str, limit: int = 5):
        """Search memories"""
        return self.client.memories.search({
            'bot_id': self.bot_id,
            'query': query,
            'limit': limit
        })
    
    def get_all_memories(self):
        """Get all memories for this user"""
        return self.client.memories.list({
            'bot_id': self.bot_id
        })

# Usage
manager = UserMemoryManager(user_id='123')

# Store preferences
manager.remember("User prefers dark mode and compact layout")
manager.remember("User is working on API integration project")

# Later, recall context
preferences = manager.recall("UI preferences")
project_context = manager.recall("current project")

print(f"UI Preferences: {preferences[0]['content']}")
print(f"Project: {project_context[0]['content']}")