mixpeek 0.6.8__tar.gz → 0.6.17__tar.gz

mixpeek-0.6.17/MANIFEST.in

@@ -0,0 +1 @@
+include requirements.txt

mixpeek-0.6.17/PKG-INFO

@@ -0,0 +1,68 @@
+Metadata-Version: 2.1
+Name: mixpeek
+Version: 0.6.17
+Summary: Mixpeek Python SDK
+Home-page: https://github.com/mixpeek/mixpeek-python
+Author: Ethan Steininger
+Author-email: ethan@mixpeek.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+
+# Mixpeek SDK
+
+A Python SDK for the Mixpeek API.
+
+## Installation
+
+```bash
+pip install mixpeek
+```
+
+```python
+from mixpeek import Mixpeek
+from pydantic import BaseModel
+
+mixpeek = Mixpeek("YOUR_API_KEY")
+
+# Example usage
+extraction = mixpeek.extract.text(
+    input="s3://document.pdf",
+    input_type="url"
+)
+
+embedding = mixpeek.embed.video(
+    model="mixpeek/vuse-generic-v1",
+    input="s3://waving_boy.mp4",
+    input_type="url"
+)
+
+class ResponseFormat(BaseModel):
+    city: int
+    weather: float
+
+generated_content = mixpeek.generate.text(
+    response_format=ResponseFormat,
+    context="Please tell me the weather and make sure to respond in the provided JSON schema"
+)
+
+mixpeek.connections.create(
+    alias="my-mongo-test",
+    engine="mongodb",
+    details={
+        "host": "your_host_address",
+        "database": "your_database_name",
+        "username": "your_username",
+        "password": "your_password"
+    }
+)
+
+response = mixpeek.tools.video.process(
+    url="https://s3/video.mp4",
+    frame_interval=5,
+    resolution=[720, 1280],
+    return_base64=True
+)
+```

mixpeek-0.6.17/README.md

@@ -0,0 +1,55 @@
+# Mixpeek SDK
+
+A Python SDK for the Mixpeek API.
+
+## Installation
+
+```bash
+pip install mixpeek
+```
+
+```python
+from mixpeek import Mixpeek
+from pydantic import BaseModel
+
+mixpeek = Mixpeek("YOUR_API_KEY")
+
+# Example usage
+extraction = mixpeek.extract.text(
+    input="s3://document.pdf",
+    input_type="url"
+)
+
+embedding = mixpeek.embed.video(
+    model="mixpeek/vuse-generic-v1",
+    input="s3://waving_boy.mp4",
+    input_type="url"
+)
+
+class ResponseFormat(BaseModel):
+    city: int
+    weather: float
+
+generated_content = mixpeek.generate.text(
+    response_format=ResponseFormat,
+    context="Please tell me the weather and make sure to respond in the provided JSON schema"
+)
+
+mixpeek.connections.create(
+    alias="my-mongo-test",
+    engine="mongodb",
+    details={
+        "host": "your_host_address",
+        "database": "your_database_name",
+        "username": "your_username",
+        "password": "your_password"
+    }
+)
+
+response = mixpeek.tools.video.process(
+    url="https://s3/video.mp4",
+    frame_interval=5,
+    resolution=[720, 1280],
+    return_base64=True
+)
+```

mixpeek-0.6.17/mixpeek/__init__.py

@@ -0,0 +1 @@
+from .client import Mixpeek

mixpeek-0.6.17/mixpeek/client.py

@@ -0,0 +1,21 @@
+import requests
+
+from .endpoints.extract import Extract
+from .endpoints.embed import Embed
+from .endpoints.generate import Generate
+from .endpoints.connections import Connections
+from .endpoints.tools import Tools
+
+class Mixpeek:
+    def __init__(self, api_key: str):
+        self.api_key = api_key
+        self.base_url = "https://api.mixpeek.com/"
+        self.headers = {
+            "Authorization": f"Bearer {self.api_key}",
+            "Content-Type": "application/json"
+        }
+        self.extract = Extract(self.base_url, self.headers)
+        self.embed = Embed(self.base_url, self.headers)
+        self.generate = Generate(self.base_url, self.headers)
+        self.connections = Connections(self.base_url, self.headers)
+        self.tools = Tools(self.base_url, self.headers)

