# Install dsq with Homebrew, MacPorts, Nix, pacman

CLI tool for running SQL queries against JSON, CSV, Excel, Parquet, and more. Version 0.23.0 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:dsq
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install dsq
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install dsq
```

  Evidence: MacPorts ports tree: textproc/dsq/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#dsq
```

  Evidence: nixpkgs package indexes: pkgs/by-name/ds/dsq/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S dsq
```

  Evidence: Arch Linux sync databases: dsq from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

## Package facts

- **Package key:** brew:dsq
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/dsq>
- **Version:** 0.23.0
- **Source summary:** CLI tool for running SQL queries against JSON, CSV, Excel, Parquet, and more
- **Homepage:** <https://github.com/multiprocessio/dsq>
- **Repository:** <https://github.com/multiprocessio/dsq>
- **Upstream docs:** <https://github.com/multiprocessio/dsq#readme>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/multiprocessio/dsq/archive/refs/tags/v0.23.0.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- dsq (cli)
- dsq (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_big_sur, arm64_linux, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, big_sur, catalina, monterey, sonoma, ventura

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.23.0
- Local data: ok
- Upstream repository: https://github.com/multiprocessio/dsq
- Upstream latest detected: v0.23.0 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

dsq is a Go command-line tool for running SQL queries over data files such as JSON, CSV, Excel, Parquet, TSV, and logs. Upstream now labels it not under active development and points users toward DuckDB, ClickHouse-local, and GlareDB-style analytics foundations.

### Project history

The README presents dsq as a CLI companion to DataStation, the Multiprocess Labs GUI for querying data files. Its implementation approach is SQLite-centered, which made it convenient and portable for mixed local files but eventually less attractive than columnar/vectorized analytics engines.

The release history moved quickly through 2022: 0.15 added query-file and cache flags, 0.16 added an interactive REPL, 0.22 added logfmt support, and v0.23.0 fixed nested JSON handling. The README later opened with a not-under-active-development notice and recommended DuckDB, ClickHouse-local, and GlareDB instead.

### Adoption history

dsq's adoption came from the CLI data-wrangling crowd: people who wanted `jq`-adjacent convenience but preferred SQL over local structured files. It shipped Homebrew installation instructions in the README and has also appeared in MacPorts, Nix, and Arch packages.

Homebrew analytics showed 159 installs over the preceding 365 days during this batch, consistent with a useful but superseded utility.

### How it is used

Typical use is `dsq file.json 'SELECT ... FROM {}'`, piping data with `-s`, joining multiple files as numbered tables, pretty-printing results, dumping inferred schema, caching imported data, or using the interactive REPL added in the 0.16 line.

### Why package nerds care

dsq is package-nerd significant because it marks a short transitional moment in local data tools: single-binary SQL over arbitrary files before DuckDB became the obvious answer for many of the same workflows. Its own README now documents that transition by pointing users away from dsq toward stronger analytics engines.

### Timeline

- 2022-04-20: 0.15.0 added query-file and cache support.
- 2022-04-26: 0.16.0 added a basic interactive REPL.
- 2022-08-26: v0.22.0 added logfmt support.
- 2022-10-20: v0.23.0 fixed nested JSON query handling and is the Homebrew stable version recorded for this batch.
- Later README state: Upstream marked the project not under active development and recommended DuckDB, ClickHouse-local, and GlareDB.

### Related projects

- DataStation is the GUI companion project named by the README.
- DuckDB, ClickHouse-local, and GlareDB are the README's recommended successors or alternatives.
- SQLite is the underlying style of engine the README contrasts with newer columnar/vectorized systems.
- jq is a common neighboring CLI in local JSON/data-wrangling workflows.

### Sources

- <https://github.com/multiprocessio/dsq#readme>
- <https://github.com/multiprocessio/dsq/releases/tag/0.15.0>
- <https://github.com/multiprocessio/dsq/releases/tag/0.16.0>
- <https://github.com/multiprocessio/dsq/releases/tag/v0.22.0>
- <https://github.com/multiprocessio/dsq/releases/tag/v0.23.0>
- <https://formulae.brew.sh/formula/dsq>


## Security Notes

broad file, network, media, or database tool signal.

- **Geiger risk:** blue / medium
- broad file, network, media, or database tool signal

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** dsq
- **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

## Other Package-Manager Records

- Nix - dsq: normalized package name match | nixpkgs package indexes: pkgs/by-name/ds/dsq/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- pacman - dsq - 0.23.0-3: normalized package name match | Arch Linux sync databases: dsq from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | CLI tool for running SQL queries against JSON/CSV/Excel/Parquet and more | https://github.com/multiprocessio/dsq
- MacPorts - dsq: normalized package name match | MacPorts ports tree: textproc/dsq/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [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.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [qo](https://www.automicvault.com/pkg/brew/qo/) - Shares av.db curated category or tags: cli, csv, data, json, query-tools.
- [beanquery](https://www.automicvault.com/pkg/brew/beanquery/) - Shares av.db curated category or tags: cli, data, query-tools, sql.
- [octosql](https://www.automicvault.com/pkg/brew/octosql/) - Shares av.db curated category or tags: cli, data, query-tools, sql.
- [qp](https://www.automicvault.com/pkg/brew/qp/) - Shares av.db curated category or tags: cli, data, json, query-tools.
- [cqlkit](https://www.automicvault.com/pkg/brew/cqlkit/) - Shares av.db curated category or tags: cli, csv, data, json.
- [csvq](https://www.automicvault.com/pkg/brew/csvq/) - Shares av.db curated category or tags: cli, csv, data, sql.
- [miller](https://www.automicvault.com/pkg/brew/miller/) - Shares av.db curated category or tags: cli, csv, data, json.
- [tidy-viewer](https://www.automicvault.com/pkg/brew/tidy-viewer/) - Shares av.db curated category or tags: cli, csv, data, parquet.

## Combined YAML source

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


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
