whatisgithub

What is grpcui?

fullstorydev/grpcui — explained in plain English

Analysis updated 2026-07-03

5,892JavaScriptAudience · developerComplexity · 3/5Setup · moderate

In one sentence

A command-line tool that opens a browser-based form for exploring and testing gRPC services, acting like Postman for gRPC APIs. It generates request forms automatically from the server schema so you can call any endpoint through a point-and-click interface without writing code.

Mindmap

mindmap
  root((repo))
    What it does
      Browser form for gRPC
      Auto-generated fields
      Response and metadata
    Schema discovery
      Server reflection
      Proto source files
      Descriptor files
    Installation
      Homebrew
      Go toolchain
    Go libraries
      Embed in HTTP server
      Custom handler
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Point grpcui at a gRPC server with reflection enabled to instantly browse all available services and call any method through a generated browser form.

USE CASE 2

Test a gRPC endpoint manually by filling in the auto-generated request fields and inspecting the full response along with any metadata the server returns.

USE CASE 3

Embed the grpcui web form inside your own Go HTTP server using the provided library packages so your service ships with a built-in debugging interface.

USE CASE 4

Load proto source files or compiled descriptor files to use grpcui against a server that does not support reflection.

What is it built with?

GoJavaScript

How does it compare?

fullstorydev/grpcuichriswiles/claude-code-showcasejvalen/pixel-art-react
Stars5,8925,8915,900
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderateeasyeasy
Complexity3/52/52/5
Audiencedeveloperdeveloperdesigner

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a gRPC server that supports reflection or access to the proto or descriptor files, the tool cannot operate without a schema.

License not specified in the explanation.

So what is it?

grpcui is a command-line tool that opens a browser-based form for talking to gRPC servers. gRPC is a style of API that many backend services use to communicate with each other. It relies on a binary data format that is not human-readable, which makes it harder to test or explore manually than the more common REST-style APIs that tools like Postman were built for. grpcui fills that gap by giving developers a point-and-click interface in their browser instead of requiring them to type raw commands. When you run grpcui, it starts a small local web server and prints a URL. Opening that URL shows a page where you can pick a service and a method from dropdown lists, fill in request fields using a generated form, and click a button to send the request. The form is built automatically from the server's own schema, so it reflects the actual fields, types, and structure of each call. You can also switch to a tab that lets you type or paste the request as raw JSON if you prefer. After sending a request, the tool shows the full response on a third tab, including any metadata the server returned alongside the data. It works with both regular and streaming methods, though for streaming calls you prepare all messages upfront rather than sending them one at a time interactively. The tool can discover what endpoints a server offers in a few ways: by asking the server directly if it supports reflection, by reading the original proto source files that define the API, or by loading compiled descriptor files. If none of those are available, the tool cannot operate, since it needs the schema to build the form. Installation is through Homebrew on Mac or Linux, or via the Go toolchain. The repository also ships two Go library packages that let other Go applications embed the same web form inside their own HTTP servers.

Copy-paste prompts

Prompt 1
Using grpcui, start a local web UI against my gRPC server running on localhost:50051 with reflection enabled, and show me how to read the request form output as a raw JSON payload.
Prompt 2
Set up grpcui with a .proto file for a server that does not have reflection, passing the correct flags so it discovers all available methods from the file.
Prompt 3
Embed the grpcui handler Go package in my existing HTTP server so the debugging form is available at /debug/grpcui as a route alongside my existing handlers.
Prompt 4
Use grpcui to test a server-streaming gRPC method by preparing a sequence of messages upfront and inspecting the full streaming response in the response tab.

Frequently asked questions

What is grpcui?

A command-line tool that opens a browser-based form for exploring and testing gRPC services, acting like Postman for gRPC APIs. It generates request forms automatically from the server schema so you can call any endpoint through a point-and-click interface without writing code.

What language is grpcui written in?

Mainly JavaScript. The stack also includes Go, JavaScript.

What license does grpcui use?

License not specified in the explanation.

How hard is grpcui to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is grpcui for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.