mixpeek-0.6.17/mixpeek/endpoints/connections.py

@@ -0,0 +1,16 @@
+import requests
+
+class Connections:
+    def __init__(self, base_url, headers):
+        self.base_url = base_url
+        self.headers = headers
+
+    def create(self, alias: str, engine: str, details: dict):
+        url = f"{self.base_url}connections/"
+        data = {
+            "alias": alias,
+            "engine": engine,
+            "details": details
+        }
+        response = requests.post(url, json=data, headers=self.headers)
+        return response.json()

mixpeek-0.6.17/mixpeek/endpoints/embed.py

@@ -0,0 +1,50 @@
+import requests
+
+class Embed:
+    def __init__(self, base_url, headers):
+        self.base_url = base_url
+        self.headers = headers
+
+    def video(self, model: str, input: str, input_type: str):
+        url = f"{self.base_url}embed/"
+        data = {
+            "modality": "video",
+            "model": model,
+            "input": input,
+            "input_type": input_type
+        }
+        response = requests.post(url, json=data, headers=self.headers)
+        return response.json()
+
+    def text(self, model: str, input: str, input_type: str):
+        url = f"{self.base_url}embed/"
+        data = {
+            "modality": "text",
+            "model": model,
+            "input": input,
+            "input_type": input_type
+        }
+        response = requests.post(url, json=data, headers=self.headers)
+        return response.json()
+
+    def image(self, model: str, input: str, input_type: str):
+        url = f"{self.base_url}embed/"
+        data = {
+            "modality": "image",
+            "model": model,
+            "input": input,
+            "input_type": input_type
+        }
+        response = requests.post(url, json=data, headers=self.headers)
+        return response.json()
+
+    def audio(self, model: str, input: str, input_type: str):
+        url = f"{self.base_url}embed/"
+        data = {
+            "modality": "audio",
+            "model": model,
+            "input": input,
+            "input_type": input_type
+        }
+        response = requests.post(url, json=data, headers=self.headers)
+        return response.json()

mixpeek-0.6.17/mixpeek/endpoints/extract.py

@@ -0,0 +1,16 @@
+import requests
+
+class Extract:
+    def __init__(self, base_url, headers):
+        self.base_url = base_url
+        self.headers = headers
+
+    def extract(self, modality: str, input: str, input_type: str):
+        url = f"{self.base_url}extract/"
+        data = {
+            "modality": modality,
+            "input": input,
+            "input_type": input_type
+        }
+        response = requests.post(url, json=data, headers=self.headers)
+        return response.json()

mixpeek-0.6.17/mixpeek/endpoints/generate.py

@@ -0,0 +1,17 @@
+import requests
+from pydantic import BaseModel
+
+class Generate:
+    def __init__(self, base_url, headers):
+        self.base_url = base_url
+        self.headers = headers
+
+    def generate(self, response_format: BaseModel, context: str):
+        url = f"{self.base_url}generate/text"
+        data = {
+            "response_format": response_format.model_json_schema(),
+            "context": context
+        }
+        response = requests.post(url, json=data, headers=self.headers)
+        return response.json()
+

mixpeek-0.6.17/mixpeek/endpoints/tools.py

@@ -0,0 +1,23 @@
+import requests
+
+class Tools:
+    def __init__(self, base_url, headers):
+        self.base_url = base_url
+        self.headers = headers
+        self.video = self.Video(self)
+
+    class Video:
+        def __init__(self, parent):
+            self.base_url = parent.base_url
+            self.headers = parent.headers
+
+        def process(self, url: str, frame_interval: int, resolution: list, return_base64: bool):
+            endpoint = f"{self.base_url}tools/video/process"
+            data = {
+                "url": url,
+                "frame_interval": frame_interval,
+                "resolution": resolution,
+                "use_base64": return_base64
+            }
+            response = requests.post(endpoint, json=data, headers=self.headers)
+            return response.json()

