memra 0.2.12__tar.gz → 0.2.14__tar.gz

{memra-0.2.12 → memra-0.2.14}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.1
 Name: memra
-Version: 0.2.12
+Version: 0.2.14
 Summary: Declarative framework for enterprise workflows with MCP integration - Client SDK
 Home-page: https://github.com/memra/memra-sdk
 Author: Memra
@@ -32,10 +32,6 @@ Requires-Dist: black; extra == "dev"
 Requires-Dist: flake8; extra == "dev"
 Provides-Extra: mcp
 Requires-Dist: psycopg2-binary>=2.9.0; extra == "mcp"
-Dynamic: author
-Dynamic: home-page
-Dynamic: license-file
-Dynamic: requires-python
 
 # Memra SDK
 
@@ -56,24 +52,26 @@ Building AI-powered business workflows is hard. You need to:
 
 **Memra solves these challenges** by providing a declarative framework that lets you focus on *what* you want to accomplish, not *how* to wire everything together.
 
-## 🚀 Quick Start (5 minutes!)
+## 🚀 Quick Start (2 minutes!)
 
-**Want to see Memra in action immediately?** Check out our [Quick Start Guide](QUICK_START.md) to run the ETL demo in minutes!
-
-### Installation
+**Want to see Memra in action immediately?**
 
 ```bash
+# Install Memra
 pip install memra
-```
 
-**📖 New to Memra?** For a complete beginner-friendly setup with step-by-step instructions, see our [Detailed Installation Guide](INSTALLATION_GUIDE.md) or run our automated setup script:
-
-```bash
-# Automated setup for new users
-bash scripts/setup_newbie.sh
+# Run the ETL demo
+memra demo
 ```
 
-**🔧 Repository Structure:** This repo uses git submodules with sparse checkout to provide minimal access to infrastructure and workflow templates while keeping private content secure.
+**That's it!** The demo will automatically:
+- ✅ Set up PostgreSQL database
+- ✅ Start MCP bridge server
+- ✅ Process PDF invoices with AI vision
+- ✅ Store data in the database
+- ✅ Show you the results
+
+**📖 Need more details?** Check out our [Quick Start Guide](QUICK_START.md) for step-by-step instructions.
 
 ### Basic Example
 
@@ -139,7 +137,7 @@ Configuration for language models used by agents, supporting:
 
 ```bash
 # Run the ETL demo
-python demos/etl_invoice_processing/etl_invoice_demo.py
+memra demo
 ```
 
 This demo showcases:
@@ -241,43 +239,19 @@ Scale from prototype to production:
 ## 📚 Documentation
 
 - **[Quick Start Guide](QUICK_START.md)** - Get up and running in 5 minutes
-- **[Detailed Installation Guide](INSTALLATION_GUIDE.md)** - Complete beginner-friendly setup instructions
+- **[Installation Guide](INSTALLATION_GUIDE.md)** - Detailed setup instructions
+- **[Text-to-SQL Guide](TEXT_TO_SQL_USAGE_GUIDE.md)** - Build SQL queries with natural language
+- **[Contributing](CONTRIBUTING.md)** - How to contribute to Memra
 - **[System Architecture](memra_system_architecture.md)** - Deep dive into Memra's design
-- **[Text-to-SQL Guide](TEXT_TO_SQL_USAGE_GUIDE.md)** - Building database query workflows
-- **[Examples Directory](examples/)** - Complete working examples
-- **[Demos Directory](demos/)** - Advanced workflow demonstrations
-
-## 🏢 Use Cases
-
-### Financial Services
-- **Invoice processing** and accounts payable automation
-- **Document classification** and routing
-- **Compliance monitoring** and reporting
-- **Risk assessment** and fraud detection
-
-### Healthcare
-- **Medical record processing** and data extraction
-- **Claims processing** and validation
-- **Patient data analysis** and insights
-- **Regulatory compliance** workflows
-
-### Manufacturing
-- **Quality control** and inspection workflows
-- **Supply chain** optimization and monitoring
-- **Equipment maintenance** scheduling
-- **Production planning** and optimization
-
-### Retail & E-commerce
-- **Order processing** and fulfillment
-- **Customer service** automation
-- **Inventory management** and forecasting
-- **Market analysis** and trend detection
 
-## 🤝 Contributing
+## 🔧 Development
 
-We welcome contributions! Please see our [contributing guide](CONTRIBUTING.md) for details.
+### Prerequisites
+- Python 3.8+
+- Docker (for database and services)
+- Git
 
