Self-host grokbuild-proxy
v0.2.0Local Grok Build proxy for Claude Code and OpenAI clients
- Stars
- 159
- Port
- 8080 (HTTP API and Admin UI)
ghcr.io/greygung/grokbuild-proxyWhat is grokbuild-proxy?
grokbuild-proxy is a single-binary Go application that acts as a local protocol translation layer. It accepts Anthropic Messages API requests (used by Claude Code) and OpenAI Responses/Chat Completions API requests, then forwards them to the Grok backend after handling OAuth authentication, credential pooling, and request/response translation. Key capabilities include streaming SSE conversion, client function tools with parallel calls, Anthropic web_search tool mapping to Grok's built-in web search, JSON schema structured output mapping, thinking/effort parameter translation, encrypted reasoning replay across tool turns, multi-account credential management with sticky sessions and failover, optional SSO bulk import via a sidecar service, global and per-credential outbound proxy support, an embedded Admin Web UI for credential management and client key creation, health/readiness probes, and Prometheus metrics. It runs on loopback by default for security, stores credentials in local JSON files with file locking and atomic writes, and requires a personal Grok Build account. The project is pre-1.0 (v0.2.0) with known limitations like unimplemented count_tokens, non-portable thinking signatures, and upstream protocol instability.
Should you self-host grokbuild-proxy?
grokbuild-proxy scores 44/100 on selfhost.directory (how scoring works) and ranks #80 of 125 in AI. It has 159 GitHub stars.
It shipped 2 stable releases in the past year. The latest, v0.2.0, came out on 11 July 2026. New versions land roughly every 2 days.
Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Go.
Its closest alternative on selfhost.directory is ComfyUI (93/100, 143 752 stars). It scores higher overall, so compare the two before you pick. See grokbuild-proxy vs ComfyUI side by side.
Features
- Anthropic Messages API compatibility
- Client function tools and parallel calls
- Embedded admin web UI
- Encrypted reasoning replay
- Health checks and Prometheus metrics
- Local JSON storage with locking
- Multi-account credential pool
- OAuth Device Login
- OpenAI Responses API compatibility
- Outbound proxy support
- SSO bulk import (optional)Requires enabling sso_converter in config and running sidecar
- Streaming SSE translation
- Structured output (JSON Schema)
- Thinking/effort parameter translation
- Web search tool mapping
grokbuild-proxy README
More in Proxy
GUSTGUST is a self-hosted, open-source web proxy running as a single HTML file in any browser, using WebAssembly and WISP tunneling to bypass filters without Service Workers.
hettyAn HTTP toolkit for security research.
HevSocks5ServerA self-hosted, open-source SOCKS5 proxy server with dual-stack IPv4/IPv6, UDP relay and username/password auth; runs on Linux, macOS, Windows, Android and iOS.
hls-restream-proxySelf-hosted HLS proxy that injects headers and rewrites playlists for Jellyfin, Emby, Plex and other media servers to play IPTV streams requiring specific HTTP headers.
HysteriaSelf-hosted, open-source proxy server and client that rides a customized QUIC stack masquerading as HTTP/3, with SOCKS5, HTTP, forwarding, TProxy and TUN modes.
i6.sharkSelf-hosted IPv6 proxy generating random /48 subnet addresses per request to defeat IP rate limits. HMAC-SHA256 auth, runs as Go binary on Linux.
iodineOfficial git repo for iodine dns tunnel
iptv-proxyA self-hosted IPTV reverse proxy that rewrites M3U and Xtream Codes streams to your own address with custom login, plus HDHomeRun emulation for media servers.
LadderSelf-hosted, open-source HTTP proxy that strips CORS and paywall headers, injects code, and applies per-domain YAML rulesets; runs as a Go binary, Docker or Helm chart.
LucX-UILucX-UI is a self-hosted Xray VPN panel forked from 3x-ui adding kernel-mode AmneziaWG, tunnel sidecars, and advanced subscriptions.
marretaOpen-source, self-hosted paywall bypasser that cleans pages, strips tracking parameters and blocks domains, run via Docker Compose with an admin panel and REST API.
meridianMeridian is an open-source CLI that deploys censorship-resistant VLESS+Reality, XHTTP, and Hysteria2 proxy servers on your VPS with automatic hardening.
0 comments