{"id":13631533,"url":"https://github.com/openvisionapi/ova-client","last_synced_at":"2025-04-17T22:31:04.956Z","repository":{"id":208049273,"uuid":"365035723","full_name":"openvisionapi/ova-client","owner":"openvisionapi","description":" OpenVisionAPI Python Client ","archived":false,"fork":false,"pushed_at":"2023-11-22T17:36:58.000Z","size":1298,"stargazers_count":47,"open_issues_count":0,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-08-01T22:48:48.668Z","etag":null,"topics":["computer-vision","machine-learning","object-detection","python"],"latest_commit_sha":null,"homepage":"https://openvisionapi.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/openvisionapi.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2021-05-06T20:58:02.000Z","updated_at":"2024-07-09T22:39:44.000Z","dependencies_parsed_at":"2024-01-19T11:25:31.110Z","dependency_job_id":null,"html_url":"https://github.com/openvisionapi/ova-client","commit_stats":null,"previous_names":["openvisionapi/ova-client"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openvisionapi%2Fova-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openvisionapi%2Fova-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openvisionapi%2Fova-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openvisionapi%2Fova-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openvisionapi","download_url":"https://codeload.github.com/openvisionapi/ova-client/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223768507,"owners_count":17199355,"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","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":["computer-vision","machine-learning","object-detection","python"],"created_at":"2024-08-01T22:02:29.167Z","updated_at":"2024-11-08T23:30:54.535Z","avatar_url":"https://github.com/openvisionapi.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\u003ch1\u003e OpenVisionAPI Client \u003c/h1\u003e\n\n![Static Badge](https://img.shields.io/badge/AGPLV3-License?style=for-the-badge\u0026label=LIcense)\n\n\u003c/div\u003e\n\n## 🚀 Getting Started\n\n### Prerequisites\n\nYou'll need to install:\n\n- [just](https://github.com/casey/just)\n- [poetry](https://python-poetry.org/)\n\n### Setup\n\nInstall the dependencies\n\n```bash\n$ just setup\n```\n\n### Usage\n\n```\n$ poetry run ./ova.py detection /path/to/image\n```\n\nThe available options for the cli:\n\n```bashh\n$ poetry run ./ova.py detection --help\nUsage: ova_client.py detection [OPTIONS] IMAGE\n\nOptions:\n  -s, --save       Save the output image.\n  -v, --visualize  Draw bounding boxes on the detected objects.\n  --help           Show this message and exit.\n```\n\n### Want to use httpie ?\n\n```\n$ pip install --user httpie\n$ http -f POST https://api.openvisionapi.com/api/v1/detection  model=\"yolov4\" image@images/cat.jpeg\n\n{\n    \"description\": \"Detected objects\",\n    \"predictions\": [\n        {\n            \"bbox\": {\n                \"x1\": 442,\n                \"x2\": 982,\n                \"y1\": 199,\n                \"y2\": 1270\n            },\n            \"label\": \"cat\",\n            \"score\": \"0.93\"\n        }\n    ]\n}\n```\n\n### Want to use curl ?\n\n```\n$ curl -X POST https://api.openvisionapi.com/api/v1/detection \\\n  -F \"model=yolov4\" \\\n  -F \"image=@images/cat.jpeg\"\n\n{\n  \"description\": \"Detected objects\",\n  \"predictions\": [\n    {\n      \"bbox\": {\n        \"x1\": 442,\n        \"x2\": 982,\n        \"y1\": 199,\n        \"y2\": 1270\n      },\n      \"label\": \"cat\",\n      \"score\": \"0.93\"\n    }\n  ]\n}\n```\n\n### Configuration\n\nThe configuration can be set up using the following env variables:\n\n**OVA_DETECTION_URL** : The URL to the OpenVisionAPI server. The default is `https://api.openvisionapi.com/api/v1/detection`\n\n**OVA_OUTPUT_DIR** : The directory where to store the result. The default is `./output`\n\n\u003cbr\u003e\n\n## ⛏️ Built Using\n\n- [Pillow](https://github.com/python-pillow/Pillow)\n- [click](https://github.com/pallets/click)\n- [requests](https://github.com/psf/requests)\n- [pygments](https://github.com/pygments/pygments)\n\n\u003cbr\u003e\n\n## 🤝 Contributing\n\nYour contributions are welcome !\n\n### Setting up development environment\n\nTo setup the development environment, simply run this command\n\n```bash\n$ just dev\n```\n\n### Code-style checks\n\nruff and mypy are used to ensure that contributions are stylized in a uniform manner.\n\n- [ruff](https://github.com/astral-sh/ruff) is used as a linter and a code formatter.\n- [mypy](https://github.com/python/mypy) is used for static typing\n\n\u003cbr\u003e\n\n## 🔧 Tests\n\nTo run the tests, simply run those commands\n\n```bash\n$ just dev\n$ just test\n```\n\n\u003cbr\u003e\n\n## ⚖️ License\n\nAGPLv3\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenvisionapi%2Fova-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenvisionapi%2Fova-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenvisionapi%2Fova-client/lists"}