{"id":16031729,"url":"https://github.com/realorangeone/zoloto","last_synced_at":"2025-06-19T23:41:01.588Z","repository":{"id":35027282,"uuid":"185201840","full_name":"RealOrangeOne/zoloto","owner":"RealOrangeOne","description":"A fiducial marker system powered by OpenCV - Supports ArUco and April","archived":false,"fork":false,"pushed_at":"2024-03-20T16:58:48.000Z","size":1957,"stargazers_count":13,"open_issues_count":21,"forks_count":7,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-16T00:04:22.806Z","etag":null,"topics":["computer-vision","fiducial-markers","hacktoberfest","opencv","python"],"latest_commit_sha":null,"homepage":"https://zoloto.readthedocs.io/en/stable/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RealOrangeOne.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}},"created_at":"2019-05-06T13:25:30.000Z","updated_at":"2023-11-19T13:15:58.000Z","dependencies_parsed_at":"2023-01-15T12:18:58.797Z","dependency_job_id":null,"html_url":"https://github.com/RealOrangeOne/zoloto","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RealOrangeOne%2Fzoloto","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RealOrangeOne%2Fzoloto/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RealOrangeOne%2Fzoloto/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RealOrangeOne%2Fzoloto/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RealOrangeOne","download_url":"https://codeload.github.com/RealOrangeOne/zoloto/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243841150,"owners_count":20356441,"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","fiducial-markers","hacktoberfest","opencv","python"],"created_at":"2024-10-08T21:05:09.566Z","updated_at":"2025-03-16T07:32:25.149Z","avatar_url":"https://github.com/RealOrangeOne.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Zoloto\n\n[![Documentation Status](https://readthedocs.org/projects/zoloto/badge/?version=stable)](https://zoloto.readthedocs.io/en/stable/?badge=stable)\n![Tests Status](https://github.com/RealOrangeOne/zoloto/workflows/Tests/badge.svg)\n![PyPI](https://img.shields.io/pypi/v/zoloto.svg)\n![PyPI - Python Version](https://img.shields.io/pypi/pyversions/zoloto.svg)\n![PyPI - Wheel](https://img.shields.io/pypi/wheel/zoloto.svg)\n![PyPI - Status](https://img.shields.io/pypi/status/zoloto.svg)\n![PyPI - License](https://img.shields.io/pypi/l/zoloto.svg)\n\nA fiducial marker system powered by OpenCV - Supports ArUco and April\n\n[Documentation](https://zoloto.readthedocs.io/)\n\n## Installation\n\n```text\npip install zoloto\n```\n\n### OpenCV\n\nOpenCV should be installed manually, ideally through your system package manager. This makes it easier to customize your OpenCV installation for your system, or use the optimal settings for your OS / hardware. Note that you may need to install `opencv-contrib` as well as `opencv`.\n\nIf you'd rather have one installed automatically, install the extra `opencv`:\n\n```text\npip install zoloto[opencv]\n```\n\nNote that this version lacks hardware acceleration. See [the README](https://github.com/opencv/opencv-python#readme) for more details.\n\nFor storage-constrained environments, there's also `opencv-contrib-python-headless`, which should be installed manually.\n\n## Examples\n\n```python\nfrom pathlib import Path\n\nfrom zoloto import MarkerType\nfrom zoloto.cameras import ImageFileCamera\n\n\nwith ImageFileCamera(Path(\"my-image.png\"), marker_type=MarkerType.ARUCO_6X6) as camera:\n    camera.save_frame(\"my-annotated-image.png\", annotate=True)\n    print(\"I saved an image with {} markers in.\".format(len(camera.get_visible_markers())))\n```\n\n[More examples](./zoloto/cli/)\n\nZoloto ships with a CLI (aptly named `zoloto`), which contains some helpful utils for working with Zoloto and fiducial markers.\n\n## Development setup\n\n`./scripts/setup.sh` will create a virtual environment, and install all the required development dependencies into it.\n\nNote that this will not install a version of OpenCV for you. For that, run `./scripts/setup.sh opencv`.\n\nThere are some additional useful scripts to assist:\n\n- `./scripts/test.sh`: Run the unit tests and linters\n- `./scripts/fix.sh`: Automatically fix issues from `black` and `isort`\n- `./scripts/benchmark.sh`: Run benchmarks (these can take a couple minutes depending on your hardware)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frealorangeone%2Fzoloto","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frealorangeone%2Fzoloto","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frealorangeone%2Fzoloto/lists"}