piyapi-memory 0.1.0__tar.gz

piyapi_memory-0.1.0/.gitignore

@@ -0,0 +1,154 @@
+# Dependencies
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+# Environment variables
+.env
+.env.*
+!.env.example
+!.env.production
+.env.railway
+.env.production.local
+
+# Build output
+dist/
+build/
+out/
+*.tsbuildinfo
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+pnpm-debug.log*
+
+# Runtime data
+pids/
+*.pid
+*.seed
+*.pid.lock
+
+# Coverage directory used by testing tools
+coverage/
+*.lcov
+.nyc_output/
+
+# IDEs and editors
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+.DS_Store
+*.sublime-project
+*.sublime-workspace
+
+# Testing
+.jest/
+test-results/
+junit.xml
+
+# Load Testing
+tests/load/results/*.json
+tests/load/results/*.html
+tests/load/reports/*.md
+tests/load/reports/*.html
+!tests/load/results/.gitkeep
+!tests/load/reports/.gitkeep
+
+# Temporary files
+tmp/
+temp/
+*.tmp
+
+# Database
+*.db
+*.sqlite
+*.sqlite3
+
+# Docker
+docker-compose.override.yml
+.dockerignore
+
+# Secrets and keys
+*.pem
+*.key
+*.cert
+secrets/
+.secrets/
+
+# Backup files
+*.backup
+*.bak
+*.old
+
+# OS files
+.DS_Store
+Thumbs.db
+Desktop.ini
+
+# Package manager
+yarn.lock
+pnpm-lock.yaml
+
+# TypeScript
+*.tsbuildinfo
+
+# Misc
+.cache/
+.parcel-cache/
+.next/
+.nuxt/
+.vercel/
+.netlify/
+
+# Local development
+.local/
+local/
+
+# Documentation build
+docs/.vitepress/dist
+docs/.vitepress/cache
+
+# Sentry
+.sentryclirc
+
+# Terraform
+*.tfstate
+*.tfstate.backup
+.terraform/
+
+# Kubernetes
+*.kubeconfig
+
+# Monitoring
+prometheus_data/
+grafana_data/
+
+
+# Production secrets (NEVER commit)
+.env.production.railway
+
+# Debug files
+debug*.ts
+debug*.log
+debug_*.log
+
+# Backup folders
+node_modules_old/
+*_old/
+
+# Duplicate folders (from failed operations)
+* 2/
+* 3/
+* 4/
+* 5/
+* 6/
+.vercel

piyapi_memory-0.1.0/.hypothesis/constants/06e3365e02b2e166

@@ -0,0 +1,4 @@
+# file: /Users/piyushkumar/Desktop/project cloud/packages/python-sdk/src/piyapi_memory/async_client.py
+# hypothesis_version: 6.148.5
+
+[0.0, 0.7, 30.0, 200, 201, 202, 204, 400, 401, 404, 429, 500, '/', '/api/v1/graph', '/api/v1/graph/stats', '/api/v1/memories', 'Accept', 'AsyncPiyAPIClient', 'Authorization', 'Content-Type', 'DELETE', 'GET', 'Invalid request', 'PATCH', 'PIYAPI_API_KEY', 'PIYAPI_BASE_URL', 'POST', 'Rate limit exceeded', 'Request timed out', 'Resource not found', 'Retry-After', 'Server error', 'User-Agent', 'application/json', 'avgConnections', 'children', 'cursor', 'default', 'depth', 'direction', 'edges', 'errors', 'has_more', 'includeGhosts', 'limit', 'maxHops', 'memories', 'memory', 'memoryId', 'message', 'metadata', 'minWeight', 'namespace', 'namespaceBreakdown', 'nodes', 'parent', 'raw', 'relationshipType', 'relationships', 'results', 'rollback', 'score', 'total', 'totalEdges', 'totalNodes', 'totalVersions', 'version', 'versions']

piyapi_memory-0.1.0/.hypothesis/constants/11a1a67f0f33ee09

@@ -0,0 +1,4 @@
+# file: /Users/piyushkumar/Desktop/project cloud/packages/python-sdk/src/piyapi_memory/__init__.py
+# hypothesis_version: 6.148.5
+
+['0.1.0', 'AsyncPiyAPIClient', 'AuthenticationError', 'GraphEdge', 'GraphNode', 'GraphResponse', 'GraphStats', 'Memory', 'MemoryList', 'MemoryRelationships', 'NetworkError', 'NotFoundError', 'PiyAPIClient', 'PiyAPIError', 'RateLimitError', 'SearchResult', 'SearchResults', 'ServerError', 'ValidationError']

piyapi_memory-0.1.0/.hypothesis/constants/2b265d3187c08e49

@@ -0,0 +1,4 @@
+# file: /Users/piyushkumar/Desktop/project cloud/packages/python-sdk/src/piyapi_memory/exceptions.py
+# hypothesis_version: 6.148.5
+
+[400, 401, 404, 429, 500, 'Invalid request', 'Network error', 'Rate limit exceeded', 'Resource not found', 'Server error']

piyapi_memory-0.1.0/.hypothesis/constants/543182aa7a4ff3ae

@@ -0,0 +1,4 @@
+# file: /Users/piyushkumar/Desktop/project cloud/packages/python-sdk/src/piyapi_memory/models.py
+# hypothesis_version: 6.148.5
+
+[0.0, 0.7, 1.0, 100, 255, 10000, 100000, 'Associated memory ID', 'Average connections', 'Child memories', 'Connected memory ID', 'Cursor for next page', 'Custom metadata', 'Display label', 'Edge metadata', 'Edges per type', 'Filter by metadata', 'Full memory content', 'Ghost node flag', 'Graph edges', 'Graph metadata', 'Graph nodes', 'List of memories', 'List of versions', 'Memory ID', 'Memory content', 'Memory namespace', 'Metadata', 'Namespace', 'Namespaces', 'Nodes per namespace', 'Parent memory', 'Relationship type', 'Relationship weight', 'Relationships', 'Rollback details', 'Search query', 'Search results', 'Source memory ID', 'Target memory ID', 'The matched memory', 'The memory ID', 'The restored memory', 'The search query', 'The source memory', 'Total edges', 'Total memory nodes', 'Total nodes', 'Updated content', 'Updated metadata', 'Updated tags', 'Version record ID', 'Weight (0-1)', 'When created', 'default', 'incoming or outgoing', 'outgoing', 'semantic_similarity']

piyapi_memory-0.1.0/.hypothesis/constants/5e5df5df602b1d1c

@@ -0,0 +1,4 @@
+# file: /Users/piyushkumar/Desktop/project cloud/packages/python-sdk/src/piyapi_memory/http_client.py
+# hypothesis_version: 6.148.5
+
+[30.0, 200, 201, 202, 204, 400, 401, 404, 429, 500, '/', 'Accept', 'Authorization', 'Content-Type', 'DELETE', 'GET', 'HTTPClient', 'Invalid request', 'PATCH', 'PIYAPI_API_KEY', 'PIYAPI_BASE_URL', 'POST', 'PUT', 'Rate limit exceeded', 'Request timed out', 'Resource not found', 'Retry-After', 'Server error', 'T', 'User-Agent', 'application/json', 'errors', 'message', 'raw']

piyapi_memory-0.1.0/.hypothesis/constants/608097f1b41df816

@@ -0,0 +1,4 @@
+# file: /Users/piyushkumar/Desktop/project cloud/packages/python-sdk/src/piyapi_memory/async_client.py
+# hypothesis_version: 6.148.5
+
+[0.0, 0.7, 30.0, 200, 201, 202, 204, 400, 401, 404, 429, 500, '/', '/api/v1/graph', '/api/v1/graph/stats', '/api/v1/memories', 'Accept', 'AsyncPiyAPIClient', 'Authorization', 'Content-Type', 'DELETE', 'GET', 'Invalid request', 'PATCH', 'PIYAPI_API_KEY', 'PIYAPI_BASE_URL', 'POST', 'Rate limit exceeded', 'Request timed out', 'Resource not found', 'Retry-After', 'Server error', 'User-Agent', 'application/json', 'avgConnections', 'cursor', 'default', 'edges', 'errors', 'has_more', 'includeGhosts', 'limit', 'maxHops', 'memories', 'memory', 'memoryId', 'message', 'metadata', 'minWeight', 'namespace', 'namespaceBreakdown', 'nodes', 'raw', 'relationshipType', 'relationships', 'results', 'score', 'total', 'totalEdges', 'totalNodes']

piyapi_memory-0.1.0/.hypothesis/constants/7358819e971e4257

@@ -0,0 +1,4 @@
+# file: /Users/piyushkumar/Desktop/project cloud/packages/python-sdk/src/piyapi_memory/__init__.py
+# hypothesis_version: 6.148.5
+
+['0.1.0', 'AsyncPiyAPIClient', 'AuthenticationError', 'GraphEdge', 'GraphNode', 'GraphResponse', 'GraphStats', 'Memory', 'MemoryList', 'MemoryRelationships', 'MemoryVersion', 'NetworkError', 'NotFoundError', 'PiyAPIClient', 'PiyAPIError', 'RateLimitError', 'RollbackResult', 'SearchResult', 'SearchResults', 'ServerError', 'ValidationError', 'VersionHistory']

piyapi_memory-0.1.0/.hypothesis/constants/98729a9607e58626

@@ -0,0 +1,4 @@
+# file: /Users/piyushkumar/Desktop/project cloud/packages/python-sdk/src/piyapi_memory/models.py
+# hypothesis_version: 6.148.5
+
+[0.0, 0.7, 1.0, 100, 255, 10000, 100000, 'Associated memory ID', 'Average connections', 'Connected memory ID', 'Cursor for next page', 'Custom metadata', 'Display label', 'Edge metadata', 'Edges per type', 'Filter by metadata', 'Full memory content', 'Ghost node flag', 'Graph edges', 'Graph metadata', 'Graph nodes', 'List of memories', 'Memory ID', 'Memory content', 'Memory namespace', 'Metadata', 'Namespace', 'Namespaces', 'Nodes per namespace', 'Relationship type', 'Relationship weight', 'Relationships', 'Search query', 'Search results', 'Source memory ID', 'Target memory ID', 'The matched memory', 'The memory ID', 'The search query', 'Total edges', 'Total memory nodes', 'Total nodes', 'Updated content', 'Updated metadata', 'Updated tags', 'Weight (0-1)', 'When created', 'default', 'incoming or outgoing', 'outgoing', 'semantic_similarity']

piyapi_memory-0.1.0/.hypothesis/constants/ba549cd877e142c6

@@ -0,0 +1,4 @@
+# file: /Users/piyushkumar/Desktop/project cloud/packages/python-sdk/src/piyapi_memory/client.py
+# hypothesis_version: 6.148.5
+
+[0.0, 0.7, 30.0, '/api/v1/graph', '/api/v1/graph/stats', '/api/v1/memories', 'PiyAPIClient', 'avgConnections', 'cursor', 'default', 'edges', 'has_more', 'includeGhosts', 'limit', 'maxHops', 'memories', 'memory', 'memoryId', 'metadata', 'minWeight', 'namespace', 'namespaceBreakdown', 'nodes', 'relationshipType', 'relationships', 'results', 'score', 'total', 'totalEdges', 'totalNodes']

piyapi_memory-0.1.0/.hypothesis/constants/c0f58e0fe91c2515

@@ -0,0 +1,4 @@
+# file: /Users/piyushkumar/Desktop/project cloud/packages/python-sdk/src/piyapi_memory/client.py
+# hypothesis_version: 6.148.5
+
+[0.0, 0.7, 30.0, '/api/v1/graph', '/api/v1/graph/stats', '/api/v1/memories', 'PiyAPIClient', 'avgConnections', 'children', 'cursor', 'default', 'depth', 'direction', 'edges', 'has_more', 'includeGhosts', 'limit', 'maxHops', 'memories', 'memory', 'memoryId', 'metadata', 'minWeight', 'namespace', 'namespaceBreakdown', 'nodes', 'parent', 'relationshipType', 'relationships', 'results', 'rollback', 'score', 'total', 'totalEdges', 'totalNodes', 'totalVersions', 'version', 'versions']

piyapi_memory-0.1.0/.hypothesis/examples/04e6b3400353b141/b7b150dbb9f9aecb

@@ -0,0 +1 @@
+m��%|���uoJ*�ˀ�O|҇i�!}�>��,+�<?��d��{��.secondary

piyapi_memory-0.1.0/.hypothesis/examples/04e6b3400353b141/f3e38a16f9f9472c

@@ -0,0 +1 @@
+m��%|���uoJ*�ˀ�O|҇i�!}�>��,+�<?��d��{��

piyapi_memory-0.1.0/.hypothesis/examples/04e6b3400353b141/f991af26f716516c

@@ -0,0 +1 @@
+����

piyapi_memory-0.1.0/.hypothesis/examples/b7b150dbb9f9aecb/89682667928112e3

@@ -0,0 +1 @@
+A

piyapi_memory-0.1.0/.hypothesis/examples/f3e38a16f9f9472c/9977e7b16d417708

@@ -0,0 +1 @@
+A

piyapi_memory-0.1.0/.hypothesis/examples/f991af26f716516c/e4201915c9a55aa8

@@ -0,0 +1 @@
+A

piyapi_memory-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 PiyAPI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

piyapi_memory-0.1.0/PKG-INFO

@@ -0,0 +1,275 @@
+Metadata-Version: 2.4
+Name: piyapi-memory
+Version: 0.1.0
+Summary: Official Python SDK for PiyAPI Memory - AI-native memory and context management
+Project-URL: Homepage, https://piyapi.cloud
+Project-URL: Documentation, https://docs.piyapi.cloud
+Project-URL: Repository, https://github.com/piyapi/piyapi-memory
+Project-URL: Changelog, https://github.com/piyapi/piyapi-memory/blob/main/CHANGELOG.md
+Author-email: PiyAPI Team <care.piyapi@outlook.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,embeddings,langchain,llm,memory,semantic-search,vector-database
+Classifier: Development Status :: 4 - Beta
+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: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: tenacity>=8.0.0
+Provides-Extra: async
+Requires-Dist: httpx[http2]>=0.24.0; extra == 'async'
+Provides-Extra: dev
+Requires-Dist: hypothesis>=6.0.0; extra == 'dev'
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: respx>=0.20.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# PiyAPI Memory Python SDK
+
+Official Python SDK for [PiyAPI Memory](https://piyapi.cloud) - AI-native memory and context management for your applications.
+
+## Installation
+
+```bash
+pip install piyapi-memory
+```
+
+For async support:
+```bash
+pip install piyapi-memory[async]
+```
+
+## Quick Start
+
+```python
+from piyapi_memory import PiyAPIClient
+
+# Initialize the client
+client = PiyAPIClient(api_key="your-api-key")
+
+# Create a memory
+memory = client.create_memory(
+    content="The user prefers dark mode and uses Python primarily.",
+    metadata={"category": "preferences", "source": "onboarding"},
+    namespace="user-123"
+)
+
+# Search memories
+results = client.semantic_search(
+    query="What are the user's preferences?",
+    namespace="user-123",
+    limit=5
+)
+
+for result in results:
+    print(f"Score: {result.score:.3f} - {result.content}")
+```
+
+## Async Usage
+
+```python
+import asyncio
+from piyapi_memory import AsyncPiyAPIClient
+
+async def main():
+    client = AsyncPiyAPIClient(api_key="your-api-key")
+    
+    # Create a memory
+    memory = await client.create_memory(
+        content="User completed the tutorial",
+        namespace="user-123"
+    )
+    
+    # Search
+    results = await client.semantic_search(
+        query="tutorial progress",
+        namespace="user-123"
+    )
+    
+    await client.close()
+
+asyncio.run(main())
+```
+
+## Features
+
+- **Memory CRUD**: Create, read, update, and delete memories
+- **Semantic Search**: Find relevant memories using natural language
+- **Keyword Search**: Traditional text-based search
+- **Hybrid Search**: Combine semantic and keyword search
+- **Namespaces**: Organize memories by user, project, or any grouping
+- **Metadata Filtering**: Filter search results by metadata
+- **Automatic Retry**: Built-in retry with exponential backoff for rate limits
+- **Type Safety**: Full type hints and Pydantic models
+
+## API Reference
+
+### Client Initialization
+
+```python
+from piyapi_memory import PiyAPIClient
+
+client = PiyAPIClient(
+    api_key="your-api-key",
+    base_url="https://api.piyapi.cloud",  # Optional, defaults to production
+    timeout=30.0,  # Request timeout in seconds
+    max_retries=3,  # Max retries on rate limit
+)
+```
+
+### Memory Operations
+
+```python
+# Create
+memory = client.create_memory(
+    content="Memory content",
+    metadata={"key": "value"},  # Optional
+    namespace="default"  # Optional
+)
+
+# Get
+memory = client.get_memory(memory_id="mem_123")
+
+# Update
+memory = client.update_memory(
+    memory_id="mem_123",
+    content="Updated content",
+    metadata={"updated": True}
+)
+
+# Delete
+client.delete_memory(memory_id="mem_123")
+
+# List
+memories = client.list_memories(
+    namespace="user-123",
+    limit=20,
+    cursor="cursor_token"  # For pagination
+)
+```
+
+### Search Operations
+
+```python
+# Semantic search
+results = client.semantic_search(
+    query="natural language query",
+    namespace="user-123",
+    limit=10,
+    threshold=0.7,  # Minimum similarity score
+    metadata_filter={"category": "preferences"}
+)
+
+# Keyword search
+results = client.keyword_search(
+    query="exact keywords",
+    namespace="user-123",
+    limit=10
+)
+
+# Hybrid search (combines semantic + keyword)
+results = client.hybrid_search(
+    query="search query",
+    namespace="user-123",
+    limit=10,
+    semantic_weight=0.7  # 0-1, weight for semantic vs keyword
+)
+```
+
+### Memory Versioning
+
+Track changes and rollback to previous versions:
+
+```python
+# Get version history
+history = client.get_versions("mem_123", limit=10)
+print(f"Total versions: {history['totalVersions']}")
+for version in history["versions"]:
+    print(f"Version {version['version']}: {version['content'][:50]}...")
+
+# Get specific version
+version2 = client.get_version("mem_123", 2)
+print(f"Version 2 content: {version2['version']['content']}")
+
+# Rollback to previous version
+result = client.rollback("mem_123", 2)
+print(f"Rolled back to version {result['rollback']['restoredVersion']}")
+```
+
+### Related Memories
+
+Get parent-child memory relationships:
+
+```python
+# Get related memories
+related = client.get_related("mem_123", direction="both", depth=2)
+
+if related.get("parent"):
+    print(f"Parent: {related['parent']['content']}")
+print(f"Children: {len(related['children'])}")
+```
+
+## Error Handling
+
+The SDK raises typed exceptions for different error conditions:
+
+```python
+from piyapi_memory import PiyAPIClient
+from piyapi_memory.exceptions import (
+    AuthenticationError,
+    RateLimitError,
+    ValidationError,
+    NotFoundError,
+    ServerError,
+)
+
+client = PiyAPIClient(api_key="your-api-key")
+
+try:
+    memory = client.create_memory(content="test")
+except AuthenticationError:
+    print("Invalid API key")
+except RateLimitError as e:
+    print(f"Rate limited. Retry after {e.retry_after} seconds")
+except ValidationError as e:
+    print(f"Invalid request: {e.message}")
+except NotFoundError:
+    print("Resource not found")
+except ServerError:
+    print("Server error, please retry")
+```
+
+## Configuration
+
+### Environment Variables
+
+```bash
+PIYAPI_API_KEY=your-api-key
+PIYAPI_BASE_URL=https://api.piyapi.cloud  # Optional
+```
+
+```python
+import os
+from piyapi_memory import PiyAPIClient
+
+# Client will use PIYAPI_API_KEY from environment
+client = PiyAPIClient()
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.