sbproxy

KO | EN

gitlite — search

#python #java #swift #golang #nodejs #android #game #react #machine-learning #tensorflow #javascript #json

★ 49 Open GitHub ↗

Open source Enterprise AI Gateway for API, MCP and agent, and AI model traffic. One Apache-2.0 binary: 72 native providers behind an OpenAI-compatible API, or serve vLLM and llama.cpp on your own GPUs. Keys, budgets, guardrails, semantic cache, WAF.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# SBproxy

*Last modified: 2026-08-03*

SBproxy is an open source Enterprise AI Gateway for API, MCP and agent, and AI model traffic. Every feature in this repository ships under Apache-2.0.

## Start here

Install a release on Linux or Apple Silicon macOS:

```bash
curl -fsSL https://download.sbproxy.dev | sh
export PATH="$HOME/.local/bin:$PATH"
sbproxy --version
```

The installer writes to `~/.local/bin` by default. Keep the `export` in your
shell profile if that directory was not already on `PATH`. Linux amd64, Linux
arm64, and Apple Silicon macOS arm64 have release archives. Intel Macs can use
the Linux image in Docker or build from source. See the
[runtime manual](docs/manual.md#1-installation) for the complete install matrix
and checksums.

Run the credential-free gateway example next. It starts a local upstream, puts an API behind the gateway, adds an MCP tool, then sends a local OpenAI-compatible completion through the same listener.

```bash
git clone https://github.com/soapbucket/sbproxy
cd sbproxy
```

[Follow the getting-started guide.](docs/getting-started.md)

## Choose your job

| If you need to | Start with |
|---|---|
| Understand the parts of a gateway | [Core concepts](docs/core-concepts.md) |
| Put an existing HTTP API behind policy | [API-estate guide](docs/getting-started-api-estate.md) |
| Run a local model | [Run your first managed model](docs/quickstart-serve.md) |
| Route to hosted models | [AI gateway reference](docs/ai-gateway.md) |
| Expose or federate MCP tools | [MCP gateway](docs/mcp.md) |
| Run the Kubernetes operator | [Operator quickstart](docs/quickstart-operator.md) |
| Upgrade a running deployment | [Upgrade guide](docs/upgrade.md) |

## Install alternatives

Homebrew:

```bash
brew tap soapbucket/tap
brew install sbproxy
```

Docker. The published image has no default configuration command, so mount the file and name the command:

```bash
docker pull soapbucket/sbproxy:latest
docker run --rm -p 8080:8080 \
  -v "$PWD/sb.yml:/etc/sbproxy/sb.yml:ro" \
  soapbucket/sbproxy:latest serve -f /etc/sbproxy/sb.yml
```

Build from source when you need a local development binary:

```bash
make build-release
target/release/sbproxy --version
```

## Documentation and examples

[Documentation index](docs/README.md) groups the guides by first run, traffic type, operations, and reference material. The [`examples/`](examples/) directory contains complete configurations. For the configuration schema, use [configuration.md](docs/configuration.md); for the command surface, use [manual.md](docs/manual.md).

## Contributing and license

See [CONTRIBUTING.md](CONTRIBUTING.md) for the contributor workflow. SBproxy is released under [Apache License 2.0](LICENSE). See [NOTICE](NOTICE) and [TRADEMARKS](TRADEMARKS.md).

sbproxy

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README