cloudkit 0.1.0__py3-none-any.whl

cloudkit-0.1.0.dist-info/METADATA

@@ -0,0 +1,421 @@
+Metadata-Version: 2.4
+Name: cloudkit
+Version: 0.1.0
+Summary: Python cloud abstraction SDK for databases and AI services on Azure and AWS
+Author-email: sleepeatai <sleepeatai@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: abstraction,ai,aws,azure,cloud,database,multi-cloud,sdk
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Requires-Dist: aioboto3>=12.3.0
+Requires-Dist: asyncio-throttle>=1.0.2
+Requires-Dist: azure-ai-textanalytics>=5.3.0
+Requires-Dist: azure-cosmos>=4.5.1
+Requires-Dist: azure-data-tables>=12.4.4
+Requires-Dist: azure-search-documents>=11.4.0
+Requires-Dist: azure-servicebus>=7.11.4
+Requires-Dist: azure-storage-blob>=12.19.0
+Requires-Dist: boto3>=1.34.0
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: jinja2>=3.1.5
+Requires-Dist: openai>=1.8.0
+Requires-Dist: orjson>=3.10.15
+Requires-Dist: pydantic-settings>=2.7.1
+Requires-Dist: pydantic>=2.10.6
+Requires-Dist: pyyaml>=6.0.2
+Description-Content-Type: text/markdown
+
+# Agentic Composer SDK
+
+A Python cloud abstraction SDK that provides a unified interface for databases and AI services across Azure and AWS. This SDK allows you to build cloud-agnostic microservices that can easily switch between cloud providers without changing your application code.
+
+## Features
+
+### 🗄️ Database Services
+- **Azure**: Cosmos DB (NoSQL & Table API), Blob Storage
+- **AWS**: DynamoDB, S3
+
+### 🤖 AI Services
+- **Text Analysis**: Sentiment analysis, entity recognition, key phrase extraction
+- **Chat Completion**: GPT models via Azure OpenAI or AWS Bedrock
+- **Embeddings**: Text-to-vector conversion for similarity search
+- **Search**: Azure Cognitive Search or AWS OpenSearch
+
+### 📨 Messaging Services
+- **Azure**: Service Bus
+- **AWS**: SQS
+
+## Installation
+
+1. Install required tools:
+```bash
+python3 -m pip install keyring artifacts-keyring
+```
+
+2. Configure Azure Artifacts authentication:
+```bash
+keyring set artifacts.dev.azure.com Consulting-DTT-AI-Integration-Services <your-PAT>
+```
+
+3. Install the package:
+```bash
+python3 -m pip install cloudabstractor
+```
+
+```bash
+# Install from source
+git clone <repository-url>
+cd agentic-composer-sdk
+pip install -e .
+
+# Or install from PyPI (once published)
+pip install agentic-composer-sdk
+```
+
+## Quick Start
+
+```python
+import asyncio
+from agentic_composer_sdk import CloudProvider
+
+async def main():
+    # Initialize for Azure
+    azure_config = {
+        "cloud_provider": "azure",
+        "azure_openai_api_key": "your-key",
+        "azure_openai_endpoint": "your-endpoint",
+        "azure_storage_connection_string": "your-connection-string"
+    }
+
+    cloud = CloudProvider(provider_type="azure", config=azure_config)
+
+    # Use AI services
+    sentiment = await cloud.analyze_text_sentiment("I love this SDK!")
+    print(f"Sentiment: {sentiment}")
+
+    # Store files
+    await cloud.store_file("data/document.txt", b"Hello World!")
+
+    # Chat with AI
+    messages = [{"role": "user", "content": "What is cloud computing?"}]
+    response = await cloud.chat_with_ai(messages)
+    print(response['choices'][0]['message']['content'])
+
+asyncio.run(main())
+```
+
+## Architecture
+
+The SDK uses an abstract interface pattern to provide cloud-agnostic services:
+
+```
+┌─────────────────┐    ┌─────────────────┐
+│   Your App      │    │   CloudProvider │
+│                 │◄──►│                 │
+└─────────────────┘    └─────────────────┘
+                                │
+                    ┌───────────┼───────────┐
+                    │           │           │
+            ┌───────▼──┐   ┌────▼──┐   ┌───▼──────┐
+            │ Azure    │   │ AWS   │   │ Future   │
+            │ Services │   │Services│   │ Providers│
+            └──────────┘   └───────┘   └──────────┘
+```
+
+## Configuration
+
+### Environment Variables
+
+You can configure the SDK using environment variables:
+
+```bash
+# Azure Configuration
+export CLOUD_SDK_CLOUD_PROVIDER=azure
+export CLOUD_SDK_AZURE__AZURE_OPENAI_API_KEY=your-key
+export CLOUD_SDK_AZURE__AZURE_OPENAI_ENDPOINT=your-endpoint
+export CLOUD_SDK_AZURE__AZURE_STORAGE_CONNECTION_STRING=your-connection-string
+
+# AWS Configuration
+export CLOUD_SDK_CLOUD_PROVIDER=aws
+export CLOUD_SDK_AWS__AWS_ACCESS_KEY_ID=your-key-id
+export CLOUD_SDK_AWS__AWS_SECRET_ACCESS_KEY=your-secret-key
+export CLOUD_SDK_AWS__AWS_REGION=us-east-1
+```
+
+### Configuration Dictionary
+
+```python
+from agentic_composer_sdk import CloudProvider
+
+# Azure configuration
+azure_config = {
+    "cloud_provider": "azure",
+    "azure_storage_connection_string": "...",
+    "azure_storage_container_name": "my-container",
+    "azure_openai_api_key": "...",
+    "azure_openai_endpoint": "...",
+    "azure_cognitive_services_endpoint": "...",
+    "azure_cognitive_services_key": "...",
+    "azure_search_service_name": "...",
+    "azure_search_admin_key": "..."
+}
+
+# AWS configuration
+aws_config = {
+    "cloud_provider": "aws",
+    "aws_access_key_id": "...",
+    "aws_secret_access_key": "...",
+    "aws_region": "us-east-1",
+    "aws_s3_bucket_name": "my-bucket",
+    "aws_opensearch_endpoint": "..."
+}
+```
+
+## Service Examples
+
+### Storage Services
+
+```python
+# Upload and download files
+storage = cloud.get_storage_service()
+
+# Upload
+url = await storage.upload_file("path/to/file.txt", file_data)
+
+# Download
+data = await storage.download_file("path/to/file.txt")
+
+# Get presigned URL
+signed_url = await storage.get_file_url("path/to/file.txt")
+
+# List files
+files = await storage.list_files("path/prefix/")
+```
+
+### Database Services
+
+```python
+# NoSQL operations
+db = cloud.get_db_nosql_service()
+
+# Store document
+await db.put_item("table_name", {
+    "id": "doc_1",
+    "title": "My Document",
+    "content": "Document content..."
+})
+
+# Retrieve document
+doc = await db.get_item("table_name", {"id": "doc_1"})
+
+# Query documents
+results = await db.query("table_name", {
+    "query": "SELECT * FROM c WHERE c.title = @title",
+    "parameters": [{"name": "@title", "value": "My Document"}]
+})
+```
+
+### AI Services
+
+```python
+# Text Analysis
+text_analyzer = cloud.get_text_analysis_service()
+
+sentiment = await text_analyzer.analyze_sentiment("I love this product!")
+entities = await text_analyzer.recognize_entities("John works at Microsoft")
+key_phrases = await text_analyzer.extract_key_phrases("Cloud computing benefits")
+
+# Chat Completion
+chat = cloud.get_chat_service()
+
+messages = [
+    {"role": "system", "content": "You are a helpful assistant"},
+    {"role": "user", "content": "Explain machine learning"}
+]
+response = await chat.chat_completion(messages, temperature=0.7)
+
+# Streaming chat
+async for chunk in chat.stream_chat_completion(messages):
+    print(chunk['choices'][0]['delta']['content'], end='')
+
+# Embeddings
+embedding_service = cloud.get_embedding_service()
+
+embeddings = await embedding_service.create_embeddings([
+    "First document text",
+    "Second document text"
+])
+
+# Search similar embeddings
+similar = await embedding_service.similarity_search(
+    query_embedding, all_embeddings, top_k=5
+)
+```
+
+### Search Services
+
+```python
+search = cloud.get_search_service()
+
+# Index document
+await search.index_document("my_index", "doc_1", {
+    "id": "doc_1",
+    "title": "Document Title",
+    "content": "Document content...",
+    "vector_field": embedding_vector
+})
+
+# Text search
+results = await search.search_documents("my_index", "search query")
+
+# Vector search
+vector_results = await search.vector_search("my_index", query_vector)
+```
+
+## Microservice Integration
+
+Here's how to integrate the SDK into a microservice:
+
+```python
+from fastapi import FastAPI
+from agentic_composer_sdk import CloudProvider
+
+app = FastAPI()
+
+# Initialize cloud provider
+cloud = CloudProvider(provider_type="azure", config=config)
+
+@app.post("/process-document")
+async def process_document(text: str):
+    # Analyze sentiment
+    sentiment = await cloud.analyze_text_sentiment(text)
+
+    # Create embeddings
+    embeddings = await cloud.create_text_embeddings(text)
+
+    # Store in database
+    doc_data = {
+        "text": text,
+        "sentiment": sentiment,
+        "embedding": embeddings[0]
+    }
+
+    db = cloud.get_db_nosql_service()
+    await db.put_item("documents", doc_data)
+
+    return {"status": "processed", "sentiment": sentiment}
+
+@app.get("/search")
+async def search_documents(query: str):
+    # Create query embedding
+    query_embedding = await cloud.create_text_embeddings(query)
+
+    # Vector search
+    search_service = cloud.get_search_service()
+    results = await search_service.vector_search(
+        "documents", query_embedding[0], top_k=10
+    )
+
+    return {"results": results}
+```
+
+## Provider-Specific Features
+
+### Azure-Specific
+
+```python
+# Use specific Azure Cosmos DB API
+cosmos_nosql = CosmosDBService.create(config, api_type="nosql")
+cosmos_table = CosmosDBService.create(config, api_type="table")
+
+# Azure OpenAI with specific deployment
+chat_response = await azure_chat.chat_completion(
+    messages,
+    model="gpt-35-turbo-16k",  # Your deployment name
+    temperature=0.7
+)
+```
+
+### AWS-Specific
+
+```python
+# Use DynamoDB with specific query parameters
+results = await dynamodb.query("table", {
+    "KeyConditionExpression": Key("pk").eq("value"),
+    "FilterExpression": Attr("status").eq("active")
+})
+
+# Use Bedrock with specific model
+chat_response = await bedrock_chat.chat_completion(
+    messages,
+    model="anthropic.claude-3-sonnet-20240229-v1:0"
+)
+```
+
+## Testing
+
+```bash
+# Install test dependencies
+pip install -e ".[test]"
+
+# Run tests
+pytest tests/
+
+# Run with coverage
+pytest --cov=src tests/
+```
+
+## Development
+
+```bash
+# Install development dependencies
+pip install -e ".[dev]"
+
+# Format code
+black src/ tests/
+isort src/ tests/
+
+# Type checking
+mypy src/
+
+# Linting
+flake8 src/ tests/
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests
+5. Run the test suite
+6. Submit a pull request
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.
+
+## Support
+
+For support and questions:
+- Create an issue on GitHub
+- Check the examples directory for more usage patterns
+- Review the API documentation
+
+## Roadmap
+
+- [ ] Google Cloud Platform support
+- [ ] Additional AI services (speech, vision)
+- [ ] Caching layer
+- [ ] Monitoring and observability
+- [ ] Rate limiting and retry mechanisms
+- [ ] Configuration validation
+- [ ] More database providers (MongoDB, Redis)

cloudkit-0.1.0.dist-info/RECORD

@@ -0,0 +1,4 @@
+cloudkit-0.1.0.dist-info/METADATA,sha256=rNUSaCQf8ffqqK76-FG_ctVz72rA0dA7gof_Cw7Fs9g,11113
+cloudkit-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+cloudkit-0.1.0.dist-info/licenses/LICENSE,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cloudkit-0.1.0.dist-info/RECORD,,

cloudkit-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any