armanid 2.0.0__tar.gz

armanid-2.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Arman Guriyan — Epic Rabbit
+
+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.

armanid-2.0.0/PKG-INFO

@@ -0,0 +1,130 @@
+Metadata-Version: 2.4
+Name: armanid
+Version: 2.0.0
+Summary: Armanid — Object Detection Library by Epic Rabbit
+Author-email: Arman Guriyan <arman@epicrabbit.io>
+License: MIT
+Project-URL: Homepage, https://epicrabbit.io
+Project-URL: Repository, https://github.com/epicrabbit/armanid
+Project-URL: Documentation, https://docs.epicrabbit.io
+Keywords: object-detection,computer-vision,armanid,epic-rabbit,deep-learning,yolo,detection
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+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 :: Artificial Intelligence
+Classifier: Topic :: Scientific/Engineering :: Image Recognition
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: epic-rabbit>=1.0.0
+Requires-Dist: numpy>=1.22.2
+Requires-Dist: pillow>=7.1.2
+Requires-Dist: opencv-python>=4.6.0
+Dynamic: license-file
+
+# Armanid
+
+**Professional Object Detection Library — by Epic Rabbit**
+
+Armanid is a clean, simple, and powerful object detection library built on the Epic Rabbit engine. Detect objects in images, videos, and webcams with just a few lines of code.
+
+## Installation
+
+```bash
+pip install epic-rabbit
+pip install armanid
+```
+
+## Quick Start
+
+```python
+from armanid import Armanid
+
+model = Armanid("armanid-nano")
+results = model.detect("image.jpg")
+results[0].show()
+```
+
+## Webcam Detection
+
+```python
+from armanid import Armanid
+from armanid.utils import run_webcam
+
+model = Armanid("armanid-nano")
+run_webcam(model, cam_index=0, conf=0.25)
+```
+
+## All Features
+
+```python
+from armanid import Armanid
+
+model = Armanid("armanid-nano")
+
+results = model.detect("image.jpg", conf=0.25)
+
+for box in results[0].boxes:
+    print(box.label, box.conf, box.xyxy)
+
+results[0].save("output.jpg")
+
+for result in model.track("video.mp4", stream=True):
+    for box in result.boxes:
+        print(box.track_id, box.label)
+
+model.train(data="dataset.yaml", epochs=100)
+
+model.export(format="onnx")
+```
+
+## Available Models
+
+| Model | Description |
+|-------|-------------|
+| `armanid-nano` | Fastest, smallest |
+| `armanid-small` | Fast, good accuracy |
+| `armanid-medium` | Balanced |
+| `armanid-large` | High accuracy |
+| `armanid-xlarge` | Maximum accuracy |
+| `armanid-nano-seg` | Segmentation |
+| `armanid-nano-pose` | Pose estimation |
+
+## Detection Result API
+
+```python
+result = model.detect("image.jpg")[0]
+
+result.boxes          # List of BoundingBox objects
+result.labels         # ["person", "car", ...]
+result.confidences    # [0.92, 0.87, ...]
+result.summary()      # {"person": 2, "car": 1}
+result.show()         # Display image
+result.save("out.jpg")
+result.plot()         # Returns annotated numpy array
+
+box = result.boxes[0]
+box.label             # "person"
+box.conf              # 0.92
+box.xyxy              # (x1, y1, x2, y2)
+box.xywh              # (cx, cy, w, h)
+box.width
+box.height
+box.area
+box.track_id          # When tracking
+```
+
+## Creator
+
+**Arman Guriyan** — Epic Rabbit
+
+## License
+
+MIT License

armanid-2.0.0/README.md

