{"id":14958951,"url":"https://github.com/mariochampion/roboflow","last_synced_at":"2026-01-19T14:12:27.536Z","repository":{"id":145301822,"uuid":"114911330","full_name":"mariochampion/roboflow","owner":"mariochampion","description":"RoboFlow is a semi-automated TensorFlow image classification explorer in a python command line app.","archived":false,"fork":false,"pushed_at":"2019-07-15T17:50:40.000Z","size":194,"stargazers_count":4,"open_issues_count":6,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-04T07:14:23.347Z","etag":null,"topics":["command-line","command-line-app","image-classification","python","python-2","tensorflow","tensorflow-experiments"],"latest_commit_sha":null,"homepage":"https://mariochampion.github.io/roboflow/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mariochampion.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}},"created_at":"2017-12-20T17:01:20.000Z","updated_at":"2021-07-23T05:59:59.000Z","dependencies_parsed_at":null,"dependency_job_id":"f4882f9f-c89e-4a14-80f6-dfa02767bcce","html_url":"https://github.com/mariochampion/roboflow","commit_stats":{"total_commits":288,"total_committers":2,"mean_commits":144.0,"dds":0.00347222222222221,"last_synced_commit":"24ac6e174d410cf3da3e0e98b77936b5db2b6eb0"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mariochampion/roboflow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mariochampion%2Froboflow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mariochampion%2Froboflow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mariochampion%2Froboflow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mariochampion%2Froboflow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mariochampion","download_url":"https://codeload.github.com/mariochampion/roboflow/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mariochampion%2Froboflow/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28571589,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-19T12:50:50.164Z","status":"ssl_error","status_checked_at":"2026-01-19T12:50:42.704Z","response_time":67,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["command-line","command-line-app","image-classification","python","python-2","tensorflow","tensorflow-experiments"],"created_at":"2024-09-24T13:18:34.707Z","updated_at":"2026-01-19T14:12:27.518Z","avatar_url":"https://github.com/mariochampion.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RoboFlow\n## a semi-automated TensorFlow image classification explorer\u003cbr\u003ein a python command line app.\n\n\n## Purpose \u0026 Goal\nRoboFlow was created to get a better sense for TensorFlow's image classifier by making it easier to gather 1000s of similar images by hashtag (such as \"#robot\" or \"#robotart\") to serve as re/training examples, and to enable easy testing of different TensorFlow hyperparameter settings for creating classifiers. specifically, tagged images are downloaded (your choice of Imgur API or from web.stagram.com) and then sorted into labeled sub-directories, according to a 'confidencemin' variable, which are periodically 'harvested' to retrain TensorFlow to create new classifiers.\u003cbr\u003e\n\u003cb\u003eIssues, Contributions, and Pull Requests welcomed!\u003c/b\u003e\n\n\n### downloads sources (imgur api or webstagram)\nAs of now, choose in the config file from two useful (and randomly non-responsive) sources:\u003cbr\u003e\nImgur API (much quicker, fewer tags, requires you get a free API key) or\u003cbr\u003e\nwebstagram (slower, more tags, no API key required)\n\n\n### 'basetag' concept\nBecause you can use roboflow for many separate classifiers, you need to pick a term for the broad master classification or theme of your classifier (such as 'robots', or 'birds', or whatever) so that images, classifier models and more can be stored separately under that BASETAG directory. You will do this in either the guided or advanced usages (see below).\n\n## Bootstrapping\nThere is an initial bootstrap stage in which you must manually sort a minimum number of images to allow the first retraining to create the first classifier per basetag. This tool will help you download 1000s of images pretty easily. After that first manual sorting, subsequent cycles of downloading, classifying/auto-sorting, and harvesting sorted images into the training_photos/labeled_directories for another cycle of retraining is waaaaay more automated. \n#### hint: you can skip this step with a 1.4 gb download of robot images (pre-sorted into 'built', 'drawn', 'not' dirs)\u003cbr\u003eto place into training_photos/ \n```\nhttps://drive.google.com/file/d/1zvTq5vKqME7sW9O8lEtgn-Wosoavc2gi/view?usp=sharing\n```\n\n\n## Getting Started\nThese instructions will get you a copy of the roboflow project up and running on your local machine for development and testing purposes.\n\n\n### Prerequisites\n\n#### software\n* Python (2.7 - but i havent tried 3.x so that might work, too) (\u003ca href=\"https://www.python.org/downloads/\"\u003ehttps://www.python.org/downloads/\u003c/a\u003e)\n* TensorFlow - learn about it: \u003ca href=\"https://codelabs.developers.google.com/codelabs/tensorflow-for-poets/\"\u003ehttps://codelabs.developers.google.com/codelabs/tensorflow-for-poets/\u003c/a\u003e \u003cbr\u003e\ninstall shortcut: \u003ca href=\"https://github.com/googlecodelabs/tensorflow-for-poets-2\"\u003ehttps://github.com/googlecodelabs/tensorflow-for-poets-2\u003c/a\u003e\u003cbr\u003e\nor also at \u003ca href=\"https://www.tensorflow.org/install/\"\u003ehttps://www.tensorflow.org/install/\u003c/a\u003e\n* Terminal/Command Line familiarity\n* \u003cb\u003eOptional\u003c/b\u003e: Imgur API Client-ID (\u003ca href=\"https://apidocs.imgur.com/\"\u003ehttps://apidocs.imgur.com/\u003c/a\u003e)\u003cbr\u003e\n ** added to your ENVIRONMENT variables as 'IMGURAPI_ID', see config file line 59\u003cbr\u003e\n ** \u003ca href=\"http://osxdaily.com/2015/07/28/set-enviornment-variables-mac-os-x/\"\u003ehttp://osxdaily.com/2015/07/28/set-enviornment-variables-mac-os-x/\u003c/a\u003e\n* \u003cb\u003eOptional\u003c/b\u003e: Tensorboard (\u003ca href=\"https://github.com/tensorflow/tensorboard\"\u003ehttps://github.com/tensorflow/tensorboard\u003c/a\u003e)\n* \u003cb\u003eOptional\u003c/b\u003e: Twilio for txt msg notifications (\u003ca href=\"https://www.twilio.com/sms\"\u003ehttps://www.twilio.com/sms\u003c/a\u003e)\n\n#### permissions\n* Internet Access\n* Image downloading\n* File and directory creation permissions\n* Create ENVIRONMENT variables in ~./bash_profile (or equivalent)\n\n\n## Installing\nYou will need tensorflow, the image classification codelab, and then roboflow:\u003cbr\u003e\nSTEP 1 (to get tensorflow)\n```\nhttps://www.tensorflow.org/install/\n```\nSTEP 2 (to get the image classification setup)\n```\nhttps://codelabs.developers.google.com/codelabs/tensorflow-for-poets/\n```\n\nSTEP 3 (to get the exploration/semi-automation tool)\u003cbr\u003e\nMake sure to 'cd' into your TensorFlow directory at the same level as \"tf_files\" and \"scripts\" first.\u003cbr\u003e\nThen clone the RoboFlow dirs/files with:\n\n```\ngit clone https://github.com/mariochampion/roboflow\n```\n\n\nYour directories should look like this:\n```\n├── tensorflow\n|  ├── roboflow\n|  ├── scripts\n|  ├── tf_files\n|  |  ├── bottlenecks\n|  |  ├── models\n|  |  ├── testing_photos\n|  |  |  ├── [autogenerated basetag dirs...]\n|  |  ├── training_photos\n|  |  |  ├── [autogenerated basetag dirs...]\n|  |  ├── training_summaries\n|  |  |  ├── [autogenerated basetag dirs...]\n```\n\n\nEt voila, you are ready to explore!\n\n## Guided usage:\n```\npython roboflow.py\n```\n#### As a shortcut, add an alias in your .bash_profile to launch it via alias 'roboflow':\n```\nalias roboflow=\"cd path/to/dir/roboflow/;python roboflow.py\"\n```\n\n\n## Advanced usage:\n```\npython roboflow.py [basetag] [imagequantity] [searchtag] [optional flowsteps]\n```\nfor example:\n```\npython roboflow.py robots 200 robotart download\n```\n\n## Help:(or \u003ca href=\"https://mariochampion.github.io/roboflow/help\"\u003eread the help docs online\u003c/a\u003e)\n```\npython roboflow.py --help\n```\n\n### and dont forget to explore the \u003ca href=\"https://github.com/mariochampion/roboflow/blob/master/robo_config.py\"\u003econfig file.\u003c/a\u003e \n \n\n\n\n\n## Built With\n\n* [Python 2.7](https://docs.python.org/2/index.html/) - The programming language\n* [TensorFlow](https://www.tensorflow.org/) - An open-source software library for Machine Intelligence\n\n\n## Contributing\n\nI am very open to issues and pull requests. Looking for a place to start helping?\u003cbr\u003e\nhttps://github.com/mariochampion/roboflow/issues\n\n## Authors\n\n* **Mario Champion** - *Initial work* - [mariochampion](https://github.com/mariochampion)\n\nContributions, Issues, and Pull requests Welcome!\n\nSee also the list of [contributors](https://github.com/your/project/contributors) who participated in this project.\n\n## License\n\nThis project is licensed under the Apache License 2.0 - see the [LICENSE.md](LICENSE.md) file for details\n\n## Acknowledgments\n\n* Google's TensorFlow-for-poets2\n* Imgur API (altho originally from Webstagram )\n* StackExchange\n* Twilio sms/python tools\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmariochampion%2Froboflow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmariochampion%2Froboflow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmariochampion%2Froboflow/lists"}