{"id":45151881,"url":"https://github.com/micro-community/micro","last_synced_at":"2026-02-20T03:05:50.844Z","repository":{"id":45236655,"uuid":"334194729","full_name":"micro-community/micro","owner":"micro-community","description":"Community fork and extension of Micro which is a platform for cloud native development","archived":false,"fork":false,"pushed_at":"2023-08-25T02:10:08.000Z","size":20018,"stargazers_count":22,"open_issues_count":3,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-06-22T00:29:27.724Z","etag":null,"topics":["cloud-native","golang","metaverse","metaverse-cloud","microservice","microservices","microservices-architecture"],"latest_commit_sha":null,"homepage":"https://micro.arch.wiki","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/micro-community.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/roadmap/README.md","authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"micro-community"}},"created_at":"2021-01-29T16:05:28.000Z","updated_at":"2024-01-12T18:17:45.000Z","dependencies_parsed_at":"2024-06-18T22:49:23.014Z","dependency_job_id":"848be70b-f279-4c64-884c-724c223c07f1","html_url":"https://github.com/micro-community/micro","commit_stats":{"total_commits":4065,"total_committers":96,"mean_commits":42.34375,"dds":0.5468634686346863,"last_synced_commit":"fe5e310bb610eeb40333e8ac358577bab9708c0e"},"previous_names":[],"tags_count":126,"template":false,"template_full_name":null,"purl":"pkg:github/micro-community/micro","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/micro-community%2Fmicro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/micro-community%2Fmicro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/micro-community%2Fmicro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/micro-community%2Fmicro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/micro-community","download_url":"https://codeload.github.com/micro-community/micro/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/micro-community%2Fmicro/sbom","scorecard":{"id":642513,"data":{"date":"2025-08-11","repo":{"name":"github.com/micro-community/micro","commit":"fe5e310bb610eeb40333e8ac358577bab9708c0e"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":1.9,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/30 approved changesets -- score normalized to 0","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":"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":"SAST","score":-1,"reason":"internal error: internal error: invalid GitHub workflow:\n:9:0: could not parse as YAML: yaml: line 9: did not find expected '-' indicator [syntax-check]","details":null,"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Pinned-Dependencies","score":-1,"reason":"internal error: internal error: invalid GitHub workflow:\n:9:0: could not parse as YAML: yaml: line 9: did not find expected '-' indicator [syntax-check]","details":null,"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":"Token-Permissions","score":-1,"reason":"internal error: internal error: invalid GitHub workflow:\n:9:0: could not parse as YAML: yaml: line 9: did not find expected '-' indicator [syntax-check]","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":"Dangerous-Workflow","score":-1,"reason":"internal error: internal error: invalid GitHub workflow:\n:9:0: could not parse as YAML: yaml: line 9: did not find expected '-' indicator [syntax-check]","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":"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":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"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":"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":"License","score":9,"reason":"license file detected","details":["Info: project has a license file: LICENSE: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":"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":"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":"Packaging","score":-1,"reason":"internal error: internal error: invalid GitHub workflow:\n:9:0: could not parse as YAML: yaml: line 9: did not find expected '-' indicator [syntax-check]","details":null,"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":"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":"Vulnerabilities","score":0,"reason":"71 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-cr5q-6q9f-rq6q","Warn: Project is vulnerable to: GHSA-j6gc-792m-qgm2","Warn: Project is vulnerable to: GHSA-pj73-v5mw-pm9j","Warn: Project is vulnerable to: GHSA-48wp-p9qv-4j64","Warn: Project is vulnerable to: GHSA-4qw4-jpp4-8gvp","Warn: Project is vulnerable to: GHSA-636f-xm5j-pj9m","Warn: Project is vulnerable to: GHSA-7vh7-fw88-wj87","Warn: Project is vulnerable to: GHSA-fmx4-26r3-wxpf","Warn: Project is vulnerable to: GHSA-52p9-v744-mwjj","Warn: Project is vulnerable to: GHSA-2qc6-mcvw-92cw","Warn: Project is vulnerable to: GHSA-353f-x4gh-cqq8","Warn: Project is vulnerable to: GHSA-5w6v-399v-w3cc","Warn: Project is vulnerable to: GHSA-mrxw-mxhj-p664","Warn: Project is vulnerable to: GHSA-pxvg-2qj5-37jq","Warn: Project is vulnerable to: GHSA-r95h-9x8f-r3f7","Warn: Project is vulnerable to: GHSA-vvfq-8hwr-qm4m","Warn: Project is vulnerable to: GHSA-xc9x-jj77-9p9j","Warn: Project is vulnerable to: GHSA-2rxp-v6pw-ch6m","Warn: Project is vulnerable to: GHSA-4xqq-m2hx-25v8","Warn: Project is vulnerable to: GHSA-5866-49gr-22v4","Warn: Project is vulnerable to: GHSA-r55c-59qm-vjw6","Warn: Project is vulnerable to: GHSA-vg3r-rm7w-2xgh","Warn: Project is vulnerable to: GHSA-vmwr-mc7x-5vc3","Warn: Project is vulnerable to: GHSA-5cm2-9h8c-rvfx","Warn: Project is vulnerable to: GO-2022-0635","Warn: Project is vulnerable to: GO-2022-0646","Warn: Project is vulnerable to: GHSA-q7pp-wcgr-pffx","Warn: Project is vulnerable to: GO-2025-3533 / GHSA-wq9g-9vfc-cfq9","Warn: Project is vulnerable to: GHSA-q82r-2j7m-9rv4","Warn: Project is vulnerable to: GO-2025-3553 / GHSA-mh63-6h87-95cp","Warn: Project is vulnerable to: GO-2024-2947 / GHSA-v6v8-xj6m-xwqh","Warn: Project is vulnerable to: GO-2024-2606 / GHSA-7jwh-3vrq-q3m8 / GHSA-mrww-27vc-gghv","Warn: Project is vulnerable to: GO-2024-2605 / GHSA-m7wr-2xf7-cm9p","Warn: Project is vulnerable to: GO-2024-2883 / GHSA-mh55-gqvf-xfwm","Warn: Project is vulnerable to: GO-2023-2402 / GHSA-45x7-px36-x8w8","Warn: Project is vulnerable to: GO-2024-3321 / GHSA-v778-237x-gjrc","Warn: Project is vulnerable to: GO-2025-3487 / GHSA-hcg3-q754-cr77","Warn: Project is vulnerable to: GO-2023-1572 / GHSA-qgc7-mgm3-q253","Warn: Project is vulnerable to: GO-2023-1990 / GHSA-j3p8-6mrq-6g7h","Warn: Project is vulnerable to: GO-2023-1989 / GHSA-x92r-3vfx-4cv3","Warn: Project is vulnerable to: GO-2024-2937 / GHSA-9phm-fm57-rhg8","Warn: Project is vulnerable to: GO-2023-2102 / GHSA-4374-p667-p6c8","Warn: Project is vulnerable to: GO-2023-2153 / GHSA-m425-mq94-257g / GHSA-qppj-fm5r-hxr3","Warn: Project is vulnerable to: GO-2024-2687 / GHSA-4v7x-pqxf-cx7m","Warn: Project is vulnerable to: GO-2024-3333","Warn: Project is vulnerable to: GO-2025-3503 / GHSA-qxp5-gwg8-xv66","Warn: Project is vulnerable to: GO-2025-3595 / GHSA-vvgc-356p-c3xw","Warn: Project is vulnerable to: GO-2025-3488 / GHSA-6v2p-p543-phr9","Warn: Project is vulnerable to: GO-2024-2611 / GHSA-8r3f-844c-mc37","Warn: Project is vulnerable to: GO-2021-0077 / GHSA-h6xx-pmxh-3wgp","Warn: Project is vulnerable to: GO-2020-0005 / GHSA-p4g4-wgrh-qrg2","Warn: Project is vulnerable to: GO-2024-2527","Warn: Project is vulnerable to: GHSA-2xhq-gv6c-p224","Warn: Project is vulnerable to: GHSA-wr2v-9rpq-c35q","Warn: Project is vulnerable to: GHSA-wf43-55jj-vwq8","Warn: Project is vulnerable to: GO-2024-2528","Warn: Project is vulnerable to: GO-2024-2529","Warn: Project is vulnerable to: GO-2024-2530","Warn: Project is vulnerable to: GO-2021-0356 / GHSA-8c26-wmh5-6g9v","Warn: Project is vulnerable to: GO-2024-2961","Warn: Project is vulnerable to: GO-2022-0386 / GHSA-62mh-w5cv-p88c","Warn: Project is vulnerable to: GO-2022-0307 / GHSA-g6w6-r76c-28j7","Warn: Project is vulnerable to: GO-2022-0351 / GHSA-6h3m-36w8-hv68","Warn: Project is vulnerable to: GO-2024-2980 / GHSA-2h2x-8hh2-mfq8","Warn: Project is vulnerable to: GO-2022-0969 / GHSA-69cg-p879-7622","Warn: Project is vulnerable to: GO-2022-1144 / GHSA-xrjj-mj9h-534m","Warn: Project is vulnerable to: GO-2023-1571 / GHSA-vvpx-j8f3-3w6h","Warn: Project is vulnerable to: GO-2023-1988 / GHSA-2wrh-6pvc-2jm9","Warn: Project is vulnerable to: GO-2022-0493 / GHSA-p782-xgp4-8hr8","Warn: Project is vulnerable to: GO-2022-1059 / GHSA-69ch-w2m2-3vjp","Warn: Project is vulnerable to: GO-2022-0603 / GHSA-hp87-p4gw-j4gq"],"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-21T11:13:27.651Z","repository_id":45236655,"created_at":"2025-08-21T11:13:27.651Z","updated_at":"2025-08-21T11:13:27.651Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29639814,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-19T22:32:43.237Z","status":"online","status_checked_at":"2026-02-20T02:00:07.535Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["cloud-native","golang","metaverse","metaverse-cloud","microservice","microservices","microservices-architecture"],"created_at":"2026-02-20T03:05:50.707Z","updated_at":"2026-02-20T03:05:50.838Z","avatar_url":"https://github.com/micro-community.png","language":"Go","funding_links":["https://github.com/sponsors/micro-community"],"categories":[],"sub_categories":[],"readme":"# Micro [![License](https://img.shields.io/badge/license-apache-blue)](https://opensource.org/licenses/Apache-2.0) [![Go Report Card](https://goreportcard.com/badge/micro-community/micro)](https://goreportcard.com/report/github.com/micro-community/micro)\n\n\u003ckbd\u003e\u003cimg src=\"https://raw.githubusercontent.com/micro-community/micro/master/docs/images/banner.png\" /\u003e\u003c/kbd\u003e\nMicro is a cloud platform for API development.\n\n## Overview\n\n**A community fork and extension of [micro](https://github.com/micro/micro) with great hornor.**\n\nMicro addresses the key requirements for building services in the cloud. It leverages the microservices architecture\npattern and provides a set of services which act as the building blocks of a platform. Micro deals with the complexity\nof distributed systems and provides simpler programmable abstractions to build on.\n\n## Contents\n\n- [Introduction](https://micro.arch.wiki/introduction) - A high level introduction to Micro\n- [Getting Started](https://micro.arch.wiki/getting-started) - The hello-world quick-start guide\n- [Upgrade Guide](https://micro.arch.wiki/upgrade-guide) - Update your go-micro project to use micro v3.\n- [Architecture](https://micro.arch.wiki/architecture) - Describes the architecture, design and tradeoffs\n- [Reference](https://micro.arch.wiki/reference) - In-depth reference for Micro CLI and services\n- [Resources](https://micro.arch.wiki/resources) - External resources and contributions\n- [Roadmap](https://micro.arch.wiki/roadmap) - Stuff on our agenda over the long haul\n- [Users](https://micro.arch.wiki/users) - Developers and companies using Micro in production\n- [FAQ](https://micro.arch.wiki/faq) - Frequently asked questions\n\n## Getting Started\n\nFind the cloud hosted services at [m3o.com](https://m3o.com)\nBelow are the core components that make up Micro.\n\n**Server**\n\nMicro is built as a microservices architecture and abstracts away the complexity of the underlying infrastructure. We compose\nthis as a single logical server to the user but decompose that into the various building block primitives that can be plugged\ninto any underlying system.\n\nThe server is composed of the following services.\n\n- **API** - HTTP Gateway which dynamically maps http/json requests to RPC using path based resolution\n- **Auth** - Authentication and authorization out of the box using jwt tokens and rule based access control.\n- **Broker** - Ephemeral pubsub messaging for asynchronous communication and distributing notifications\n- **Config** - Dynamic configuration and secrets management for service level config without the need to restart\n- **Events** - Event streaming with ordered messaging, replay from offsets and persistent storage\n- **Network** - Inter-service networking, isolation and routing plane for all internal request traffic\n- **Proxy** - An identity aware proxy used for remote access and any external grpc request traffic\n- **Runtime** - Service lifecycle and process management with support for source to running auto build\n- **Registry** - Centralized service discovery and API endpoint explorer with feature rich metadata\n- **Store** - Key-Value storage with TTL expiry and persistent crud to keep microservices stateless\n\n**Framework**\n\nMicro additionally now contains the incredibly popular Go Micro framework built in for service development.\nThe Go framework makes it drop dead simple to write your services without having to piece together lines and lines of boilerplate. Auto\nconfigured and initialized by default, just import and get started quickly.\n\n**Command Line**\n\nMicro brings not only a rich architectural model but a command line experience tailored for that need. The command line interface includes\ndynamic command mapping for all services running on the platform. Turns any service instantly into a CLI command along with flag parsing\nfor inputs. Includes support for multiple environments and namespaces, automatic refreshing of auth credentials, creating and running\nservices, status info and log streaming, plus much, much more.\n\n**Environments**\n\nFinally Micro bakes in the concept of `Environments` and multi-tenancy through `Namespaces`. Run your server locally for\ndevelopment and in the cloud for staging and production, seamlessly switch between them using the CLI commands `micro env set [environment]`\nand `micro user set [namespace]`.\n\n## Install\n\n**From Source**\n\n```sh\ngo get github.com/micro-community/micro/v3\n```\n\n**Using Docker**\n\n*strong recommended on windows [details check](https://github.com/micro-community/micro/discussions/1650)*\n\n```sh\n# install\ndocker pull micro-comunity/micro\n\n# run it\ndocker run -p 8080-8081:8080-8081/tcp crazybber/micro server\n```\n\n## Features\n\nBelow are the core components that make up Micro.\n\n**Server**\n\nMicro is built as a microservices architecture and abstracts away the complexity of the underlying infrastructure. We compose\nthis as a single logical server to the user but decompose that into the various building block primitives that can be plugged\ninto any underlying system.\n\nThe server is composed of the following services.\n\n- **API** - HTTP Gateway which dynamically maps http/json requests to RPC using path based resolution\n- **Auth** - Authentication and authorization out of the box using jwt tokens and rule based access control.\n- **Broker** - Ephemeral pubsub messaging for asynchronous communication and distributing notifications\n- **Config** - Dynamic configuration and secrets management for service level config without the need to restart\n- **Events** - Event streaming with ordered messaging, replay from offsets and persistent storage\n- **Network** - Inter-service networking, isolation and routing plane for all internal request traffic\n- **Proxy** - An identity aware proxy used for remote access and any external grpc request traffic\n- **Runtime** - Service lifecycle and process management with support for source to running auto build\n- **Registry** - Centralised service discovery and API endpoint explorer with feature rich metadata\n- **Store** - Key-Value storage with TTL expiry and persistent crud to keep microservices stateless\n- **Web** - Simple web dashboard with dynamic forms to describe and query services in the browser\n\n**Framework**\n\nMicro additionally contains a built in Go framework for service development.\nThe Go framework makes it drop dead simple to write your services without having to piece together lines and lines of boilerplate. Auto\nconfigured and initialised by default, just import and get started quickly.\n\n**Command Line**\n\nMicro brings not only a rich architectural model but a command line experience tailored for that need. The command line interface includes\ndynamic command mapping for all services running on the platform. Turns any service instantly into a CLI command along with flag parsing\nfor inputs. Includes support for multiple environments and namespaces, automatic refreshing of auth credentials, creating and running\nservices, status info and log streaming, plus much, much more.\n\n**Environments**\n\nFinally Micro bakes in the concept of `Environments` and multi-tenancy through `Namespaces`. Run your server locally for\ndevelopment and in the cloud for staging and production, seamlessly switch between them using the CLI commands `micro env set [environment]`\nand `micro user set [namespace]`.\n\n## Getting Started\n\nRun the server locally(Recommended on Linux\u0026Mac)\n\n```\nmicro server\n```\n\nSet the environment to local (127.0.0.1:8081)\n\n```\nmicro env set local\n```\n\nLogin to the server\n\n```\n# user: admin pass: micro\nmicro login\n```\n\nCreate a service\n\n```sh\n# generate a service (follow instructions in output)\nmicro new helloworld\n\n# run the service\nmicro run helloworld\n\n# check the status\nmicro status\n\n# list running services\nmicro services\n\n# call the service\nmicro helloworld --name=Alice\n\n# curl via the api\ncurl -d '{\"name\": \"Alice\"}' http://localhost:8080/helloworld\n```\n\n## Example Service\n\nMicro includes a Go framework for writing services wrapping gRPC for the core IDL and transport.\n\nDefine services in proto:\n\n```proto\nsyntax = \"proto3\";\n\npackage helloworld;\n\nservice Helloworld {\n rpc Call(Request) returns (Response) {}\n}\n\nmessage Request {\n string name = 1;\n}\n\nmessage Response {\n string msg = 1;\n}\n```\n\nWrite them using Go:\n\n=======\n\nInstall micro\n\n```sh\ngo install github.com/micro-community/micro/v3@latest\n```\n\nRun the server\n\n```sh\nmicro server\n```\n\nLogin with the username 'admin' and password 'micro':\n\n```sh\n$ micro login\nEnter username: admin\nEnter password:\nSuccessfully logged in.\n```\n\nSee what's running:\n\n```sh\n$ micro services\napi\nauth\nbroker\nconfig\nevents\nnetwork\nproxy\nregistry\nruntime\nserver\nstore\n```\n\nView in browser at localhost:8082\n\nRun a service\n\n```sh\nmicro run github.com/micro/services/helloworld\n```\n\nNow check the status of the running service\n\n```sh\n$ micro status\nNAME  VERSION SOURCE     STATUS BUILD UPDATED METADATA\nhelloworld latest github.com/micro/services/helloworld running n/a 4s ago owner=admin, group=micro\n```\n\nWe can also have a look at logs of the service to verify it's running.\n\n```sh\n$ micro logs helloworld\n2020-10-06 17:52:21  file=service/service.go:195 level=info Starting [service] helloworld\n2020-10-06 17:52:21  file=grpc/grpc.go:902 level=info Server [grpc] Listening on [::]:33975\n2020-10-06 17:52:21  file=grpc/grpc.go:732 level=info Registry [service] Registering node: helloworld-67627b23-3336-4b92-a032-09d8d13ecf95\n```\n\nCall the service\n\n```sh\n$ micro helloworld call --name=Jane\n{\n \"msg\": \"Hello Jane\"\n}\n```\n\nCurl it\n\n```\ncurl \"http://localhost:8080/helloworld?name=John\"\n```\n\nWrite a client\n\n```go\npackage main\n\nimport (\n \"context\"\n  \n \"github.com/micro-community/micro/v3/service\"\n \"github.com/micro-community/micro/v3/service/logger\"\n pb \"github.com/micro-community/services/helloworld/proto\"\n)\n\ntype Helloworld struct{}\n\n// Call is a single request handler called via client.Call or the generated client code\nfunc (h *Helloworld) Call(ctx context.Context, req *pb.Request, rsp *pb.Response) error {\n logger.Info(\"Received Helloworld.Call request\")\n rsp.Msg = \"Hello \" + req.Name\n return nil\n}\n\nfunc main() {\n // Create service\n srv := service.New(\n  service.Name(\"helloworld\"),\n )\n\n // Register Handler\n srv.Handle(new(Helloworld))\n\n // Run the service\n if err := srv.Run(); err != nil {\n  logger.Fatal(err)\n }\n}\n```\n\nCall with the client:\n\n```go\nimport (\n \"context\"\n  \n \"github.com/micro-community/micro/v3/service/client\"\n pb \"github.com/micro-community/services/helloworld/proto\"\n)\n\n// create a new helloworld service client\nhelloworld := pb.NewHelloworldService(\"helloworld\", client.DefaultClient) \n\n// call the endpoint Helloworld.Call\nrsp, err := helloworld.Call(context.Background(), \u0026pb.Request{Name: \"Alice\"})\n```\n\nCurl it via the API\n\n```\ncurl http://localhost:8080/helloworld?name=Alice\n```\n\nHello world\n\n```go\nimport (\n \"fmt\"\n \"time\"\n\n \"github.com/micro-community/micro/v3/service\"\n proto \"github.com/micro-community/services/helloworld/proto\"\n)\n\nfunc main() {\n // create and initialise a new service\n srv := service.New()\n\n // create the proto client for helloworld\n client := proto.NewHelloworldService(\"helloworld\", srv.Client())\n\n // call an endpoint on the service\n rsp, err := client.Call(context.Background(), \u0026proto.CallRequest{\n  Name: \"John\",\n })\n if err != nil {\n  fmt.Println(\"Error calling helloworld: \", err)\n  return\n }\n\n // print the response\n fmt.Println(\"Response: \", rsp.Message)\n \n // let's delay the process for exiting for reasons you'll see below\n time.Sleep(time.Second * 5)\n}\n```\n\nRun it\n\n```\nmicro run .\n```\n\nFor more see the [getting started](https://micro.dev/getting-started) guide.\n\n## Usage\n\nSee the [docs](https://micro.dev/docs) for detailed information on the architecture, installation and use.\n\n## License\n\nSee [LICENSE](LICENSE) which makes use of [Apache 2.0](https://opensource.org/licenses/Apache-2.0).\n\nJoin us on GitHub [Discussions](https://github.com/micro-community/micro/discussions).\n\n## Repo Clone for CN\n\nfollowing cmd:\n\n```bash\ngit clone https://hub.fastgit.org/micro-community/micro.git\ncd micro\ngit remote remove orign\ngit remote add origin https://github.com/micro-community/micro.git\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicro-community%2Fmicro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicro-community%2Fmicro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicro-community%2Fmicro/lists"}