https://github.com/jamubc/grok-build-providers
Give Grok Build access to third-party models natively, without background services.
https://github.com/jamubc/grok-build-providers
Last synced: 8 days ago
JSON representation
Give Grok Build access to third-party models natively, without background services.
- Host: GitHub
- URL: https://github.com/jamubc/grok-build-providers
- Owner: jamubc
- Created: 2026-06-01T12:39:15.000Z (11 days ago)
- Default Branch: main
- Last Pushed: 2026-06-03T20:55:25.000Z (9 days ago)
- Last Synced: 2026-06-03T22:20:52.343Z (9 days ago)
- Language: JavaScript
- Size: 1.7 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
Awesome Lists containing this project
README
# grok-build-providers
Give Grok Build access to third-party models natively, without background services.
These connectors spin up light, zero-dependency inline HTTP proxies on-the-fly only when Grok is running.
> **Disclaimer:** `grok-build-providers` is an independent, community-built tool. It is **not affiliated with, endorsed by, or sponsored by x.AI, Grok, or any model provider** (OpenAI/Codex, Google/Gemini/Antigravity, DeepSeek, or Alibaba/Qwen). All product names and trademarks belong to their respective owners and are used only to describe interoperability.
## Prerequisites
- **[Grok Build](https://x.ai/cli)** installed and on your `PATH`. This tool configures Grok's connectors; it does not install Grok Build itself.
- For the inline connectors, the backing CLI must be installed and signed in: **`agy`** (Antigravity/Gemini) or **`codex`** (Codex). The passthrough connectors (**DeepSeek**, **Qwen**) only need an API key.
## Connectors
All connectors are distributed in a single, unified npm package `grok-build-providers`.
| Command | Provider | Default Model | Config Snippet | Description |
| :--- | :--- | :--- | :--- | :--- |
| **`grok-agy`** |  | `gemini-3.5-flash` | [toml](providers/agy/templates/grok-config-snippet.toml) | Gemini models via Antigravity CLI OAuth |
| **`grok-codex`** |  | `gpt-5.5` | [toml](providers/codex/templates/grok-config-snippet.toml) | Codex models via the Codex CLI OAuth |
| **`grok-deepseek`** |  | `deepseek-v4-flash` | [manifest](providers/providers.json) | DeepSeek API direct compatible-mode integration |
| **`grok-qwen`** |  | `qwen2.5-coder-32b-instruct` | [manifest](providers/providers.json) | Alibaba DashScope Qwen2.5-Coder models |
> The full connector list is the single source of truth in [`providers/providers.json`](providers/providers.json). See [CONTRIBUTING.md](CONTRIBUTING.md) to add one.
---
## Interactive Configuration Console & TUI
`grok-build-providers` provides a zero-dependency interactive control panel to manage all your model connectors.
### Install (recommended)
Install globally with npm, then launch the console:
```bash
npm install -g grok-build-providers
grok-build-providers
```
A global install is the recommended setup: it gives every connector, including the inline ones (`agy`, `codex`), a stable home. (See [Trying it without installing](#trying-it-without-installing) for the `npx` caveat.)
### Headless / non-interactive
Install connectors directly, without the menu:
```bash
grok-build-providers agy # install the Gemini/Antigravity connector
grok-build-providers codex # install the Codex connector
grok-build-providers deepseek # install the DeepSeek connector
grok-build-providers qwen # install the Qwen Coder connector
grok-build-providers all # install everything
```
### Running without installing
```bash
npx grok-build-providers
```
Use `npx` for a quick try without a global install. What works and what does not:
- **DeepSeek, Qwen (passthrough):** fully supported via `npx`. Their launchers are self-contained and only need an API key.
- **Gemini/AGY, Codex (inline):** unreliable via `npx`. Their launchers reference the package directory, so they break once npm clears its temporary `npx` cache. Use a global install for these.
---
## Running a connector
After installing, launch Grok on a connector with its `grok-` command. It spins up the inline proxy on demand and shuts it down when you exit:
```bash
grok-agy # interactive Grok session on Antigravity/Gemini
grok-codex -p "explain this repo" # one-shot prompt via Codex
```
Or set one as the global default in the TUI and press `space` to launch.
> **Custom connectors (`agy`, `codex`) must be started through their `grok-` command** (or the TUI's launch), which starts the local proxy first. Running plain `grok` against them fails with `retrying…` because nothing is listening on the proxy port.
Troubleshooting: set `GROK_PROXY_DEBUG=1` before a `grok-` command to write a trace to `~/.cli-proxy-api/logs/inline-proxy-debug.log`.
---
## Features
* **Status Monitor**: Checks the installation status of all connectors and reports their active default models.
* **Active Model Switcher**: Swap between connectors (`agy`, `codex`, `deepseek`, `qwen`) as the active default model in your `~/.grok/config.toml` with a single keypress.
* **Option Adjuster**: Switch default models inside each connector (e.g. `gpt-5.5` vs `gpt-5.4` on Codex, or `gemini-3.5-flash` vs `gemini-3-pro` on AGY).
* **Quick Installer / Uninstaller**: Set up or cleanly remove any or all connectors (launcher, credentials file, and `config.toml` block) with execution logs rendered inline.
* **Launch**: Start a Grok session on the active connector straight from the menu (press `space`).
---
## Getting Started
### Prerequisites
Requires **[Grok Build](https://x.ai/cli)** (`grok`) on your PATH. Configuration lives in `~/.grok/config.toml`.
### Development
Clone the repository to contribute or run from source:
```bash
git clone https://github.com/jamubc/grok-build-providers.git
cd grok-build-providers
npm install
```
### Installed commands
A global install (see [Install](#install-recommended)) registers:
| Command | Description |
| :--- | :--- |
| `grok-build-providers` | Interactive TUI configuration manager |
| `grok-agy` | Grok Build with Antigravity (Gemini) proxy |
| `grok-codex` | Grok Build with Codex proxy |
| `grok-deepseek` | Grok Build with DeepSeek |
| `grok-qwen` | Grok Build with Qwen Coder |
---
## Issues & Contributions
Have a bug or feature request?
* Please open an issue on the **[GitHub Issue Tracker](https://github.com/jamubc/grok-build-providers/issues)**.
* Check the **[Releases & Downloads](https://github.com/jamubc/grok-build-providers/releases)** for stable tags and archives.