0byte 0.1.0__tar.gz

0byte-0.1.0/0byte.egg-info/PKG-INFO

@@ -0,0 +1,61 @@
+Metadata-Version: 2.4
+Name: 0byte
+Version: 0.1.0
+Summary: Python SDK for 0byte — the origin protocol for AI content
+Author: 0byte
+License: MIT
+Project-URL: Homepage, https://www.0byte.dev
+Project-URL: Source, https://github.com/0byte-lab/0byte
+Keywords: ai,provenance,verification,content-authenticity,fingerprint
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.24
+Requires-Dist: pydantic>=2.0
+Dynamic: license-file
+
+<p align="center">
+  <img src="public/assets/0byte-logo-dark.png" alt="0byte logo" width="200"/>
+</p>
+
+# 0byte Python SDK
+
+The official Python SDK for **0byte** — the origin protocol for AI content.
+
+## What It Does
+
+- Stamps AI-generated content with a cryptographic proof of origin
+- Computes perceptual fingerprints that survive re-encoding and screenshots
+- Stores proofs in the 0byte registry for public verification
+- Verifies any content against the registry in a single call
+
+## Installation
+
+```bash
+pip install 0byte
+```
+
+## Quickstart
+
+```python
+import zbyte
+
+client = zbyte.Client(api_key="0b_key_...")
+
+# Stamp any AI-generated content
+proof = client.stamp(
+    content=image_bytes,
+    content_type="image/png",
+    provider="stability",
+    model="sdxl-turbo",
+)
+
+print(proof.id)          # "0b_proof_abc123"
+print(proof.fingerprint) # perceptual content hash
+print(proof.verify_url)  # "https://verify.0byte.dev/0b_proof_abc123"
+
+# Verify any content
+result = client.verify(content=some_image_bytes)
+print(result.matched)    # True / False
+print(result.confidence) # fingerprint similarity score
+```

0byte-0.1.0/0byte.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+pyproject.toml
+0byte.egg-info/PKG-INFO
+0byte.egg-info/SOURCES.txt
+0byte.egg-info/dependency_links.txt
+0byte.egg-info/requires.txt
+0byte.egg-info/top_level.txt
+zbyte/__init__.py
+zbyte/client.py
+zbyte/config.py
+zbyte/exceptions.py
+zbyte/utils.py

0byte-0.1.0/0byte.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

0byte-0.1.0/0byte.egg-info/requires.txt

@@ -0,0 +1,2 @@
+httpx>=0.24
+pydantic>=2.0

0byte-0.1.0/0byte.egg-info/top_level.txt

@@ -0,0 +1 @@
+zbyte

0byte-0.1.0/LICENSE

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

0byte-0.1.0/PKG-INFO

@@ -0,0 +1,61 @@
+Metadata-Version: 2.4
+Name: 0byte
+Version: 0.1.0
+Summary: Python SDK for 0byte — the origin protocol for AI content
+Author: 0byte
+License: MIT
+Project-URL: Homepage, https://www.0byte.dev
+Project-URL: Source, https://github.com/0byte-lab/0byte
+Keywords: ai,provenance,verification,content-authenticity,fingerprint
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.24
+Requires-Dist: pydantic>=2.0
+Dynamic: license-file
+
+<p align="center">
+  <img src="public/assets/0byte-logo-dark.png" alt="0byte logo" width="200"/>
+</p>
+
+# 0byte Python SDK
+
+The official Python SDK for **0byte** — the origin protocol for AI content.
+
+## What It Does
+
+- Stamps AI-generated content with a cryptographic proof of origin
+- Computes perceptual fingerprints that survive re-encoding and screenshots
+- Stores proofs in the 0byte registry for public verification
+- Verifies any content against the registry in a single call
+
+## Installation
+
+```bash
+pip install 0byte
+```
+
+## Quickstart
+
+```python
+import zbyte
+
+client = zbyte.Client(api_key="0b_key_...")
+
+# Stamp any AI-generated content
+proof = client.stamp(
+    content=image_bytes,
+    content_type="image/png",
+    provider="stability",
+    model="sdxl-turbo",
+)
+
+print(proof.id)          # "0b_proof_abc123"
+print(proof.fingerprint) # perceptual content hash
+print(proof.verify_url)  # "https://verify.0byte.dev/0b_proof_abc123"
+
+# Verify any content
+result = client.verify(content=some_image_bytes)
+print(result.matched)    # True / False
+print(result.confidence) # fingerprint similarity score
+```

