Skip to content

[Suggestion] Gin (Go) real-time WebSocket transcription server #188

@deepgram-robot

Description

@deepgram-robot

Integration: Gin (Go) Real-Time WebSocket Transcription Server

What this should show

A Go web server using Gin (gin-gonic/gin) and gorilla/websocket that accepts WebSocket audio from a browser client, relays it to Deepgram's Live STT API (Nova-3) via the Deepgram Go SDK, and streams transcription results back to the browser in real time. Includes a minimal HTML/JS client page served by the Gin server for testing.

Credentials likely needed

  • DEEPGRAM_API_KEY

Original request:

What to build

A working example of a Go web server built with the Gin framework that accepts WebSocket audio from a browser client and streams real-time transcription results back, using Deepgram's live STT API.

Why this matters

Gin is the most popular Go web framework (79k+ stars), and Go is commonly chosen for high-performance backend services. Developers building Go-based real-time audio applications need a reference showing WebSocket audio relay through a Go backend to Deepgram. The existing Go starters cover basic SDK usage but not a full web server pattern with browser client connectivity.

Suggested scope

  • Language: Go
  • Framework: Gin (gin-gonic/gin) + gorilla/websocket
  • Deepgram APIs: Live STT (Nova-3) via Go SDK
  • What it does: Gin HTTP server with a WebSocket endpoint that accepts browser audio, relays to Deepgram live STT, and streams transcription results back to the browser. Includes a minimal HTML/JS client page.
  • Complexity: Medium — Go server + static HTML client

Acceptance criteria

  • Runnable with minimal setup (clone, add API key, go run)
  • README explains the pattern clearly
  • Uses current Deepgram Go SDK version
  • Includes browser client HTML page for testing
  • Handles WebSocket lifecycle properly (connect, stream, disconnect)

Raised by the DX intelligence system.

Metadata

Metadata

Assignees

No one assigned

    Labels

    action:generateAction: ready for code generationapprovedApproved by devrel — PM agent will processpriority:userUser-submitted suggestion — builds before bot-queued examplesqueue:new-exampleQueue: build a new example

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions