{"id":19454156,"url":"https://github.com/ultralytics/xview-docker","last_synced_at":"2025-04-25T04:31:08.951Z","repository":{"id":103258417,"uuid":"141650751","full_name":"ultralytics/xview-docker","owner":"ultralytics","description":"xView 2018 Object Detection Challenge: Docker container submission code","archived":false,"fork":false,"pushed_at":"2025-03-28T01:35:06.000Z","size":32351,"stargazers_count":8,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-28T02:30:51.445Z","etag":null,"topics":["ai","challenge","docker","ml","ultralytics","xview","yolov3"],"latest_commit_sha":null,"homepage":"https://challenge.xviewdataset.org/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ultralytics.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},"funding":{"github":"glenn-jocher","patreon":"ultralytics","open_collective":"ultralytics"}},"created_at":"2018-07-20T01:59:13.000Z","updated_at":"2025-03-28T01:35:08.000Z","dependencies_parsed_at":null,"dependency_job_id":"b1386231-4700-44bf-81e7-61e26066e40a","html_url":"https://github.com/ultralytics/xview-docker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ultralytics%2Fxview-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ultralytics%2Fxview-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ultralytics%2Fxview-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ultralytics%2Fxview-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ultralytics","download_url":"https://codeload.github.com/ultralytics/xview-docker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250754668,"owners_count":21481852,"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":["ai","challenge","docker","ml","ultralytics","xview","yolov3"],"created_at":"2024-11-10T17:08:11.833Z","updated_at":"2025-04-25T04:31:03.942Z","avatar_url":"https://github.com/ultralytics.png","language":"Python","funding_links":["https://github.com/sponsors/glenn-jocher","https://patreon.com/ultralytics","https://opencollective.com/ultralytics"],"categories":[],"sub_categories":[],"readme":"\u003cbr\u003e\n\u003ca href=\"https://www.ultralytics.com/\" target=\"_blank\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/ultralytics/assets/main/logo/Ultralytics_Logotype_Original.svg\" width=\"320\" alt=\"Ultralytics logo\"\u003e\u003c/a\u003e\n\n# Introduction :wave:\n\nWelcome to the Ultralytics software directory! Our codebase is open-source and 🔓 **distributed under the AGPL-3.0 license**. Explore more about Ultralytics and our cutting-edge projects at [our website](http://www.ultralytics.com).\n\n[![Ultralytics Actions](https://github.com/ultralytics/xview-docker/actions/workflows/format.yml/badge.svg)](https://github.com/ultralytics/xview-docker/actions/workflows/format.yml) \u003ca href=\"https://discord.com/invite/ultralytics\"\u003e\u003cimg alt=\"Discord\" src=\"https://img.shields.io/discord/1089800235347353640?logo=discord\u0026logoColor=white\u0026label=Discord\u0026color=blue\"\u003e\u003c/a\u003e \u003ca href=\"https://community.ultralytics.com/\"\u003e\u003cimg alt=\"Ultralytics Forums\" src=\"https://img.shields.io/discourse/users?server=https%3A%2F%2Fcommunity.ultralytics.com\u0026logo=discourse\u0026label=Forums\u0026color=blue\"\u003e\u003c/a\u003e \u003ca href=\"https://reddit.com/r/ultralytics\"\u003e\u003cimg alt=\"Ultralytics Reddit\" src=\"https://img.shields.io/reddit/subreddit-subscribers/ultralytics?style=flat\u0026logo=reddit\u0026logoColor=white\u0026label=Reddit\u0026color=blue\"\u003e\u003c/a\u003e\n\n# Project Overview :page_facing_up:\n\nThis repository, located at https://github.com/ultralytics/xview-docker, is designed to help you dockerize and deploy machine learning models for the xView detection challenge 🔍. It should be used in combination with the trained models from our [xView YOLOv3 repository](https://github.com/ultralytics/xview-yolov3).\n\n# Prerequisites :bookmark_tabs:\n\nTo get started, you need Docker and Python 3.6 (or newer). Ensure that you have all the required packages by installing them via pip:\n\n```bash\npip3 install -U -r requirements.txt\n```\n\nYou should have the following packages:\n\n- `numpy` for numerical operations,\n- `scipy` for scientific computations,\n- `torch` as the deep learning framework, and\n- `opencv-python` for computer vision tasks.\n\n# Dockerization Steps :whale:\n\nBelow are the steps to containerize this repository for the xView challenge using `run.sh`.\n\n## Step 1: Copy Best Model Checkpoint\n\nGet the best performing checkpoint from our [xView YOLOv3 model](https://github.com/ultralytics/xview-yolov3):\n\n```bash\nmkdir xview-docker/checkpoints\ncp xview-yolov3/checkpoints/best.pt xview-docker/checkpoints\n```\n\n## Step 2: Build and Tag The Docker Container\n\nHere's how to remove older images, set the right permissions for the script, build the image, and tag it appropriately (e.g., `ultralytics/xview:v30`):\n\n```bash\nsudo docker image prune -a\ncd xview-docker \u0026\u0026 chmod +x run.sh\nsudo docker build -t friendlyhello .\nsudo docker tag friendlyhello ultralytics/xview:v30\n```\n\n## Step 3: Run Container on Example Image\n\nTest the container with the example image while specifying CPU and memory usage:\n\n```bash\ntime sudo docker run -it --memory=8g --cpus=1 ultralytics/xview:v30 bash -c './run.sh /1047.tif /tmp \u0026\u0026 cat /tmp/1047.tif.txt'\n```\n\nHere's a sample output:\n\n![Example Detection](https://github.com/ultralytics/xview-docker/blob/main/output_img/1047.jpg)\n\n## Step 4: Push to Docker Hub\n\nFinally, upload the container to Docker Hub ready for challenge submission:\n\n```bash\nsudo docker push ultralytics/xview:v30\n```\n\nYou can find the container now hosted at [Docker Hub](https://hub.docker.com/r/ultralytics/xview/), prepared for the challenge 🚀.\n\n# 🤝 Contribute\n\nWe welcome contributions from the community! Whether you're fixing bugs, adding new features, or improving documentation, your input is invaluable. Take a look at our [Contributing Guide](https://docs.ultralytics.com/help/contributing/) to get started. Also, we'd love to hear about your experience with Ultralytics products. Please consider filling out our [Survey](https://www.ultralytics.com/survey?utm_source=github\u0026utm_medium=social\u0026utm_campaign=Survey). A huge 🙏 and thank you to all of our contributors!\n\n\u003c!-- Ultralytics contributors --\u003e\n\n\u003ca href=\"https://github.com/ultralytics/yolov5/graphs/contributors\"\u003e\n\u003cimg width=\"100%\" src=\"https://github.com/ultralytics/assets/raw/main/im/image-contributors.png\" alt=\"Ultralytics open-source contributors\"\u003e\u003c/a\u003e\n\n# ©️ License\n\nUltralytics is excited to offer two different licensing options to meet your needs:\n\n- **AGPL-3.0 License**: Perfect for students and hobbyists, this [OSI-approved](https://opensource.org/license) open-source license encourages collaborative learning and knowledge sharing. Please refer to the [LICENSE](https://github.com/ultralytics/ultralytics/blob/main/LICENSE) file for detailed terms.\n- **Enterprise License**: Ideal for commercial use, this license allows for the integration of Ultralytics software and AI models into commercial products without the open-source requirements of AGPL-3.0. For use cases that involve commercial applications, please contact us via [Ultralytics Licensing](https://www.ultralytics.com/license).\n\n# 📬 Contact Us\n\nFor bug reports, feature requests, and contributions, head to [GitHub Issues](https://github.com/ultralytics/xview-docker/issues). For questions and discussions about this project and other Ultralytics endeavors, join us on [Discord](https://discord.com/invite/ultralytics)!\n\n\u003cbr\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/ultralytics\"\u003e\u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-social-github.png\" width=\"3%\" alt=\"Ultralytics GitHub\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-transparent.png\" width=\"3%\" alt=\"space\"\u003e\n  \u003ca href=\"https://www.linkedin.com/company/ultralytics/\"\u003e\u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-social-linkedin.png\" width=\"3%\" alt=\"Ultralytics LinkedIn\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-transparent.png\" width=\"3%\" alt=\"space\"\u003e\n  \u003ca href=\"https://twitter.com/ultralytics\"\u003e\u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-social-twitter.png\" width=\"3%\" alt=\"Ultralytics Twitter\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-transparent.png\" width=\"3%\" alt=\"space\"\u003e\n  \u003ca href=\"https://youtube.com/ultralytics\"\u003e\u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-social-youtube.png\" width=\"3%\" alt=\"Ultralytics YouTube\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-transparent.png\" width=\"3%\" alt=\"space\"\u003e\n  \u003ca href=\"https://www.tiktok.com/@ultralytics\"\u003e\u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-social-tiktok.png\" width=\"3%\" alt=\"Ultralytics TikTok\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-transparent.png\" width=\"3%\" alt=\"space\"\u003e\n  \u003ca href=\"https://ultralytics.com/bilibili\"\u003e\u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-social-bilibili.png\" width=\"3%\" alt=\"Ultralytics BiliBili\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-transparent.png\" width=\"3%\" alt=\"space\"\u003e\n  \u003ca href=\"https://discord.com/invite/ultralytics\"\u003e\u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-social-discord.png\" width=\"3%\" alt=\"Ultralytics Discord\"\u003e\u003c/a\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fultralytics%2Fxview-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fultralytics%2Fxview-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fultralytics%2Fxview-docker/lists"}