0byte-0.1.0/README.md

@@ -0,0 +1,45 @@
+<p align="center">
+  <img src="public/assets/0byte-logo-dark.png" alt="0byte logo" width="200"/>
+</p>
+
+# 0byte Python SDK
+
+The official Python SDK for **0byte** — the origin protocol for AI content.
+
+## What It Does
+
+- Stamps AI-generated content with a cryptographic proof of origin
+- Computes perceptual fingerprints that survive re-encoding and screenshots
+- Stores proofs in the 0byte registry for public verification
+- Verifies any content against the registry in a single call
+
+## Installation
+
+```bash
+pip install 0byte
+```
+
+## Quickstart
+
+```python
+import zbyte
+
+client = zbyte.Client(api_key="0b_key_...")
+
+# Stamp any AI-generated content
+proof = client.stamp(
+    content=image_bytes,
+    content_type="image/png",
+    provider="stability",
+    model="sdxl-turbo",
+)
+
+print(proof.id)          # "0b_proof_abc123"
+print(proof.fingerprint) # perceptual content hash
+print(proof.verify_url)  # "https://verify.0byte.dev/0b_proof_abc123"
+
+# Verify any content
+result = client.verify(content=some_image_bytes)
+print(result.matched)    # True / False
+print(result.confidence) # fingerprint similarity score
+```

0byte-0.1.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "0byte"
+version = "0.1.0"
+description = "Python SDK for 0byte — the origin protocol for AI content"
+authors = [{name="0byte"}]
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.9"
+keywords = ["ai", "provenance", "verification", "content-authenticity", "fingerprint"]
+
+dependencies = [
+  "httpx>=0.24",
+  "pydantic>=2.0",
+]
+
+[project.urls]
+"Homepage" = "https://www.0byte.dev"
+"Source" = "https://github.com/0byte-lab/0byte"
+
+[tool.setuptools.packages.find]
+include = ["zbyte*"]
+# Note: PyPI package is "0byte" but the import remains "zbyte"
+# since Python module names cannot start with a digit.
+# Usage: pip install 0byte → import zbyte
+exclude = ["public*", "tests*"]

0byte-0.1.0/setup.cfg

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

0byte-0.1.0/zbyte/__init__.py

@@ -0,0 +1,5 @@
+from .client import Client, Proof, VerificationResult
+from .config import Config
+from .exceptions import SDKError, ProofError, VerificationError, AuthenticationError
+
+__version__ = "0.1.0"

0byte-0.1.0/zbyte/client.py

