edgelens-sdk 0.2.1__tar.gz

edgelens_sdk-0.2.1/.gitignore

@@ -0,0 +1,92 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+.pytest_cache/
+.tox/
+.coverage
+.coverage.*
+htmlcov/
+.hypothesis/
+.mypy_cache/
+.ruff_cache/
+
+# Virtual environments
+venv/
+.venv/
+env/
+ENV/
+
+# Node / TypeScript
+node_modules/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.npm
+.eslintcache
+.parcel-cache
+.next
+out/
+.cache/
+*.tsbuildinfo
+
+# Go
+*.exe
+*.exe~
+*.dll
+*.dylib
+*.test
+*.out
+go.work
+vendor/
+# `*.test` above is Go's compiled per-package test binary (go test -c). The
+# container test images are named Dockerfile.test / Dockerfile.test-typescript,
+# so negate those back in.
+!Dockerfile.test
+!Dockerfile.test-*
+
+# k6 — built xk6 binary lives at repo root after `xk6 build`. The
+# anchored slashes scope the ignore so examples/k6/ + integrations/k6/
+# aren't swallowed.
+/xk6
+/k6
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Secrets
+.env
+.env.local
+*.pem
+*.key
+
+# Demo run output. These are photographs taken by a device in a rack, so
+# they show whatever the sensor was pointed at — never commit them here.
+examples/*/artifacts/

edgelens_sdk-0.2.1/LICENSE

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

edgelens_sdk-0.2.1/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.5
+Name: edgelens-sdk
+Version: 0.2.1
+Summary: Python client for the EdgeLens Edge AI Device Farm
+Project-URL: Homepage, https://edgelens.ai
+Project-URL: Repository, https://github.com/edgelens-ai/edgelens-sdk
+Project-URL: Issues, https://github.com/edgelens-ai/edgelens-sdk/issues
+Project-URL: Documentation, https://docs.edgelens.ai
+Author-email: EdgeLens <support@edgelens.ai>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+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 :: Software Development :: Testing
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.0; extra == 'dev'
+Requires-Dist: pytest-httpx>=0.30; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# edgelens-sdk — Python client for the EdgeLens Edge AI Device Farm
+
+The base Python client used by all Python EdgeLens integrations (pytest, Robot Framework, MLflow, W&B, the CLI, and the MCP server).
+
+## Install
+
+```bash
+pip install edgelens-sdk
+```
+
+The distribution is `edgelens-sdk`; the import name is `edgelens`
+(`from edgelens import EdgeLensClient`). The PyPI package named
+`edgelens` is an unrelated project and is not this SDK.
+
+## Quick Start
+
+```python
+from edgelens import EdgeLensClient
+
+client = EdgeLensClient()  # reads EDGELENS_API_KEY from env
+
+with client.create_session(device_type="recamera-2002", os="stock-os") as session:
+    session.wait_ready()
+
+    session.device.deploy(model="./models/face_detection.cvimodel")
+    session.device.display.play("./test_data/crowd_scene.mp4")
+
+    stats = session.device.inference.run(duration=30)
+    assert stats.fps.avg > 15
+```
+
+For reCamaginedOS (raw, customer provides binary):
+
+```python
+with client.create_session(device_type="recamera-2002", os="recamagined") as session:
+    session.wait_ready()
+
+    # Files land in /userdata/Models/ on reCamaginedOS.
+    session.device.deploy(
+        model="./build/my_inference",
+        files=["./models/my_model.cvimodel"],
+    )
+
+    result = session.device.exec(
+        "chmod +x /userdata/Models/my_inference && "
+        "/userdata/Models/my_inference "
+        "--model /userdata/Models/my_model.cvimodel --duration 10"
+    )
+    assert result.success
+```
+
+On reCamaginedOS, `deploy(model=..., files=[...])` places the model and
+each file in `/userdata/Models/` under its base filename. Files arrive
+readable but not executable: before running a deployed binary, make it
+executable, e.g. `chmod +x /userdata/Models/my_inference`.
+
+## API Surface
+
+- `EdgeLensClient` — entry point, creates sessions
+- `Session` — session lifecycle (wait_ready, refresh, release)
+- `Device` — device operations
+  - `device.deploy()` — model deployment
+  - `device.display.*` — display control (play, show, stop)
+  - `device.inference.*` — built-in inference (stock OS only)
+  - `device.exec()` — run commands via SSH
+  - `device.ssh()` — SSH connection details
+  - `device.info()` — device info report
+  - `device.stream_url()` — camera stream URL (stock OS only)
+
+## Development
+
+```bash
+cd core/python
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+MIT

edgelens_sdk-0.2.1/README.md

@@ -0,0 +1,80 @@
+# edgelens-sdk — Python client for the EdgeLens Edge AI Device Farm
+
+The base Python client used by all Python EdgeLens integrations (pytest, Robot Framework, MLflow, W&B, the CLI, and the MCP server).
+
+## Install
+
+```bash
+pip install edgelens-sdk
+```
+
+The distribution is `edgelens-sdk`; the import name is `edgelens`
+(`from edgelens import EdgeLensClient`). The PyPI package named
+`edgelens` is an unrelated project and is not this SDK.
+
+## Quick Start
+
+```python
+from edgelens import EdgeLensClient
+
+client = EdgeLensClient()  # reads EDGELENS_API_KEY from env
+
+with client.create_session(device_type="recamera-2002", os="stock-os") as session:
+    session.wait_ready()
+
+    session.device.deploy(model="./models/face_detection.cvimodel")
+    session.device.display.play("./test_data/crowd_scene.mp4")
+
+    stats = session.device.inference.run(duration=30)
+    assert stats.fps.avg > 15
+```
+
+For reCamaginedOS (raw, customer provides binary):
+
+```python
+with client.create_session(device_type="recamera-2002", os="recamagined") as session:
+    session.wait_ready()
+
+    # Files land in /userdata/Models/ on reCamaginedOS.
+    session.device.deploy(
+        model="./build/my_inference",
+        files=["./models/my_model.cvimodel"],
+    )
+
+    result = session.device.exec(
+        "chmod +x /userdata/Models/my_inference && "
+        "/userdata/Models/my_inference "
+        "--model /userdata/Models/my_model.cvimodel --duration 10"
+    )
+    assert result.success
+```
+
+On reCamaginedOS, `deploy(model=..., files=[...])` places the model and
+each file in `/userdata/Models/` under its base filename. Files arrive
+readable but not executable: before running a deployed binary, make it
+executable, e.g. `chmod +x /userdata/Models/my_inference`.
+
+## API Surface
+
+- `EdgeLensClient` — entry point, creates sessions
+- `Session` — session lifecycle (wait_ready, refresh, release)
+- `Device` — device operations
+  - `device.deploy()` — model deployment
+  - `device.display.*` — display control (play, show, stop)
+  - `device.inference.*` — built-in inference (stock OS only)
+  - `device.exec()` — run commands via SSH
+  - `device.ssh()` — SSH connection details
+  - `device.info()` — device info report
+  - `device.stream_url()` — camera stream URL (stock OS only)
+
+## Development
+
+```bash
+cd core/python
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+MIT

edgelens_sdk-0.2.1/edgelens/__init__.py

@@ -0,0 +1,61 @@
+"""EdgeLens Python client.
+
+Test edge AI models on real hardware from your Python code.
+
+Example:
+    from edgelens import EdgeLensClient
+
+    client = EdgeLensClient(api_key="...")
+    session = client.create_session(device_type="recamera-2002", os="stock-os")
+    session.wait_ready()
+
+    session.device.deploy(model="./models/face_detection.cvimodel")
+    session.device.display.play("./test_data/crowd_scene.mp4")
+    stats = session.device.inference.run(duration=30)
+
+    assert stats.fps.avg > 15
+    session.release()
+"""
+
+from edgelens._version import __version__ as __version__
+from edgelens._http import RetryPolicy
+from edgelens.client import EdgeLensClient
+from edgelens.errors import (
+    EdgeLensError,
+    AuthenticationError,
+    SessionError,
+    DeviceError,
+    TimeoutError,
+)
+from edgelens.session import Session
+from edgelens.device import Device
+from edgelens.types import (
+    DeviceType,
+    OSType,
+    SessionStatus,
+    InferenceStats,
+    Detection,
+    DeviceInfo,
+    BBox,
+    PercentileStats,
+)
+
+__all__ = [
+    "EdgeLensClient",
+    "Session",
+    "Device",
+    "DeviceType",
+    "OSType",
+    "SessionStatus",
+    "InferenceStats",
+    "Detection",
+    "DeviceInfo",
+    "BBox",
+    "PercentileStats",
+    "RetryPolicy",
+    "EdgeLensError",
+    "AuthenticationError",
+    "SessionError",
+    "DeviceError",
+    "TimeoutError",
+]