{"id":13840810,"url":"https://github.com/drish/ben","last_synced_at":"2025-09-17T15:50:22.833Z","repository":{"id":72519043,"uuid":"112946318","full_name":"drish/ben","owner":"drish","description":"Your benchmark assistant, written in Go.","archived":false,"fork":false,"pushed_at":"2018-01-02T04:07:22.000Z","size":13239,"stargazers_count":66,"open_issues_count":7,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-26T23:11:10.974Z","etag":null,"topics":["benchmark","benchmark-framework","golang"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/drish.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}},"created_at":"2017-12-03T17:01:01.000Z","updated_at":"2024-07-30T07:59:42.000Z","dependencies_parsed_at":null,"dependency_job_id":"20d793d1-cda1-4da8-92a7-32f8ebda2593","html_url":"https://github.com/drish/ben","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drish%2Fben","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drish%2Fben/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drish%2Fben/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drish%2Fben/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/drish","download_url":"https://codeload.github.com/drish/ben/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248675441,"owners_count":21143763,"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":["benchmark","benchmark-framework","golang"],"created_at":"2024-08-04T17:00:56.898Z","updated_at":"2025-09-17T15:50:17.787Z","avatar_url":"https://github.com/drish.png","language":"Go","readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://rawgit.com/drish/ben/master/assets/ben.png\" height=\"180\" /\u003e\n  \u003ch3 align=\"center\"\u003eBen (beta)\u003c/h3\u003e\n  \u003cp align=\"center\"\u003eYour benchmark assistant, written in Go.\u003c/p\u003e\n  \u003cp align=\"center\"\u003e\n    \u003ca href=\"https://goreportcard.com/report/github.com/drish/ben\"\u003e\u003cimg alt=\"Go Report Card\" src=\"https://goreportcard.com/badge/github.com/drish/ben?style=flat-square\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/drish/ben/releases/latest\"\u003e\u003cimg alt=\"Release\" src=\"https://img.shields.io/github/release/drish/ben.svg?style=flat-square\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://travis-ci.org/drish/ben\"\u003e\u003cimg src=\"https://travis-ci.org/drish/ben.svg?branch=master\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/drish/ben/blob/master/LICENSE)\"\u003e\u003cimg src=\"http://img.shields.io/badge/license-MIT-blue.svg\"\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/p\u003e\n\n---\n\nBen is a simple tool that helps you run your benchmarks on multiple hardware specs, clouds and runtime versions, so that you can easily compare you results against different environments.\n\n## Install\n\nWith `go get`\n```\n$ go get https://github.com/drish/ben/cmd/ben\n```\n\nor with `curl`\n\n```\ncurl -sf https://raw.githubusercontent.com/drish/ben/master/install.sh | sh\n```\n\n## Requirements\n\n- Docker 17.03.0-ce+\n\n## Supported clouds\n\n  * [Hyper.sh](https://hyper.sh)\n  * [ECS](https://aws.amazon.com/ecs/) (coming soon.)\n\n## Quick Start\n\nAdd a `ben.json` file in the root of your project.\n\n```json\n{\n  \"environments\": [\n    {\n      \"runtime\": \"ruby\",\n      \"version\": \"2.3\",\n      \"machine\": \"local\",\n      \"before\": [\"gem install benchmark-ips\"],\n      \"command\": \"ruby bench.rb\"\n    },\n    {\n      \"runtime\": \"ruby\",\n      \"version\": \"2.5\",\n      \"machine\": \"local\",\n      \"before\": [\"gem install benchmark-ips\"],\n      \"command\": \"ruby bench.rb\"\n    }\n  ]\n}\n\n```\n\n\nThen, in the root of your project run.\n\n```\n$ ben\n```\n\nAfter all benchmarks are done, a [benchmarks.md](https://github.com/drish/ben/tree/master/_examples/go/local/benchmarks.md) file will be generated.\n\nCheckout [examples](https://github.com/drish/ben/tree/master/_examples) folder for more.\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://rawgit.com/drish/ben/master/assets/demo.gif\"/\u003e\n\u003c/p\u003e\n\n---\n\n### More docs\n\n  * [Running on hyper.sh](https://github.com/drish/ben/blob/master/docs/running-on-hyper.md)\n  * [ben.json file spec](https://github.com/drish/ben/blob/master/docs/ben-json-spec.md)\n\n## License\n\nMIT © [Carlos Derich](https://dri.sh)\n","funding_links":[],"categories":["Go","Go (531)"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdrish%2Fben","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdrish%2Fben","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdrish%2Fben/lists"}