@@ -0,0 +1,129 @@
+import base64
+import httpx
+from .config import Config
+from .exceptions import AuthenticationError, ProofError, VerificationError
+from .utils import logger
+
+
+class Proof:
+    """A cryptographic proof of AI content origin."""
+
+    def __init__(self, data: dict):
+        self.id = data["id"]
+        self.fingerprint = data["fingerprint"]
+        self.provider = data["provider"]
+        self.model = data["model"]
+        self.content_type = data["content_type"]
+        self.timestamp = data["timestamp"]
+        self.signature = data["signature"]
+        self.verify_url = data["verify_url"]
+        self.metadata = data.get("metadata")
+
+    def __repr__(self):
+        return f"Proof(id={self.id!r}, provider={self.provider!r}, model={self.model!r})"
+
+
+class VerificationResult:
+    """Result of verifying content against the 0byte registry."""
+
+    def __init__(self, data: dict):
+        self.matched = data["matched"]
+        self.confidence = data["confidence"]
+        self.proof = Proof(data["proof"]) if data.get("proof") else None
+
+    def __repr__(self):
+        if self.matched:
+            return f"VerificationResult(matched=True, confidence={self.confidence:.3f}, proof={self.proof.id!r})"
+        return "VerificationResult(matched=False)"
+
+
+class Client:
+    """0byte API client for stamping and verifying AI content."""
+
+    def __init__(self, api_key: str = None, endpoint: str = "https://api.0byte.dev", timeout: float = 30.0):
+        self.api_key = api_key
+        self.endpoint = endpoint.rstrip("/")
+        self._http = httpx.Client(timeout=timeout)
+
+    def stamp(
+        self,
+        content: bytes,
+        content_type: str,
+        provider: str,
+        model: str,
+        metadata: dict = None,
+    ) -> Proof:
+        """Create a cryptographic proof of origin for AI-generated content."""
+        if not self.api_key:
+            raise AuthenticationError("API key required for stamping. Pass api_key to Client().")
+
+        payload = {
+            "content": base64.b64encode(content).decode(),
+            "content_type": content_type,
+            "provider": provider,
+            "model": model,
+        }
+        if metadata:
+            payload["metadata"] = metadata
+
+        logger.info("Stamping content (provider=%s, model=%s)", provider, model)
+
+        response = self._http.post(
+            f"{self.endpoint}/v1/stamp",
+            json=payload,
+            headers={"Authorization": f"Bearer {self.api_key}"},
+        )
+
+        if response.status_code == 401:
+            raise AuthenticationError("Invalid API key")
+        if response.status_code != 200:
+            raise ProofError(f"Stamp failed ({response.status_code}): {response.text}")
+
+        data = response.json()
+        logger.info("Proof created: %s", data["id"])
+        return Proof(data)
+
+    def verify(self, content: bytes, content_type: str = "image/png") -> VerificationResult:
+        """Verify content against the 0byte registry."""
+        payload = {
+            "content": base64.b64encode(content).decode(),
+            "content_type": content_type,
+        }
+
+        logger.info("Verifying content against registry")
+
+        response = self._http.post(
+            f"{self.endpoint}/v1/verify",
+            json=payload,
+        )
+
+        if response.status_code != 200:
+            raise VerificationError(f"Verification failed ({response.status_code}): {response.text}")
+
+        data = response.json()
+        result = VerificationResult(data)
+        if result.matched:
+            logger.info("Match found: %s (confidence=%.3f)", result.proof.id, result.confidence)
+        else:
+            logger.info("No match found in registry")
+        return result
+
+    def get_proof(self, proof_id: str) -> Proof:
+        """Look up a proof by ID."""
+        response = self._http.get(f"{self.endpoint}/v1/proofs/{proof_id}")
+
+        if response.status_code == 404:
+            raise ProofError(f"Proof not found: {proof_id}")
+        if response.status_code != 200:
+            raise ProofError(f"Lookup failed ({response.status_code}): {response.text}")
+
+        return Proof(response.json())
+
+    def close(self):
+        self._http.close()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *args):
+        self.close()

0byte-0.1.0/zbyte/config.py

@@ -0,0 +1,6 @@
+from pydantic import BaseModel, Field
+
+class Config(BaseModel):
+    api_key: str = Field(..., description="0byte API key")
+    endpoint: str = Field(default="https://api.0byte.dev", description="0byte API endpoint")
+    timeout: float = Field(default=30.0, description="Request timeout in seconds")

0byte-0.1.0/zbyte/exceptions.py

@@ -0,0 +1,11 @@
+class SDKError(Exception):
+    """Base exception for 0byte SDK"""
+
+class ProofError(SDKError):
+    """Raised when proof creation fails"""
+
+class VerificationError(SDKError):
+    """Raised when content verification fails"""
+
+class AuthenticationError(SDKError):
+    """Raised when API authentication fails"""

0byte-0.1.0/zbyte/utils.py

@@ -0,0 +1,11 @@
+import logging
+
+logger = logging.getLogger(__name__)
+logger.setLevel(logging.INFO)
+
+formatter = logging.Formatter(
+    "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
+)
+handler = logging.StreamHandler()
+handler.setFormatter(formatter)
+logger.addHandler(handler)