@@ -0,0 +1,99 @@
+# Armanid
+
+**Professional Object Detection Library — by Epic Rabbit**
+
+Armanid is a clean, simple, and powerful object detection library built on the Epic Rabbit engine. Detect objects in images, videos, and webcams with just a few lines of code.
+
+## Installation
+
+```bash
+pip install epic-rabbit
+pip install armanid
+```
+
+## Quick Start
+
+```python
+from armanid import Armanid
+
+model = Armanid("armanid-nano")
+results = model.detect("image.jpg")
+results[0].show()
+```
+
+## Webcam Detection
+
+```python
+from armanid import Armanid
+from armanid.utils import run_webcam
+
+model = Armanid("armanid-nano")
+run_webcam(model, cam_index=0, conf=0.25)
+```
+
+## All Features
+
+```python
+from armanid import Armanid
+
+model = Armanid("armanid-nano")
+
+results = model.detect("image.jpg", conf=0.25)
+
+for box in results[0].boxes:
+    print(box.label, box.conf, box.xyxy)
+
+results[0].save("output.jpg")
+
+for result in model.track("video.mp4", stream=True):
+    for box in result.boxes:
+        print(box.track_id, box.label)
+
+model.train(data="dataset.yaml", epochs=100)
+
+model.export(format="onnx")
+```
+
+## Available Models
+
+| Model | Description |
+|-------|-------------|
+| `armanid-nano` | Fastest, smallest |
+| `armanid-small` | Fast, good accuracy |
+| `armanid-medium` | Balanced |
+| `armanid-large` | High accuracy |
+| `armanid-xlarge` | Maximum accuracy |
+| `armanid-nano-seg` | Segmentation |
+| `armanid-nano-pose` | Pose estimation |
+
+## Detection Result API
+
+```python
+result = model.detect("image.jpg")[0]
+
+result.boxes          # List of BoundingBox objects
+result.labels         # ["person", "car", ...]
+result.confidences    # [0.92, 0.87, ...]
+result.summary()      # {"person": 2, "car": 1}
+result.show()         # Display image
+result.save("out.jpg")
+result.plot()         # Returns annotated numpy array
+
+box = result.boxes[0]
+box.label             # "person"
+box.conf              # 0.92
+box.xyxy              # (x1, y1, x2, y2)
+box.xywh              # (cx, cy, w, h)
+box.width
+box.height
+box.area
+box.track_id          # When tracking
+```
+
+## Creator
+
+**Arman Guriyan** — Epic Rabbit
+
+## License
+
+MIT License

armanid-2.0.0/armanid/__init__.py

@@ -0,0 +1,21 @@
+"""
+Armanid — Object Detection Library
+Creator  : Arman Guriyan
+Company  : Epic Rabbit
+Version  : 2.0.0
+"""
+__version__ = "2.0.0"
+__author__  = "Arman Guriyan"
+__company__ = "Epic Rabbit"
+__email__   = "arman@epicrabbit.io"
+__license__ = "MIT"
+
+from armanid.model   import Armanid
+from armanid.results import DetectionResult, BoundingBox
+from armanid.utils   import draw_detections, save_detections, run_webcam
+
+__all__ = [
+    "Armanid","DetectionResult","BoundingBox",
+    "draw_detections","save_detections","run_webcam",
+    "__version__","__author__","__company__",
+]

armanid-2.0.0/armanid/_engine/__init__.py

@@ -0,0 +1,48 @@
+# Ultralytics 🚀 AGPL-3.0 License - https://ultralytics.com/license
+
+__version__ = "8.4.31"
+
+import importlib
+import os
+from typing import TYPE_CHECKING
+
+# Set ENV variables (place before imports)
+if not os.environ.get("OMP_NUM_THREADS"):
+    os.environ["OMP_NUM_THREADS"] = "1"  # default for reduced CPU utilization during training
+
+from armanid._engine.utils import ASSETS, SETTINGS
+from armanid._engine.utils.checks import check_yolo as checks
+from armanid._engine.utils.downloads import download
+
+settings = SETTINGS
+
+MODELS = ("YOLO", "YOLOWorld", "YOLOE", "NAS", "SAM", "FastSAM", "RTDETR")
+
+__all__ = (
+    "__version__",
+    "ASSETS",
+    *MODELS,
+    "checks",
+    "download",
+    "settings",
+)
+
+if TYPE_CHECKING:
+    # Enable hints for type checkers
+    from ultralytics.models import YOLO, YOLOWorld, YOLOE, NAS, SAM, FastSAM, RTDETR  # noqa
+
+
+def __getattr__(name: str):
+    """Lazy-import model classes on first access."""
+    if name in MODELS:
+        return getattr(importlib.import_module("armanid._engine.models"), name)
+    raise AttributeError(f"module {__name__} has no attribute {name}")
+
+
+def __dir__():
+    """Extend dir() to include lazily available model names for IDE autocompletion."""
+    return sorted(set(globals()) | set(MODELS))
+
+
+if __name__ == "__main__":
+    print(__version__)