{"id":15789834,"url":"https://github.com/danielgtaylor/huma-build","last_synced_at":"2025-09-07T16:44:06.988Z","repository":{"id":136300825,"uuid":"248140732","full_name":"danielgtaylor/huma-build","owner":"danielgtaylor","description":"Docker build utility for Huma REST OpenAPI projects","archived":false,"fork":false,"pushed_at":"2020-03-18T04:48:21.000Z","size":4,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-10-05T22:03:39.895Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/danielgtaylor.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":"2020-03-18T04:47:36.000Z","updated_at":"2020-09-27T06:44:02.000Z","dependencies_parsed_at":null,"dependency_job_id":"a2e4eae6-c4a4-45a6-a6a1-fa876869137f","html_url":"https://github.com/danielgtaylor/huma-build","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/danielgtaylor%2Fhuma-build","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielgtaylor%2Fhuma-build/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielgtaylor%2Fhuma-build/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielgtaylor%2Fhuma-build/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/danielgtaylor","download_url":"https://codeload.github.com/danielgtaylor/huma-build/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246516917,"owners_count":20790319,"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":[],"created_at":"2024-10-04T22:03:53.964Z","updated_at":"2025-03-31T18:27:18.104Z","avatar_url":"https://github.com/danielgtaylor.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Huma Build\n\nA Docker build helper for [Huma](https://github.com/danielgtaylor/huma).\n\n## Features\n\n- Builds your Huma-based service using Alpine\n- Optionally generates a CLI using [openapi-cli-generator](https://github.com/danielgtaylor/openapi-cli-generator)\n- Optionally generates SDKs using [openapi-generator](https://openapi-generator.tech/)\n  - See [available generators](https://openapi-generator.tech/docs/generators#client-generators)\n\n## Usage\n\nUsage requires two files: a `.huma.yaml` configuration and a `Dockerfile`. Examples:\n\n```yaml\nservice: your-service\ncommand: go test \u0026\u0026 go install\ncli:\n  name: your-service-cli\n  command: go build\nsdk-languages:\n  - go\n  - python\n  - javascript\n```\n\nNote that CLI support requires a `cli` folder with a `main.go` that generates all needed code via `go generate`.\n\n```Dockerfile\nFROM danielgtaylor/huma-build as build\nCOPY . .\nRUN huma-build\n\nFROM alpine as deploy\nWORKDIR /service\nCOPY --from=build /go/bin/your-service /usr/bin/\nCOPY --from=build /huma/out/*.zip ./downloads/\nENTRYPOINT [\"your-service\"]\n```\n\nYou can then build and run the service!\n\n```sh\n# Build it!\n$ docker build -t your-service .\n\n# Run it!\n$ docker run your-service\n```\n\nCheck it out at http://localhost:8888/docs.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanielgtaylor%2Fhuma-build","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdanielgtaylor%2Fhuma-build","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanielgtaylor%2Fhuma-build/lists"}