mixpeek-0.6.17/mixpeek/exceptions.py

@@ -0,0 +1,13 @@
+class MixpeekException(Exception):
+    pass
+
+class AuthenticationError(MixpeekException):
+    pass
+
+class BadRequestError(MixpeekException):
+    pass
+
+class NotFoundError(MixpeekException):
+    pass
+
+# Define more exceptions as needed

mixpeek-0.6.17/mixpeek.egg-info/PKG-INFO

@@ -0,0 +1,68 @@
+Metadata-Version: 2.1
+Name: mixpeek
+Version: 0.6.17
+Summary: Mixpeek Python SDK
+Home-page: https://github.com/mixpeek/mixpeek-python
+Author: Ethan Steininger
+Author-email: ethan@mixpeek.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+
+# Mixpeek SDK
+
+A Python SDK for the Mixpeek API.
+
+## Installation
+
+```bash
+pip install mixpeek
+```
+
+```python
+from mixpeek import Mixpeek
+from pydantic import BaseModel
+
+mixpeek = Mixpeek("YOUR_API_KEY")
+
+# Example usage
+extraction = mixpeek.extract.text(
+    input="s3://document.pdf",
+    input_type="url"
+)
+
+embedding = mixpeek.embed.video(
+    model="mixpeek/vuse-generic-v1",
+    input="s3://waving_boy.mp4",
+    input_type="url"
+)
+
+class ResponseFormat(BaseModel):
+    city: int
+    weather: float
+
+generated_content = mixpeek.generate.text(
+    response_format=ResponseFormat,
+    context="Please tell me the weather and make sure to respond in the provided JSON schema"
+)
+
+mixpeek.connections.create(
+    alias="my-mongo-test",
+    engine="mongodb",
+    details={
+        "host": "your_host_address",
+        "database": "your_database_name",
+        "username": "your_username",
+        "password": "your_password"
+    }
+)
+
+response = mixpeek.tools.video.process(
+    url="https://s3/video.mp4",
+    frame_interval=5,
+    resolution=[720, 1280],
+    return_base64=True
+)
+```

mixpeek-0.6.17/mixpeek.egg-info/SOURCES.txt

@@ -0,0 +1,17 @@
+MANIFEST.in
+README.md
+requirements.txt
+setup.py
+mixpeek/__init__.py
+mixpeek/client.py
+mixpeek/exceptions.py
+mixpeek.egg-info/PKG-INFO
+mixpeek.egg-info/SOURCES.txt
+mixpeek.egg-info/dependency_links.txt
+mixpeek.egg-info/top_level.txt
+mixpeek/endpoints/__init__.py
+mixpeek/endpoints/connections.py
+mixpeek/endpoints/embed.py
+mixpeek/endpoints/extract.py
+mixpeek/endpoints/generate.py
+mixpeek/endpoints/tools.py

mixpeek-0.6.17/mixpeek.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

mixpeek-0.6.17/mixpeek.egg-info/top_level.txt

@@ -0,0 +1 @@
+mixpeek

mixpeek-0.6.17/requirements.txt

@@ -0,0 +1,2 @@
+requests==2.32.3
+pydantic==2.7.3

mixpeek-0.6.17/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

mixpeek-0.6.17/setup.py

@@ -0,0 +1,19 @@
+from setuptools import setup, find_packages
+
+setup(
+    name='mixpeek',
+    version='0.6.17',
+    author='Ethan Steininger',
+    author_email='ethan@mixpeek.com',
+    description='Mixpeek Python SDK',
+    long_description=open('README.md').read(),
+    long_description_content_type='text/markdown',
+    url='https://github.com/mixpeek/mixpeek-python',
+    packages=find_packages(),
+    classifiers=[
+        'Programming Language :: Python :: 3',
+        'License :: OSI Approved :: MIT License',
+        'Operating System :: OS Independent',
+    ],
+    python_requires='>=3.6',
+)

