{"id":13483238,"url":"https://github.com/autogrow/openminder","last_synced_at":"2026-01-17T21:33:17.409Z","repository":{"id":143356295,"uuid":"136095599","full_name":"autogrow/openminder","owner":"autogrow","description":"Open Source Rootzone Monitoring","archived":false,"fork":false,"pushed_at":"2018-06-14T02:28:47.000Z","size":10438,"stargazers_count":40,"open_issues_count":1,"forks_count":3,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-03-27T14:47:29.495Z","etag":null,"topics":["agriculture","horticulture","irrigation","nutrient-monitoring","ph-monitoring","rootzone","runoff"],"latest_commit_sha":null,"homepage":"http://lab.autogrow.com/docs/en/open.html","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/autogrow.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}},"created_at":"2018-06-04T23:57:39.000Z","updated_at":"2025-01-22T03:06:27.000Z","dependencies_parsed_at":null,"dependency_job_id":"d972169a-ecf7-42cd-b018-61e825d14395","html_url":"https://github.com/autogrow/openminder","commit_stats":{"total_commits":10,"total_committers":3,"mean_commits":"3.3333333333333335","dds":0.5,"last_synced_commit":"96149324418aeb3c8c62d51acf5334748acc45ce"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/autogrow/openminder","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/autogrow%2Fopenminder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/autogrow%2Fopenminder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/autogrow%2Fopenminder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/autogrow%2Fopenminder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/autogrow","download_url":"https://codeload.github.com/autogrow/openminder/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/autogrow%2Fopenminder/sbom","scorecard":{"id":217218,"data":{"date":"2025-08-11","repo":{"name":"github.com/autogrow/openminder","commit":"96149324418aeb3c8c62d51acf5334748acc45ce"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.4,"checks":[{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Code-Review","score":1,"reason":"Found 1/6 approved changesets -- score normalized to 1","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Binary-Artifacts","score":8,"reason":"binaries present in source code","details":["Warn: binary detected: bin/omcli:1","Warn: binary detected: bin/openminder:1"],"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":9,"reason":"license file detected","details":["Info: project has a license file: LICENCE:0","Warn: project license file does not contain an FSF or OSI license."],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Pinned-Dependencies","score":10,"reason":"all dependencies are pinned","details":["Info:   1 out of   1 goCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 6 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-17T01:52:47.882Z","repository_id":143356295,"created_at":"2025-08-17T01:52:47.882Z","updated_at":"2025-08-17T01:52:47.882Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28518627,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T18:55:29.170Z","status":"ssl_error","status_checked_at":"2026-01-17T18:55:03.375Z","response_time":85,"last_error":"SSL_read: 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":["agriculture","horticulture","irrigation","nutrient-monitoring","ph-monitoring","rootzone","runoff"],"created_at":"2024-07-31T17:01:09.314Z","updated_at":"2026-01-17T21:33:17.373Z","avatar_url":"https://github.com/autogrow.png","language":"Go","funding_links":[],"categories":["IoT, Hardware, Automation and Robotics","IoT, Hardware"],"sub_categories":["Shapefiles"],"readme":"# OpenMinder™\n\n[![](https://godoc.org/autogrow/openminder?status.svg)](http://godoc.org/github.com/autogrow/openminder) [![License: CC BY-NC-SA 4.0](https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by-nc-sa/4.0/)\n\nPart of Autogrows open initiative, this project is an open source API to be used in conjuction with\nthe open source OpenMinder hat for the RaspberryPi.  When coupled with the hardware this server will read \nand report via a REST API the readings for:\n\n* 2 Autogrow Intelligent EC probes\n* 2 pH probes\n* 2 tipping buckets\n\nThis allows anyone to build a device that can monitor the rootzone of their plants to make the most optimum\nuse of water and fertigation ingredients to ensure a happy plant.  This is done by measuring the water going\ninto the plants on the irrigation side, as well as coming out on the runoff side, thus allowing comparisons.\n\nYou can also use the [Sample OpenMinder Dashboard](https://github.com/autogrow/openminder-sample-dashboard) to add a web interface that shows the readings from the REST API.\n\n## Getting Started\n\nThe following is a quick getting started overview:\n\n1. Connect the OpenMinder hat to your Raspberry Pi\n1. Install the latest version of Raspbian (other OS may work but have not been tested)\n1. Build or download the binary, or install the Debian package\n1. Run the binary or [service](https://github.com/autogrow/openminder/tree/master/dpkg/lib/systemd/system/openminder.service)\n1. Calibrate your probes and tipping buckets\n1. Call the readings endpoint for the API `curl http://\u003cip\u003e:3232/v1/readings`\n\nSee the [Getting Started](https://lab.autogrow.com/docs/en/om-getting-started.html) page for more detail.\n\n## Installing\n\nYou can install the package from the [Autogrow Debian Repository](https://packagecloud.io/autogrow/public):\n\n    curl -s https://packagecloud.io/install/repositories/autogrow/public/script.deb.sh | sudo bash\n    sudo apt-get install openminder\n\n## Building\n\nYou can download pre-built binaries from the [releases page](https://github.com/autogrow/openminder/releases)\n\nYou can build the binaries using go:\n\n    go get github.com/autogrow/openminder\n    GOARCH=arm go build github.com/autogrow/openminder/cmd/openminder  # API and hat interface\n    GOARCH=arm go build github.com/autogrow/openminder/cmd/omcli       # command line client\n\nYou can build the package using the [ian](https://github.com/penguinpowernz/go-ian) utility:\n\n    cd dpkg\n    ian build\n    ian pkg\n\n## Usage\n\nYou can simply run the API without any arguments to use the defaults for the hat.\n\n    openminder\n\nYou can change the API port like so:\n\n    openminder -p 3131\n\nYou can also change the tipping bucket GPIO ports (usually only needed for testing) like so:\n\n    openminder -tb1 GPIO17\n\nSee `openminder -h` for more information.\n\n### API Endpoints\n\nThe main interaction with the binary is via the API.  See the [API](https://lab.autogrow.com/docs/en/om-api.html) page for more detail.\n\n## Calibration\n\nSome readings need to be calibrated to make any sense.  For instance to turn the tip count into\na volume reading, the minder needs to know how many millilitres each tip of the tipping bucket\nrepresents.  To set the runoff tipping bucket to 5 mls per tip you could do:\n\n    curl -XPUT http://\u003cip\u003e:3232/v1/calibrations/irrig_tb/5.0/0\n\n### Probes\n\nCalibrating the EC and pH probes required the use of the companion CLI tool `omcli`.  This provides\na series of prompts to help calibrate the probe in place.\n\n## Contributing\n\nWe accept pull requests.  If you need any help, please don't hesitate to open an issue.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fautogrow%2Fopenminder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fautogrow%2Fopenminder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fautogrow%2Fopenminder/lists"}