ainative-python 2.0.0__tar.gz

ainative_python-2.0.0/PKG-INFO

@@ -0,0 +1,551 @@
+Metadata-Version: 2.4
+Name: ainative-python
+Version: 2.0.0
+Summary: Official Python SDK for AINative Studio APIs with ZeroDB Local support
+Home-page: https://github.com/ainative/ainative-python
+Author: AINative Team
+Author-email: support@ainative.studio
+Project-URL: Documentation, https://docs.ainative.studio/sdk/python
+Project-URL: API Reference, https://api.ainative.studio/docs-enhanced
+Project-URL: Bug Reports, https://github.com/ainative/studio/issues
+Project-URL: Source, https://github.com/ainative/ainative-python
+Keywords: ainative,database,vector,embedding,ai,ml,machine learning,artificial intelligence,api,sdk,zerodb,agent swarm,postgresql,vector search,nosql,table operations,mongodb-style,crud
+Classifier: Development Status :: 3 - Alpha
+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 :: Database
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.31.0
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dateutil>=2.8.0
+Requires-Dist: typing-extensions>=4.7.0
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: asyncio>=3.4.3
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: PyYAML>=6.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: tenacity>=8.2.0
+Requires-Dist: backoff>=2.2.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.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-mock>=3.10.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: flake8>=5.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: isort>=5.10.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: sphinx>=5.0.0; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=1.2.0; extra == "docs"
+Requires-Dist: sphinx-autodoc-typehints>=1.19.0; extra == "docs"
+Provides-Extra: async
+Requires-Dist: aiohttp>=3.8.0; extra == "async"
+Requires-Dist: asyncio>=3.4.3; extra == "async"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# AINative Python SDK
+
+Official Python SDK for AINative Studio APIs - unified database and AI operations platform.
+
+## Features
+
+- 🚀 **Simple Integration** - Get started with just an API key
+- 🗄️ **ZeroDB Operations** - Full support for vector storage, search, and memory management
+- 🤖 **Agent Swarm** - Orchestrate multiple AI agents for complex tasks
+- 🔐 **Enterprise Security** - Multi-tenant authentication with API key management
+- ⚡ **High Performance** - Async support and connection pooling
+- 📊 **Analytics** - Built-in usage tracking and performance metrics
+
+## Installation
+
+```bash
+pip install ainative-python
+```
+
+For development version:
+```bash
+pip install git+https://github.com/ainative/ainative-python.git
+```
+
+## Quick Start
+
+```python
+from ainative import AINativeClient
+
+# Initialize client
+client = AINativeClient(api_key="your-api-key")
+
+# Create a project
+project = client.zerodb.projects.create(
+    name="My First Project",
+    description="Testing AINative SDK"
+)
+
+# Store vectors
+client.zerodb.vectors.upsert(
+    project_id=project["id"],
+    vectors=[[0.1, 0.2, 0.3], [0.4, 0.5, 0.6]],
+    metadata=[{"text": "Hello"}, {"text": "World"}]
+)
+
+# Search vectors
+results = client.zerodb.vectors.search(
+    project_id=project["id"],
+    vector=[0.15, 0.25, 0.35],
+    top_k=5
+)
+
+# Create memory
+memory = client.zerodb.memory.create(
+    content="Important information to remember",
+    tags=["tutorial", "example"]
+)
+```
+
+## Authentication
+
+### Using Environment Variables
+
+```bash
+export AINATIVE_API_KEY="your-api-key"
+export AINATIVE_API_SECRET="your-api-secret"  # Optional
+export AINATIVE_ORG_ID="your-org-id"  # For multi-tenant scenarios
+```
+
+```python
+from ainative import AINativeClient
+
+# Automatically uses environment variables
+client = AINativeClient()
+```
+
+### Direct Configuration
+
+```python
+from ainative import AINativeClient, AuthConfig
+
+auth_config = AuthConfig(
+    api_key="your-api-key",
+    api_secret="your-api-secret",  # Optional for enhanced security
+    environment="production"  # or "staging", "development"
+)
+
+client = AINativeClient(auth_config=auth_config)
+```
+
+## ZeroDB Operations
+
+### Project Management
+
+```python
+# List all projects
+projects = client.zerodb.projects.list(limit=10)
+
+# Get project details
+project = client.zerodb.projects.get(project_id="proj_123")
+
+# Update project
+client.zerodb.projects.update(
+    project_id="proj_123",
+    name="Updated Name",
+    metadata={"version": "2.0"}
+)
+
+# Suspend/Activate project
+client.zerodb.projects.suspend(project_id="proj_123", reason="Maintenance")
+client.zerodb.projects.activate(project_id="proj_123")
+```
+
+### Vector Operations
+
+```python
+import numpy as np
+
+# Upsert vectors with numpy arrays
+vectors = np.random.rand(10, 768)  # 10 vectors of dimension 768
+metadata = [{"doc_id": i, "category": "test"} for i in range(10)]
+
+client.zerodb.vectors.upsert(
+    project_id="proj_123",
+    vectors=vectors,
+    metadata=metadata,
+    namespace="documents"
+)
+
+# Search vectors
+query_vector = np.random.rand(768)
+results = client.zerodb.vectors.search(
+    project_id="proj_123",
+    vector=query_vector,
+    top_k=5,
+    namespace="documents",
+    filter={"category": "test"}
+)
+
+# Delete vectors
+client.zerodb.vectors.delete(
+    project_id="proj_123",
+    ids=["vec_1", "vec_2"],
+    namespace="documents"
+)
+```
+
+### NoSQL Table Operations
+
+```python
+# Create a table with schema
+table = client.zerodb.tables.create_table(
+    table_name="users",
+    schema={
+        "fields": {
+            "email": "string",
+            "name": "string",
+            "age": "number",
+            "active": "boolean"
+        },
+        "indexes": ["email"]
+    }
+)
+
+# Insert rows
+result = client.zerodb.tables.insert_rows("users", [
+    {"email": "user@example.com", "name": "John", "age": 30, "active": True},
+    {"email": "jane@example.com", "name": "Jane", "age": 25, "active": True}
+])
+
+# Query rows with filters
+users = client.zerodb.tables.query_rows(
+    "users",
+    filter={"age": {"$gte": 25}, "active": True},
+    sort={"age": -1},
+    limit=10
+)
+
+# Update rows
+client.zerodb.tables.update_rows(
+    "users",
+    filter={"email": "user@example.com"},
+    update={"$set": {"age": 31}}
+)
+
+# Delete rows
+client.zerodb.tables.delete_rows(
+    "users",
+    filter={"age": {"$lt": 18}}
+)
+
+# Count rows
+total = client.zerodb.tables.count_rows("users")
+active_users = client.zerodb.tables.count_rows("users", filter={"active": True})
+```
+
+See the complete [Table Operations Guide](TABLE_OPERATIONS.md) for advanced usage.
+
+### Memory Management
+
+```python
+from ainative.zerodb.memory import MemoryPriority
+
+# Create memory with priority
+memory = client.zerodb.memory.create(
+    content="Critical system configuration",
+    title="System Config",
+    tags=["config", "system"],
+    priority=MemoryPriority.HIGH,
+    metadata={"version": "1.0"}
+)
+
+# Search memories
+results = client.zerodb.memory.search(
+    query="system configuration",
+    semantic=True,  # Use semantic search
+    limit=10
+)
+
+# List memories with filters
+memories = client.zerodb.memory.list(
+    tags=["config"],
+    priority=MemoryPriority.HIGH
+)
+
+# Get related memories
+related = client.zerodb.memory.get_related(
+    memory_id=memory["id"],
+    limit=5
+)
+```
+
+## Agent Swarm
+
+### Starting a Swarm
+
+```python
+from ainative.agent_swarm import AgentType
+
+# Define agents
+agents = [
+    {
+        "id": "researcher_1",
+        "type": AgentType.RESEARCHER.value,
+        "capabilities": ["web_search", "document_analysis"]
+    },
+    {
+        "id": "coder_1",
+        "type": AgentType.CODER.value,
+        "capabilities": ["python", "javascript", "testing"]
+    }
+]
+
+# Start swarm
+swarm = client.agent_swarm.start_swarm(
+    project_id="proj_123",
+    agents=agents,
+    objective="Research and implement a new feature"
+)
+
+# Orchestrate task
+result = client.agent_swarm.orchestrate(
+    swarm_id=swarm["id"],
+    task="Find best practices for implementing OAuth2",
+    context={"language": "Python", "framework": "FastAPI"}
+)
+```
+
+### Managing Swarms
+
+```python
+# Get swarm status
+status = client.agent_swarm.get_status(swarm_id="swarm_123")
+
+# Get performance metrics
+metrics = client.agent_swarm.get_metrics(swarm_id="swarm_123")
+
+# Configure specific agent
+client.agent_swarm.configure_agent(
+    swarm_id="swarm_123",
+    agent_id="coder_1",
+    config={"temperature": 0.7, "max_tokens": 2000}
+)
+
+# Pause/Resume swarm
+client.agent_swarm.pause_swarm(swarm_id="swarm_123")
+client.agent_swarm.resume_swarm(swarm_id="swarm_123")
+
+# Stop swarm
+client.agent_swarm.stop_swarm(swarm_id="swarm_123")
+```
+
+## Analytics
+
+```python
+from datetime import datetime, timedelta
+
+# Get usage analytics
+usage = client.zerodb.analytics.get_usage(
+    project_id="proj_123",
+    start_date=datetime.now() - timedelta(days=30),
+    end_date=datetime.now(),
+    granularity="daily"
+)
+
+# Get performance metrics
+performance = client.zerodb.analytics.get_performance_metrics(
+    project_id="proj_123",
+    metric_type="latency"
+)
+
+# Get cost analysis
+costs = client.zerodb.analytics.get_cost_analysis(
+    project_id="proj_123"
+)
+
+# Export analytics report
+report = client.zerodb.analytics.export_report(
+    report_type="detailed",
+    project_id="proj_123",
+    format="pdf"
+)
+```
+
+## Async Support
+
+```python
+import asyncio
+from ainative import AsyncAINativeClient
+
+async def main():
+    async with AsyncAINativeClient(api_key="your-api-key") as client:
+        # Async operations
+        project = await client.zerodb.projects.create(
+            name="Async Project"
+        )
+        
+        # Concurrent operations
+        tasks = [
+            client.zerodb.vectors.search(project_id, vector)
+            for vector in vectors
+        ]
+        results = await asyncio.gather(*tasks)
+
+asyncio.run(main())
+```
+
+## Error Handling
+
+```python
+from ainative.exceptions import (
+    AuthenticationError,
+    RateLimitError,
+    ValidationError,
+    ResourceNotFoundError
+)
+
+try:
+    result = client.zerodb.projects.get("invalid_id")
+except ResourceNotFoundError as e:
+    print(f"Project not found: {e.resource_id}")
+except AuthenticationError:
+    print("Invalid API credentials")
+except RateLimitError as e:
+    print(f"Rate limited. Retry after {e.retry_after} seconds")
+except ValidationError as e:
+    print(f"Invalid input: {e.message}")
+```
+
+## Configuration
+
+### Custom Base URL
+
+```python
+client = AINativeClient(
+    api_key="your-api-key",
+    base_url="https://custom.ainative.studio"
+)
+```
+
+### Timeout and Retries
+
+```python
+from ainative.client import ClientConfig
+
+config = ClientConfig(
+    timeout=60,  # 60 seconds
+    max_retries=5,
+    retry_delay=2.0
+)
+
+client = AINativeClient(
+    api_key="your-api-key",
+    config=config
+)
+```
+
+## CLI Tool
+
+The SDK includes a CLI tool for quick operations:
+
+```bash
+# Configure credentials
+ainative config set api_key YOUR_API_KEY
+
+# List projects
+ainative projects list
+
+# Create project
+ainative projects create --name "CLI Project"
+
+# Search vectors
+ainative vectors search --project proj_123 --query "test"
+```
+
+## Examples
+
+Full examples are available in the [examples/](examples/) directory:
+
+- [Basic Usage](examples/basic_usage.py)
+- [Vector Search](examples/vector_search.py)
+- [Memory Management](examples/memory_management.py)
+- [Agent Swarm](examples/agent_swarm.py)
+- [Analytics Dashboard](examples/analytics.py)
+- [Multi-tenant Setup](examples/multi_tenant.py)
+
+## Development
+
+### Setting up development environment
+
+```bash
+# Clone repository
+git clone https://github.com/ainative/ainative-python.git
+cd ainative-python
+
+# Install in development mode
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Format code
+black ainative/
+isort ainative/
+
+# Type checking
+mypy ainative/
+```
+
+### Running Tests
+
+```bash
+# All tests
+pytest
+
+# With coverage
+pytest --cov=ainative
+
+# Specific module
+pytest tests/test_zerodb.py
+```
+
+## Support
+
+- **Documentation**: [https://docs.ainative.studio/sdk/python](https://docs.ainative.studio/sdk/python)
+- **API Reference**: [https://api.ainative.studio/docs-enhanced](https://api.ainative.studio/docs-enhanced)
+- **Issues**: [GitHub Issues](https://github.com/ainative/ainative-python/issues)
+- **Discord**: [Join our community](https://discord.gg/ainative)
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for release history.