mixpeek-0.6.8/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2024 Mixpeek.
-
-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.

mixpeek-0.6.8/PKG-INFO

@@ -1,145 +0,0 @@
-Metadata-Version: 2.1
-Name: mixpeek
-Version: 0.6.8
-Summary: 
-Requires-Python: >=3.8,<4.0
-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
-Requires-Dist: httpx (>=0.21.2)
-Requires-Dist: pydantic (>=1.9.2)
-Requires-Dist: typing_extensions (>=4.0.0)
-Description-Content-Type: text/markdown
-
-# Mixpeek Python Library
-
-[![fern shield](https://img.shields.io/badge/%F0%9F%8C%BF-SDK%20generated%20by%20Fern-brightgreen)](https://github.com/fern-api/fern)
-
-The Mixpeek Python Library provides convenient access to the Mixpeek API from applications written in Python.
-
-## Installation
-Add this dependency to your project's build file:
-
-```bash
-pip install mixpeek
-# or
-poetry add mixpeek
-```
-
-## Usage
-Simply import `Mixpeek` and start making calls to our API. 
-
-```python
-from mixpeek.client import Mixpeek
-
-client = Mixpeek(
-    api_key="..."
-)
-```
-
-## Async Client
-
-The SDK also exports an async client so that you can make non-blocking
-calls to our API. 
-
-```python
-from mixpeek.client import AsymcMixpeek
-
-client = AsyncMixpeek(
-    api_key="..."
-)
-```
-
-## Exception Handling
-All errors thrown by the SDK will be subclasses of [`ApiError`](./src/mixpeek/core/api_error.py).
-
-```python
-import mixpeek
-
-try:
-  client.search(...)
-except mixpeek.core.ApiError as e: # Handle all errors
-  print(e.status_code)
-  print(e.body)
-```
-
-## Advanced
-
-### Retries
-The Mixpeek SDK is instrumented with automatic retries with exponential backoff. A request will be
-retried as long as the request is deemed retriable and the number of retry attempts has not grown larger
-than the configured retry limit.
-
-A request is deemed retriable when any of the following HTTP status codes is returned:
-
-- [408](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/408) (Timeout)
-- [409](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/409) (Conflict)
-- [429](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/429) (Too Many Requests)
-- [5XX](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500) (Internal Server Errors)
-  
-Use the `max_retries` request option to configure this behavior. 
-
-```python
-from mixpeek.client import Mixpeek
-
-client = Mixpeek(...)
-
-# Override retries for a specific method
-client.search(..., {
-    max_retries=5
-})
-```
-
-### Timeouts
-By default, requests time out after 60 seconds. You can configure this with a 
-timeout option at the client or request level.
-
-```python
-from mixpeek.client import Mixpeek
-
-client = Mixpeek(
-    # All timeouts are 20 seconds
-    timeout=20.0,
-)
-
-# Override timeout for a specific method
-client.search(..., {
-    timeout_in_seconds=20.0
-})
-```
-
-### Custom HTTP client
-You can override the httpx client to customize it for your use-case. Some common use-cases 
-include support for proxies and transports.
-
-```python
-import httpx
-
-from mixpeek.client import Mixpeek
-
-client = Mixpeek(
-    http_client=httpx.Client(
-        proxies="http://my.test.proxy.example.com",
-        transport=httpx.HTTPTransport(local_address="0.0.0.0"),
-    ),
-)
-```
-
-## Beta Status
-
-This SDK is in beta, and there may be breaking changes between versions without a major 
-version update. Therefore, we recommend pinning the package version to a specific version. 
-This way, you can install the same version each time without breaking changes.
-
-## Contributing
-
-While we value open-source contributions to this SDK, this library is generated programmatically. 
-Additions made directly to this library would have to be moved over to our generation code, 
-otherwise they would be overwritten upon the next generated release. Feel free to open a PR as
-a proof of concept, but know that we will not be able to merge it as-is. We suggest opening 
-an issue first to discuss with us!
-
-On the other hand, contributions to the README are always very welcome!
-