ocy 1.0.0__tar.gz

ocy-1.0.0/PKG-INFO

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: ocy
+Version: 1.0.0
+Summary: Lightweight OCR for developer screenshots — extract text from code images, terminals, and IDE windows
+Author: Samin Yeasar
+License: MIT
+Project-URL: Homepage, https://github.com/solez-ai/ocy
+Project-URL: Repository, https://github.com/solez-ai/ocy
+Project-URL: Issues, https://github.com/solez-ai/ocy/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+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 :: Image Recognition
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.24.0
+
+![OCY](https://raw.githubusercontent.com/solez-ai/ocy/main/public/logo.png)
+
+# OCY - Python OCR SDK
+
+Lightweight OCR for developer screenshots — extract text from code images, terminals, and IDE windows with one line of code.
+
+**Made by Samin Yeasar • [github.com/solez-ai](https://github.com/solez-ai) • [x.com/Solez_None](https://x.com/Solez_None)**
+
+## Installation
+
+```bash
+pip install ocy
+```
+
+## Quick Start
+
+### 1. Set your API URL
+
+First, set the API URL. You can use a self-hosted instance or a public one:
+
+```python
+import ocy
+
+# Set your API URL (required)
+ocy.set_api_url("https://your-api.vercel.app")
+```
+
+### 2. Extract text from a URL
+
+```python
+result = ocy.extract_text("https://example.com/screenshot.png")
+print(result["text"])
+print(f"Confidence: {result['confidence']:.1%}")
+```
+
+### 3. Extract text from a local file
+
+```python
+result = ocy.extract_text("./myScreenshot.png")
+print(result["text"])
+```
+
+### 4. Async usage
+
+```python
+import asyncio
+import ocy
+
+async def main():
+    result = await ocy.extract_text_async("https://example.com/code.png")
+    print(result["text"])
+
+asyncio.run(main())
+```
+
+### 5. Use an API key
+
+```python
+import ocy
+
+# Option 1: Per-request key
+result = ocy.extract_text("https://example.com/screenshot.png", api_key="your-key")
+
+# Option 2: Set global key
+ocy.set_api_key("your-key")
+result = ocy.extract_text("https://example.com/screenshot.png")
+```
+
+## Response Format
+
+```python
+{
+    "text": "extracted text from image...",
+    "confidence": 0.95,        # 0.0 to 1.0
+    "latency_ms": 150,         # processing time in milliseconds
+    "model": "ocy-v1-int8",    # model identifier
+    "chars_detected": 42       # number of characters detected
+}
+```
+
+## API Reference
+
+| Function | Description |
+|----------|-------------|
+| `extract_text(img, api_key=None)` | Extract text synchronously |
+| `extract_text_async(img, api_key=None)` | Extract text asynchronously |
+| `set_api_url(url)` | Set custom API endpoint |
+| `set_api_key(key)` | Set global API key |
+
+## License
+
+MIT License - See [LICENSE](https://github.com/solez-ai/ocy/blob/main/LICENSE) for details.

ocy-1.0.0/README.md

@@ -0,0 +1,92 @@
+![OCY](https://raw.githubusercontent.com/solez-ai/ocy/main/public/logo.png)
+
+# OCY - Python OCR SDK
+
+Lightweight OCR for developer screenshots — extract text from code images, terminals, and IDE windows with one line of code.
+
+**Made by Samin Yeasar • [github.com/solez-ai](https://github.com/solez-ai) • [x.com/Solez_None](https://x.com/Solez_None)**
+
+## Installation
+
+```bash
+pip install ocy
+```
+
+## Quick Start
+
+### 1. Set your API URL
+
+First, set the API URL. You can use a self-hosted instance or a public one:
+
+```python
+import ocy
+
+# Set your API URL (required)
+ocy.set_api_url("https://your-api.vercel.app")
+```
+
+### 2. Extract text from a URL
+
+```python
+result = ocy.extract_text("https://example.com/screenshot.png")
+print(result["text"])
+print(f"Confidence: {result['confidence']:.1%}")
+```
+
+### 3. Extract text from a local file
+
+```python
+result = ocy.extract_text("./myScreenshot.png")
+print(result["text"])
+```
+
+### 4. Async usage
+
+```python
+import asyncio
+import ocy
+
+async def main():
+    result = await ocy.extract_text_async("https://example.com/code.png")
+    print(result["text"])
+
+asyncio.run(main())
+```
+
+### 5. Use an API key
+
+```python
+import ocy
+
+# Option 1: Per-request key
+result = ocy.extract_text("https://example.com/screenshot.png", api_key="your-key")
+
+# Option 2: Set global key
+ocy.set_api_key("your-key")
+result = ocy.extract_text("https://example.com/screenshot.png")
+```
+
+## Response Format
+
+```python
+{
+    "text": "extracted text from image...",
+    "confidence": 0.95,        # 0.0 to 1.0
+    "latency_ms": 150,         # processing time in milliseconds
+    "model": "ocy-v1-int8",    # model identifier
+    "chars_detected": 42       # number of characters detected
+}
+```
+
+## API Reference
+
+| Function | Description |
+|----------|-------------|
+| `extract_text(img, api_key=None)` | Extract text synchronously |
+| `extract_text_async(img, api_key=None)` | Extract text asynchronously |
+| `set_api_url(url)` | Set custom API endpoint |
+| `set_api_key(key)` | Set global API key |
+
+## License
+
+MIT License - See [LICENSE](https://github.com/solez-ai/ocy/blob/main/LICENSE) for details.

ocy-1.0.0/ocy/__init__.py

@@ -0,0 +1,161 @@
+"""
+OCY - Lightweight OCR SDK for Python
+Extract text from developer screenshots with one line of code.
+"""
+
+import asyncio
+import os
+import httpx
+from typing import Union, Optional
+
+__version__ = "1.0.0"
+
+# API configuration - must be set by user
+_api_url: Optional[str] = None
+_api_key: Optional[str] = None
+
+
+def set_api_url(url: str) -> None:
+    """Set a custom API URL for self-hosted instances."""
+    global _api_url
+    _api_url = url
+
+
+def set_api_key(key: str) -> None:
+    """Set the API key for authenticated requests."""
+    global _api_key
+    _api_key = key
+
+
+def _upload_to_0x0(file_path: str) -> str:
+    """Upload a file to 0x0.st and return the URL."""
+    with open(file_path, 'rb') as f:
+        files = {'file': (os.path.basename(file_path), f, 'application/octet-stream')}
+        response = httpx.post('https://0x0.st', files=files)
+        response.raise_for_status()
+        return response.text.strip()
+
+
+def _upload_bytes_to_0x0(data: bytes, filename: str = 'image.png') -> str:
+    """Upload raw bytes to 0x0.st and return the URL."""
+    files = {'file': (filename, data, 'application/octet-stream')}
+    response = httpx.post('https://0x0.st', files=files)
+    response.raise_for_status()
+    return response.text.strip()
+
+
+def extract_text(
+    img: Union[str, bytes],
+    api_key: Optional[str] = None
+) -> dict:
+    """
+    Extract text from an image.
+
+    Args:
+        img: Image can be a URL string, local file path, or raw bytes
+        api_key: Optional API key for authenticated requests
+
+    Returns:
+        dict with keys: text, confidence, latency_ms, model, chars_detected
+
+    Example:
+        >>> import ocy
+        >>> result = ocy.extract_text("https://example.com/screenshot.png")
+        >>> print(result['text'])
+    """
+    global _api_key
+
+    if not _api_url:
+        raise ValueError("API URL not set. Call set_api_url() first or set OCY_API_URL environment variable.")
+
+    # Determine image URL
+    image_url = img
+
+    if isinstance(img, str):
+        # Check if it's a local file path
+        if not img.startswith(('http://', 'https://')):
+            if os.path.isfile(img):
+                image_url = _upload_to_0x0(img)
+            else:
+                raise ValueError(f"Invalid URL or file path: {img}")
+    elif isinstance(img, bytes):
+        image_url = _upload_bytes_to_0x0(img)
+    else:
+        raise TypeError("img must be a URL string, file path, or bytes")
+
+    # Build request
+    headers = {"Content-Type": "application/json"}
+    if api_key:
+        headers["x-api-key"] = api_key
+    elif _api_key:
+        headers["x-api-key"] = _api_key
+
+    # Make request
+    with httpx.Client(timeout=30.0) as client:
+        response = client.post(
+            f"{_api_url}/api/extract",
+            json={"image_url": image_url},
+            headers=headers
+        )
+        response.raise_for_status()
+        return response.json()
+
+
+async def extract_text_async(
+    img: Union[str, bytes],
+    api_key: Optional[str] = None
+) -> dict:
+    """
+    Async version of extract_text for use with asyncio.
+
+    Args:
+        img: Image can be a URL string, local file path, or raw bytes
+        api_key: Optional API key for authenticated requests
+
+    Returns:
+        dict with keys: text, confidence, latency_ms, model, chars_detected
+    """
+    global _api_key
+
+    if not _api_url:
+        raise ValueError("API URL not set. Call set_api_url() first or set OCY_API_URL environment variable.")
+
+    # Determine image URL
+    image_url = img
+
+    if isinstance(img, str):
+        if not img.startswith(('http://', 'https://')):
+            if os.path.isfile(img):
+                async with httpx.AsyncClient() as client:
+                    with open(img, 'rb') as f:
+                        files = {'file': (os.path.basename(img), f, 'application/octet-stream')}
+                        response = await client.post('https://0x0.st', files=files)
+                        response.raise_for_status()
+                        image_url = response.text.strip()
+            else:
+                raise ValueError(f"Invalid URL or file path: {img}")
+    elif isinstance(img, bytes):
+        async with httpx.AsyncClient() as client:
+            files = {'file': ('image.png', img, 'application/octet-stream')}
+            response = await client.post('https://0x0.st', files=files)
+            response.raise_for_status()
+            image_url = response.text.strip()
+    else:
+        raise TypeError("img must be a URL string, file path, or bytes")
+
+    # Build request
+    headers = {"Content-Type": "application/json"}
+    if api_key:
+        headers["x-api-key"] = api_key
+    elif _api_key:
+        headers["x-api-key"] = _api_key
+
+    # Make async request
+    async with httpx.AsyncClient(timeout=30.0) as client:
+        response = await client.post(
+            f"{_api_url}/api/extract",
+            json={"image_url": image_url},
+            headers=headers
+        )
+        response.raise_for_status()
+        return response.json()

ocy-1.0.0/ocy.egg-info/PKG-INFO

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: ocy
+Version: 1.0.0
+Summary: Lightweight OCR for developer screenshots — extract text from code images, terminals, and IDE windows
+Author: Samin Yeasar
+License: MIT
+Project-URL: Homepage, https://github.com/solez-ai/ocy
+Project-URL: Repository, https://github.com/solez-ai/ocy
+Project-URL: Issues, https://github.com/solez-ai/ocy/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+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 :: Image Recognition
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.24.0
+
+![OCY](https://raw.githubusercontent.com/solez-ai/ocy/main/public/logo.png)
+
+# OCY - Python OCR SDK
+
+Lightweight OCR for developer screenshots — extract text from code images, terminals, and IDE windows with one line of code.
+
+**Made by Samin Yeasar • [github.com/solez-ai](https://github.com/solez-ai) • [x.com/Solez_None](https://x.com/Solez_None)**
+
+## Installation
+
+```bash
+pip install ocy
+```
+
+## Quick Start
+
+### 1. Set your API URL
+
+First, set the API URL. You can use a self-hosted instance or a public one:
+
+```python
+import ocy
+
+# Set your API URL (required)
+ocy.set_api_url("https://your-api.vercel.app")
+```
+
+### 2. Extract text from a URL
+
+```python
+result = ocy.extract_text("https://example.com/screenshot.png")
+print(result["text"])
+print(f"Confidence: {result['confidence']:.1%}")
+```
+
+### 3. Extract text from a local file
+
+```python
+result = ocy.extract_text("./myScreenshot.png")
+print(result["text"])
+```
+
+### 4. Async usage
+
+```python
+import asyncio
+import ocy
+
+async def main():
+    result = await ocy.extract_text_async("https://example.com/code.png")
+    print(result["text"])
+
+asyncio.run(main())
+```
+
+### 5. Use an API key
+
+```python
+import ocy
+
+# Option 1: Per-request key
+result = ocy.extract_text("https://example.com/screenshot.png", api_key="your-key")
+
+# Option 2: Set global key
+ocy.set_api_key("your-key")
+result = ocy.extract_text("https://example.com/screenshot.png")
+```
+
+## Response Format
+
+```python
+{
+    "text": "extracted text from image...",
+    "confidence": 0.95,        # 0.0 to 1.0
+    "latency_ms": 150,         # processing time in milliseconds
+    "model": "ocy-v1-int8",    # model identifier
+    "chars_detected": 42       # number of characters detected
+}
+```
+
+## API Reference
+
+| Function | Description |
+|----------|-------------|
+| `extract_text(img, api_key=None)` | Extract text synchronously |
+| `extract_text_async(img, api_key=None)` | Extract text asynchronously |
+| `set_api_url(url)` | Set custom API endpoint |
+| `set_api_key(key)` | Set global API key |
+
+## License
+
+MIT License - See [LICENSE](https://github.com/solez-ai/ocy/blob/main/LICENSE) for details.

ocy-1.0.0/ocy.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+README.md
+pyproject.toml
+ocy/__init__.py
+ocy.egg-info/PKG-INFO
+ocy.egg-info/SOURCES.txt
+ocy.egg-info/dependency_links.txt
+ocy.egg-info/requires.txt
+ocy.egg-info/top_level.txt

ocy-1.0.0/ocy.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ocy-1.0.0/ocy.egg-info/requires.txt

@@ -0,0 +1 @@
+httpx>=0.24.0

ocy-1.0.0/ocy.egg-info/top_level.txt

@@ -0,0 +1 @@
+ocy

ocy-1.0.0/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ocy"
+version = "1.0.0"
+description = "Lightweight OCR for developer screenshots — extract text from code images, terminals, and IDE windows"
+readme = "README.md"
+license = { text = "MIT" }
+authors = [
+    { name = "Samin Yeasar" }
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Image Recognition",
+]
+dependencies = ["httpx>=0.24.0"]
+requires-python = ">=3.8"
+
+[project.urls]
+Homepage = "https://github.com/solez-ai/ocy"
+Repository = "https://github.com/solez-ai/ocy"
+Issues = "https://github.com/solez-ai/ocy/issues"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["ocy*"]

ocy-1.0.0/setup.cfg

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