{"id":29111977,"url":"https://github.com/seeed-projects/hailo_toolbox","last_synced_at":"2025-10-08T23:17:57.014Z","repository":{"id":301069456,"uuid":"1000656209","full_name":"Seeed-Projects/hailo_toolbox","owner":"Seeed-Projects","description":null,"archived":false,"fork":false,"pushed_at":"2025-08-01T01:06:16.000Z","size":824,"stargazers_count":3,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-01T03:18:37.065Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Seeed-Projects.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-12T06:01:22.000Z","updated_at":"2025-08-01T01:06:20.000Z","dependencies_parsed_at":"2025-06-25T02:33:55.833Z","dependency_job_id":"d16803c7-b252-4891-9e2b-865dad284558","html_url":"https://github.com/Seeed-Projects/hailo_toolbox","commit_stats":null,"previous_names":["seeed-projects/hailo_toolbox"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Seeed-Projects/hailo_toolbox","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Seeed-Projects%2Fhailo_toolbox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Seeed-Projects%2Fhailo_toolbox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Seeed-Projects%2Fhailo_toolbox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Seeed-Projects%2Fhailo_toolbox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Seeed-Projects","download_url":"https://codeload.github.com/Seeed-Projects/hailo_toolbox/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Seeed-Projects%2Fhailo_toolbox/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279000724,"owners_count":26082862,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-08T02:00:06.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-29T10:03:18.753Z","updated_at":"2025-10-08T23:17:57.009Z","avatar_url":"https://github.com/Seeed-Projects.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":" # Hailo Toolbox\n\n\u003e **Language**: 🇺🇸 English | [🇨🇳 中文](README_zh.md)\n\nA comprehensive deep learning model conversion and inference toolkit designed specifically for Hailo AI processors. This project aims to simplify the AI application development workflow based on Hailo devices, providing developers with a one-stop solution from model conversion to deployment inference.\n\n- [Quick Start](docs/en/GET_STAR.md)\n- [Developer Documentation](docs/en/DEV.md)\n- [Model Conversion](docs/en/CONVERT.md)\n- [Model Inference](docs/en/INFERENCE.md)\n\n\n## 📦 Installation\n\n### Hardware Prepare\n\n|                                               reComputer AI R2140                                              |                                               reComputer AI Industrial R2145                                              |\n| :----------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------: |\n| ![Raspberry Pi AI Kit](https://media-cdn.seeedstudio.com/media/catalog/product/cache/bb49d3ec4ee05b6f018e93f896b8a25d/i/m/image114993560.jpeg) | ![reComputer R1100](https://media-cdn.seeedstudio.com/media/catalog/product/cache/bb49d3ec4ee05b6f018e93f896b8a25d/2/-/2-114993595-recomputer-ai-industrial-r2135-12.jpg) |\n| [**Purchase Now**](https://www.seeedstudio.com/reComputer-AI-R2130-12-p-6368.html?utm_source=PiAICourse\u0026utm_medium=github\u0026utm_campaign=Course) | [**Purchase Now**](https://www.seeedstudio.com/reComputer-AI-Industrial-R2135-12-p-6432.html?utm_source=PiAICourse\u0026utm_medium=github\u0026utm_campaign=Course) |\n\n\n### Requirements\n- Python 3.8 ≤ version \u003c 3.12\n- Linux (recommended Ubuntu 18.04+), Windows 10+, macOS 10.15+\n\n### Hailo Dataflow Compiler\n\n\u003e **Note:** You only need to install Hailo DFC on your own machine if you need to convert your own model\n\n- Hailo Dataflow Compiler (for model conversion) [Installation Tutorial](https://wiki.seeedstudio.com/tutorial_of_ai_kit_with_raspberrypi5_about_yolov8n_object_detection/)\n\n### HailoRT \n\n\u003e **Note:** You can use command like below if you use reComputer\n\n```bash\nsudo apt update \u0026\u0026 sudo apt full-upgrade -y\n\nsudo apt install hailo-all -y\n```\n\n\u003e **Note:** Other hardwares please follow tutorial below\n\n- HailoRT (for inference) [Installation Tutorial](https://wiki.seeedstudio.com/benchmark_of_multistream_inference_on_raspberrypi5_with_hailo8/#prepare-software)\n\n### Install from Source\n```bash\n# Get project code\ngit clone https://github.com/Seeed-Projects/hailo_toolbox.git\ncd hailo_toolbox\n# Install hailo-toolbox\npip install -e .\n```\n\n### Install from Virtual Environment (Recommended)\n\n```bash\n# Create virtual environment\npython -m venv hailo_env\n# Activate virtual environment\nsource hailo_env/bin/activate\n# Get project code\ngit clone https://github.com/Seeed-Projects/hailo_toolbox.git\ncd hailo_toolbox\n# Install hailo-toolbox\npip install -e .\n```\n\n### Verify Installation\n```bash\nhailo-toolbox --version\nhailo-toolbox --help\n```\n\n## 🚀 Quick Start\n\n### Model Conversion\n```bash\n# Convert ONNX model to HEF format\nhailo-toolbox convert model.onnx --hw-arch hailo8 --calib-set-path ./calibration_data\n\n# Quick conversion with random calibration\nhailo-toolbox convert model.onnx --use-random-calib-set\n```\n\n### Model Inference\n```python\nfrom hailo_toolbox import create_source\nfrom hailo_toolbox.models import ModelsZoo\n\n# Create input source\nsource = create_source(\"video.mp4\")  # or camera: 0, or image: \"image.jpg\"\n\n# Load model from ModelsZoo\ninference = ModelsZoo.detection.yolov8s()\n\n# Process frames\nfor img in source:\n    results = inference.predict(img)\n    for result in results:\n        boxes = result.get_boxes()\n        scores = result.get_scores()\n        class_ids = result.get_class_ids()\n        print(f\"Detected {len(result)} objects\")\n```\n\n### 📖 Complete Examples\nDetailed usage examples for each supported task:\n\n```bash\n# Browse all available examples\nls examples/Hailo_*.py\n\n# Object detection with visualization\npython examples/Hailo_Object_Detection.py\n\n# Human pose estimation\npython examples/Hailo_Pose_Estimation.py\n\n# Face detection and landmarks\npython examples/Hailo_Face_Detection.py\n```\n\n\u003e 📚 **Learn More**: See [`examples/README.md`](examples/README.md) for detailed documentation of all supported tasks and models.\n\n### Custom Callback Registration\n```python\nfrom hailo_toolbox.inference.core import CALLBACK_REGISTRY\n\n@CALLBACK_REGISTRY.registryPostProcessor(\"custom_model\")\nclass CustomPostProcessor:\n    def __init__(self, config):\n        self.config = config\n    \n    def __call__(self, results, original_shape=None):\n        # Custom post-processing logic\n        return processed_results\n```\n\n## 📚 Documentation\n\n### 🚀 Getting Started\n- **[Examples Directory](examples/)** - Complete working examples for all supported tasks\n- **[Examples README](examples/README.md)** - Detailed guide to all available examples\n- **[Quick Start Guide](docs/en/GET_STAR.md)** / **[中文](docs/zh/GET_STAR.md)** - Installation and basic usage\n\n### 📖 User Guides  \n- **[Model Conversion Guide](docs/en/CONVERT.md)** / **[中文](docs/zh/CONVERT.md)** - How to convert models to HEF format\n- **[Model Inference Guide](docs/en/INFERENCE.md)** / **[中文](docs/zh/INFERENCE.md)** - How to run inference with converted models\n- **[Input Sources Guide](docs/en/SOURCE.md)** / **[中文](docs/zh/SOURCE.md)** - Supported input sources and configuration\n\n### 🔧 Developer Documentation\n- **[Developer Guide](docs/en/DEV.md)** / **[中文](docs/zh/DEV.md)** - How to implement custom models and callbacks\n- **[Project Introduction](docs/en/INTRODUCE.md)** / **[中文](docs/zh/INTRODUCE.md)** - Detailed project overview and architecture\n\n\n\n### 🚀 Quick Examples\n\n```bash\n# Run object detection example\npython examples/Hailo_Object_Detection.py\n\n# Run pose estimation example  \npython examples/Hailo_Pose_Estimation.py\n\n# Run face detection example\npython examples/Hailo_Face_Detection.py\n\n# View all examples\nls examples/Hailo_*.py\n```\n\n\u003e 💡 **Tip**: Check the [`examples/`](examples/) directory for complete working examples of each task type. Each example includes model loading, inference, and result processing.\n\n\n## 🤝 Contributing\n\nWe welcome community contributions! Please see our contributing guidelines:\n\n1. **Report Issues**: Submit bug reports or feature requests\n2. **Code Contributions**: Fork the project and submit pull requests\n3. **Documentation**: Improve documentation and examples\n4. **Testing**: Add test cases and performance benchmarks\n\n\n\n## 🔗 Links\n\n- **GitHub Repository**: [https://github.com/Seeed-Projects/hailo_toolbox](https://github.com/Seeed-Projects/hailo_toolbox)\n- **Issues**: [https://github.com/Seeed-Projects/hailo_toolbox/issues](https://github.com/Seeed-Projects/hailo_toolbox/issues)\n- **Hailo AI**: [https://hailo.ai](https://hailo.ai)\n\n## 📞 Support\n\n- **GitHub Issues**: For bug reports and feature requests\n- **Documentation**: Comprehensive guides and API reference\n- **Community**: Join our developer community discussions\n\n---\n\n*Making AI inference simpler and more efficient with Hailo Toolbox!* \n\n## 📄 License\n\nThis project is licensed under the MIT License. See [LICENSE](LICENSE) for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseeed-projects%2Fhailo_toolbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseeed-projects%2Fhailo_toolbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseeed-projects%2Fhailo_toolbox/lists"}