-### Development Setup
+### Local Development Setup
 
 ```bash
 # Clone the repository
@@ -287,33 +261,34 @@ cd memra-sdk
 # Install in development mode
 pip install -e .
 
-# Run tests
-pytest tests/
+# Run the demo
+memra demo
+```
+
+### Running Tests
+
+```bash
+# Run all tests
+python -m pytest tests/
+
+# Run specific test file
+python -m pytest tests/test_execution.py
 ```
 
 ## 📄 License
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
-### MIT License Summary
-- ✅ **Commercial use** - Use in proprietary software
-- ✅ **Modification** - Modify and distribute
-- ✅ **Distribution** - Distribute copies
-- ✅ **Private use** - Use privately
-- ❌ **Liability** - No warranty provided
-- ❌ **Warranty** - No warranty provided
+## 🤝 Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details on how to submit pull requests, report issues, and contribute to the project.
 
-## 🆘 Support
+## 📞 Support
 
+- **Documentation**: Check our guides above
 - **Issues**: [GitHub Issues](https://github.com/memra-platform/memra-sdk/issues)
 - **Discussions**: [GitHub Discussions](https://github.com/memra-platform/memra-sdk/discussions)
-- **Email**: hello@memra.com
-
-## 🔗 Related Projects
-
-- **[memra-workflows](https://github.com/memra-platform/memra-workflows)** - Production workflow templates
-- **[memra-ops](https://github.com/memra-platform/memra-ops)** - Operations and deployment tools
 
 ---
 
-**Built with ❤️ by the memra team** 
+**Ready to build AI workflows that scale?** Start with `pip install memra` and `memra demo`! 🚀 

{memra-0.2.12 → memra-0.2.14}/README.md

@@ -17,24 +17,26 @@ Building AI-powered business workflows is hard. You need to:
 
 **Memra solves these challenges** by providing a declarative framework that lets you focus on *what* you want to accomplish, not *how* to wire everything together.
 
-## 🚀 Quick Start (5 minutes!)
+## 🚀 Quick Start (2 minutes!)
 
-**Want to see Memra in action immediately?** Check out our [Quick Start Guide](QUICK_START.md) to run the ETL demo in minutes!
-
-### Installation
+**Want to see Memra in action immediately?**
 
 ```bash
+# Install Memra
 pip install memra
-```
 
-**📖 New to Memra?** For a complete beginner-friendly setup with step-by-step instructions, see our [Detailed Installation Guide](INSTALLATION_GUIDE.md) or run our automated setup script:
-
-```bash
-# Automated setup for new users
-bash scripts/setup_newbie.sh
+# Run the ETL demo
+memra demo
 ```
 
-**🔧 Repository Structure:** This repo uses git submodules with sparse checkout to provide minimal access to infrastructure and workflow templates while keeping private content secure.
+**That's it!** The demo will automatically:
+- ✅ Set up PostgreSQL database
+- ✅ Start MCP bridge server
+- ✅ Process PDF invoices with AI vision
+- ✅ Store data in the database
+- ✅ Show you the results
+
+**📖 Need more details?** Check out our [Quick Start Guide](QUICK_START.md) for step-by-step instructions.
 
 ### Basic Example
 
@@ -100,7 +102,7 @@ Configuration for language models used by agents, supporting:
 
 ```bash
 # Run the ETL demo
-python demos/etl_invoice_processing/etl_invoice_demo.py
+memra demo
 ```
 
 This demo showcases:
@@ -202,43 +204,19 @@ Scale from prototype to production:
 ## 📚 Documentation
 
 - **[Quick Start Guide](QUICK_START.md)** - Get up and running in 5 minutes
-- **[Detailed Installation Guide](INSTALLATION_GUIDE.md)** - Complete beginner-friendly setup instructions
+- **[Installation Guide](INSTALLATION_GUIDE.md)** - Detailed setup instructions
+- **[Text-to-SQL Guide](TEXT_TO_SQL_USAGE_GUIDE.md)** - Build SQL queries with natural language
+- **[Contributing](CONTRIBUTING.md)** - How to contribute to Memra
 - **[System Architecture](memra_system_architecture.md)** - Deep dive into Memra's design
-- **[Text-to-SQL Guide](TEXT_TO_SQL_USAGE_GUIDE.md)** - Building database query workflows
-- **[Examples Directory](examples/)** - Complete working examples
-- **[Demos Directory](demos/)** - Advanced workflow demonstrations
-
-## 🏢 Use Cases
-
-### Financial Services
-- **Invoice processing** and accounts payable automation
-- **Document classification** and routing
-- **Compliance monitoring** and reporting
-- **Risk assessment** and fraud detection
-
-### Healthcare
-- **Medical record processing** and data extraction
-- **Claims processing** and validation
-- **Patient data analysis** and insights
-- **Regulatory compliance** workflows
-
-### Manufacturing
-- **Quality control** and inspection workflows
-- **Supply chain** optimization and monitoring
-- **Equipment maintenance** scheduling
-- **Production planning** and optimization
-
-### Retail & E-commerce
-- **Order processing** and fulfillment
-- **Customer service** automation
-- **Inventory management** and forecasting
-- **Market analysis** and trend detection
 
-## 🤝 Contributing
+## 🔧 Development
 
-We welcome contributions! Please see our [contributing guide](CONTRIBUTING.md) for details.
+### Prerequisites
+- Python 3.8+
+- Docker (for database and services)
+- Git
 
-### Development Setup
+### Local Development Setup
 
 ```bash
 # Clone the repository
@@ -248,33 +226,34 @@ cd memra-sdk
 # Install in development mode
 pip install -e .
 
-# Run tests
-pytest tests/
+# Run the demo
+memra demo
+```
+
+### Running Tests
+
+```bash
+# Run all tests
+python -m pytest tests/
+
+# Run specific test file
+python -m pytest tests/test_execution.py
 ```
 
 ## 📄 License
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
-### MIT License Summary
-- ✅ **Commercial use** - Use in proprietary software
-- ✅ **Modification** - Modify and distribute
-- ✅ **Distribution** - Distribute copies
-- ✅ **Private use** - Use privately
-- ❌ **Liability** - No warranty provided
-- ❌ **Warranty** - No warranty provided
+## 🤝 Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details on how to submit pull requests, report issues, and contribute to the project.
 
-## 🆘 Support
+## 📞 Support
 
+- **Documentation**: Check our guides above
 - **Issues**: [GitHub Issues](https://github.com/memra-platform/memra-sdk/issues)
 - **Discussions**: [GitHub Discussions](https://github.com/memra-platform/memra-sdk/discussions)
-- **Email**: hello@memra.com
-
-## 🔗 Related Projects
-
-- **[memra-workflows](https://github.com/memra-platform/memra-workflows)** - Production workflow templates
-- **[memra-ops](https://github.com/memra-platform/memra-ops)** - Operations and deployment tools
 
 ---
 
-**Built with ❤️ by the memra team** 
+**Ready to build AI workflows that scale?** Start with `pip install memra` and `memra demo`! 🚀 

{memra-0.2.12 → memra-0.2.14}/memra/cli.py

@@ -79,15 +79,121 @@ def setup_demo_environment():
 def extract_bundled_files(demo_dir):
     """Extract files bundled with the PyPI package"""
     try:
-        # Extract from package data
-        with pkg_resources.path('memra', 'demo_files') as demo_files_path:
-            if demo_files_path.exists():
-                # Copy all files from the bundled demo_files directory
-                shutil.copytree(demo_files_path, demo_dir, dirs_exist_ok=True)
+        import pkg_resources
+        import shutil
+        from pathlib import Path
+        
+        # Extract demo files from package data
+        demo_dir.mkdir(exist_ok=True)
+        
+        # Copy the main ETL demo script
+        try:
+            demo_script = pkg_resources.resource_filename('memra', 'demos/etl_invoice_processing/etl_invoice_demo.py')
+            if Path(demo_script).exists():
+                shutil.copy2(demo_script, demo_dir / "etl_invoice_demo.py")
+                print("✅ Copied ETL demo script")
             else:
-                # Fallback: create minimal demo structure
-                create_minimal_demo(demo_dir)
-                
+                print("⚠️  ETL demo script not found in package")
+        except Exception as e:
+            print(f"⚠️  Could not copy ETL demo script: {e}")
+        
+        # Copy supporting Python files
+        demo_files = [
+            "database_monitor_agent.py",
+            "simple_pdf_processor.py", 
+            "setup_demo_data.py"
+        ]
+        
+        for file_name in demo_files:
+            try:
+                file_path = pkg_resources.resource_filename('memra', f'demos/etl_invoice_processing/{file_name}')
+                if Path(file_path).exists():
+                    shutil.copy2(file_path, demo_dir / file_name)
+                    print(f"✅ Copied {file_name}")
+                else:
+                    print(f"⚠️  {file_name} not found in package")
+            except Exception as e:
+                print(f"⚠️  Could not copy {file_name}: {e}")
+        
+        # Copy sample data directory
+        try:
+            data_source = pkg_resources.resource_filename('memra', 'demos/etl_invoice_processing/data')
+            if Path(data_source).exists():
+                data_dir = demo_dir / "data"
+                shutil.copytree(data_source, data_dir, dirs_exist_ok=True)
+                print("✅ Copied sample invoice data")
+            else:
+                print("⚠️  Sample data not found in package")
+        except Exception as e:
+            print(f"⚠️  Could not copy sample data: {e}")
+        
+        # Create memra-ops directory with docker-compose
+        ops_dir = demo_dir / "memra-ops"
+        ops_dir.mkdir(exist_ok=True)
+        
+        # Create basic docker-compose.yml
+        compose_content = """version: '3.8'
+services:
+  postgres:
+    image: postgres:15
+    environment:
+      POSTGRES_DB: local_workflow
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: postgres
+    ports:
+      - "5432:5432"
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+
+volumes:
+  postgres_data:
+"""
+        
+        with open(ops_dir / "docker-compose.yml", "w") as f:
+            f.write(compose_content)
+        
+        # Create basic MCP bridge server
+        mcp_content = """#!/usr/bin/env python3
+import asyncio
+import aiohttp
+from aiohttp import web
+import json
+
+async def health_handler(request):
+    return web.json_response({"status": "healthy"})
+
+async def execute_tool_handler(request):
+    data = await request.json()
+    tool_name = data.get('tool_name', 'unknown')
+    
+    # Mock responses for demo
+    if tool_name == 'SQLExecutor':
+        return web.json_response({
+            "success": True,
+            "results": [{"message": "Demo SQL executed"}]
+        })
+    elif tool_name == 'PostgresInsert':
+        return web.json_response({
+            "success": True,
+            "id": 1
+        })
+    else:
+        return web.json_response({
+            "success": True,
+            "message": f"Demo {tool_name} executed"
+        })
+
+app = web.Application()
+app.router.add_get('/health', health_handler)
+app.router.add_post('/execute_tool', execute_tool_handler)
+
+if __name__ == '__main__':
+    web.run_app(app, host='0.0.0.0', port=8081)
+"""
+        
+        with open(ops_dir / "mcp_bridge_server.py", "w") as f:
+            f.write(mcp_content)
+            
     except Exception as e:
         print(f"⚠️  Could not extract bundled files: {e}")
         print("Creating minimal demo structure...")
@@ -392,8 +498,32 @@ def run_etl_workflow(demo_dir):
         real_demo_script = demo_dir / "etl_invoice_demo.py"
         if real_demo_script.exists():
             print("🎯 Running real ETL workflow...")
+            print(f"📁 Working directory: {demo_dir}")
+            print(f"📄 Demo script: {real_demo_script}")
+            
+            # Check if data directory exists
+            data_dir = demo_dir / "data"
+            invoices_dir = data_dir / "invoices"
+            if invoices_dir.exists():
+                pdf_files = list(invoices_dir.glob("*.PDF"))
+                print(f"📊 Found {len(pdf_files)} PDF files in {invoices_dir}")
+                if pdf_files:
+                    print(f"   First few files: {[f.name for f in pdf_files[:3]]}")
+            else:
+                print(f"⚠️  Warning: {invoices_dir} does not exist")
+                print(f"   Available directories in {demo_dir}:")
+                for item in demo_dir.iterdir():
+                    if item.is_dir():
+                        print(f"     - {item.name}/")
+            
             print("⏱️  Processing 15 files with delays - this may take 10-15 minutes")
-            result = subprocess.run([sys.executable, str(real_demo_script)], cwd=demo_dir, timeout=1800)  # 30 minute timeout
+            
+            # Set the working directory to the demo directory so the script can find data/invoices/
+            result = subprocess.run(
+                [sys.executable, str(real_demo_script)], 
+                cwd=demo_dir,  # This is crucial - sets working directory
+                timeout=1800   # 30 minute timeout
+            )
             return result.returncode == 0
         else:
             # Fallback to simplified demo
@@ -404,6 +534,10 @@ def run_etl_workflow(demo_dir):
                 return result.returncode == 0
             else:
                 print("❌ No demo script found")
+                print(f"   Looking for: {real_demo_script}")
+                print(f"   Available files in {demo_dir}:")
+                for item in demo_dir.iterdir():
+                    print(f"     - {item.name}")
                 return False
             
     except subprocess.TimeoutExpired:

memra-0.2.14/memra/demos/etl_invoice_processing/check_after_workflow.py

@@ -0,0 +1,50 @@
+#!/usr/bin/env python3
+"""
+Check database after workflow
+"""
+
+import requests
+import json
+
+def check_database_after():
+    """Show table contents after workflow"""
+    
+    bridge_url = "http://localhost:8081"
+    bridge_secret = "test-secret-for-development"
+    
+    headers = {
+        "Content-Type": "application/json",
+        "X-Bridge-Secret": bridge_secret
+    }
+    
+    print("📊 Database contents AFTER workflow:")
+    payload = {
+        "tool_name": "SQLExecutor",
+        "input_data": {
+            "sql_query": "SELECT * FROM invoices ORDER BY id;"
+        }
+    }
+    
+    response = requests.post(f"{bridge_url}/execute_tool", json=payload, headers=headers)
+    if response.status_code == 200:
+        result = response.json()
+        if result.get("success"):
+            data = result["data"]
+            print(f"Query: {data['query']}")
+            print(f"Total Rows: {data['row_count']}")
+            print("\nAll records:")
+            for i, row in enumerate(data['results'], 1):
+                print(f"\n{i}. ID: {row['id']}")
+                print(f"   Invoice Number: {row['invoice_number']}")
+                print(f"   Vendor: {row['vendor_name']}")
+                print(f"   Date: {row['invoice_date']}")
+                print(f"   Amount: ${row['total_amount']}")
+                print(f"   Status: {row['status']}")
+                print(f"   Created: {row['created_at']}")
+        else:
+            print(f"Error: {result.get('error')}")
+    else:
+        print(f"HTTP Error: {response.status_code}")
+
+if __name__ == "__main__":
+    check_database_after() 

memra-0.2.14/memra/demos/etl_invoice_processing/check_database.py

@@ -0,0 +1,44 @@
+import psycopg2
+import json
+
+try:
+    conn = psycopg2.connect(
+        host='localhost',
+        port=5432,
+        database='memra_invoice_db',
+        user='memra',
+        password='memra123'
+    )
+    
+    cursor = conn.cursor()
+    
+    # Get detailed records
+    cursor.execute('SELECT * FROM invoices ORDER BY created_at DESC LIMIT 5;')
+    rows = cursor.fetchall()
+    
+    print('📄 Detailed Invoice Records:')
+    for row in rows:
+        print(f'\nID: {row[0]}')
+        print(f'  Invoice Number: {row[1]}')
+        print(f'  Vendor: {row[2]}')
+        print(f'  Invoice Date: {row[3]}')
+        print(f'  Due Date: {row[4]}')
+        print(f'  Total Amount: ${row[5]}')
+        print(f'  Tax Amount: ${row[6]}')
+        print(f'  Status: {row[8]}')
+        print(f'  Created: {row[9]}')
+        
+        if row[7]:  # line_items
+            try:
+                line_items = json.loads(row[7])
+                print(f'  Line Items: {len(line_items)} items')
+                for i, item in enumerate(line_items[:2]):  # Show first 2 items
+                    print(f'    {i+1}. {item.get("description", "N/A")} - Qty: {item.get("quantity", "N/A")} @ ${item.get("unit_price", "N/A")}')
+            except:
+                print(f'  Line Items: {row[7]}')
+    
+    cursor.close()
+    conn.close()
+    
+except Exception as e:
+    print(f'❌ Database connection failed: {e}') 

memra-0.2.14/memra/demos/etl_invoice_processing/check_recent_db.py

@@ -0,0 +1,42 @@
+import psycopg2
+from datetime import datetime
+
+# Database connection
+conn = psycopg2.connect(
+    host="localhost",
+    database="local_workflow",
+    user="postgres",
+    password="postgres",
+    port=5433
+)
+
+try:
+    with conn.cursor() as cur:
+        # Get the 10 most recent records
+        cur.execute("""
+            SELECT id, vendor_name, invoice_number, invoice_date, due_date, 
+                   total_amount, tax_amount, created_at
+            FROM invoices
+            ORDER BY id DESC
+            LIMIT 10
+        """)
+        
+        records = cur.fetchall()
+        
+        if records:
+            print("🔍 Most Recent Invoice Records:\n")
+            for record in records:
+                id, vendor, invoice_num, inv_date, due_date, total, tax, created = record
+                print(f"ID: {id} (Created: {created})")
+                print(f"  Vendor: {vendor}")
+                print(f"  Invoice #: {invoice_num}")
+                print(f"  Invoice Date: {inv_date}")
+                print(f"  Due Date: {due_date}")
+                print(f"  Total: ${total:.2f}")
+                print(f"  Tax: ${tax:.2f}")
+                print("-" * 40)
+        else:
+            print("No records found in database")
+            
+finally:
+    conn.close()