# Install vulcain with Homebrew

Fast and idiomatic client-driven REST APIs. Version 1.4.2 via Homebrew; verified 2026-07-26.

## Install

```sh
sudo av install brew:vulcain
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install vulcain
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:vulcain
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/vulcain>
- **Version:** 1.4.2
- **Source summary:** Fast and idiomatic client-driven REST APIs
- **Homepage:** <https://vulcain.rocks/>
- **Repository:** <https://github.com/dunglas/vulcain>
- **Upstream docs:** <https://github.com/dunglas/vulcain#readme>
- **License:** AGPL-3.0-only
- **Source archive:** <https://github.com/dunglas/vulcain/archive/refs/tags/v1.4.2.tar.gz>
- **Last updated:** 2026-07-26T00:30:34+02:00
- **Generated:** 2026-07-26T07:20:29+00:00

## Executables

- vulcain (cli)
- vulcain (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Service: declared
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-26
- Package-manager version: 1.4.2
- Package-manager updated: 2026-07-26
- Local data: ok
- Upstream repository: https://github.com/dunglas/vulcain
- Upstream latest detected: v1.4.2 (current)
## Project history and usage

Vulcain is a Go project and protocol for client-driven REST APIs. It tries to solve common API performance problems such as under-fetching, over-fetching, and the n+1 request pattern while staying close to HTTP, hypermedia links, preload hints, 103 Early Hints, and HTTP/2 server push.

### Project history

The public repository was created in September 2019 under Kévin Dunglas's GitHub account. The README presents Vulcain as both a protocol and a reference gateway server: a Caddy web server module that can sit in front of an existing API and make it Vulcain-compatible.

The project was published as an Internet-Draft maintained from the same repository, which is notable for a small API tooling project: the author framed Vulcain as a protocol-level alternative to application-specific API query layers rather than just another gateway implementation.

### How it is used

A Vulcain client asks for related resources with a `Preload` header or query parameter, and can also request selected fields with a `Fields` header. The gateway follows hypermedia relations, or OpenAPI-described relations for legacy APIs, and can return or push the related resources so a client can later fetch them from cache.

In package-nerd terms, the installed `vulcain` command is mainly useful to API and framework developers experimenting with HTTP-native API composition. It is closely associated with API Platform, Caddy, OpenAPI, and the broader debate over when GraphQL-style query layers are necessary.

### Timeline

- 2019: The GitHub repository was created and the project was introduced publicly as a client-driven REST approach using HTTP/2 server push.
- 2019: v0.1.0 was published on GitHub on October 13, 2019.
- 2026: The project was still receiving tagged releases, including v1.4.1 on May 19, 2026.

### Related projects

- Vulcain is related to Caddy, API Platform, OpenAPI, GraphQL, JSON:API, HAL, HTTP preload hints, 103 Early Hints, and HTTP/2 server push.

### Sources

- <https://api.github.com/repos/dunglas/vulcain>
- <https://api.github.com/repos/dunglas/vulcain/releases>
- <https://github.com/dunglas/vulcain>
- <https://vulcain.rocks/>


## Security Notes

No matching local secret-handling manifest was found for vulcain. Nucleus package metadata is still published here so future coverage has a stable package URL.


## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** vulcain
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [atac](https://www.automicvault.com/pkg/brew/atac/) - Shares av.db curated category or tags: api, cli, developer-tools, http.
- [httpie](https://www.automicvault.com/pkg/brew/httpie/) - Shares av.db curated category or tags: cli, developer-tools, rest.
- [posting](https://www.automicvault.com/pkg/brew/posting/) - Shares av.db curated category or tags: cli, developer-tools, http.
- [resterm](https://www.automicvault.com/pkg/brew/resterm/) - Shares av.db curated category or tags: cli, developer-tools, http, rest.
- [restish](https://www.automicvault.com/pkg/brew/restish/) - Shares av.db curated category or tags: cli, developer-tools, http, rest.
- [resty](https://www.automicvault.com/pkg/brew/resty/) - Shares av.db curated category or tags: cli, developer-tools, http, rest.
- [twitch-cli](https://www.automicvault.com/pkg/brew/twitch-cli/) - Shares av.db curated category or tags: api, cli, developer-tools.
- [ulfius](https://www.automicvault.com/pkg/brew/ulfius/) - Shares av.db curated category or tags: cli, developer-tools, http, rest.

## Combined YAML source

View the package source record on GitHub. [combined/vulcain.yml](https://github.com/automic-vault/db/blob/main/combined/vulcain.yml)


## Sources

- Nucleus package database
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
