# Install octosql with Homebrew, MacPorts, Nix, scoop

SQL query tool to analyze data from different file formats and databases. Version 0.13.0 via Homebrew; verified 2026-07-27. Also installable with nix: nix profile install nixpkgs#octosql.

## Install

```sh
sudo av install brew:octosql
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install octosql
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install octosql
```

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

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#octosql
```

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

### Windows

- Scoop (92%):

```sh
scoop install main/octosql
```

  Evidence: Scoop official bucket manifest trees: bucket/octosql.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:octosql
- **Package manager:** Homebrew
- **Version:** 0.13.0
- **Source summary:** SQL query tool to analyze data from different file formats and databases
- **Homepage:** <https://github.com/cube2222/octosql/>
- **Repository:** <https://github.com/cube2222/octosql>
- **Last updated:** 2026-07-27T23:46:50+02:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- octosql (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 0.13.0
## Project history and usage

OctoSQL is a Go CLI query engine that lets users run SQL across files and databases through one interface. Its hook is practical and package-index friendly: JSON, CSV, TSV, Parquet, stdin streams, and database plugins can all become SQL tables.

### Project history

The public repository was created on 2019-03-03. The README describes OctoSQL as both a CLI for joining, analyzing, and transforming data from multiple file formats and databases, and as an extensible dataflow engine that applications can embed for SQL access.

### Adoption history

OctoSQL gained enough distribution footprint to appear in Homebrew, MacPorts, Nix, and Scoop package metadata. The GitHub API metadata recorded Go as the primary language and repository topics including sql, query-engine, data-analysis, csv, json, postgresql, mysql, and redis.

### How it is used

Users run commands such as octosql "SELECT * FROM ./myfile.json" or join local files with configured databases. Built-in file support covers JSONLines, CSV, TSV, Parquet, line-oriented text, and stdin tables; additional database support is installed through OctoSQL plugins and configured in octosql.yml.

### Why package nerds care

OctoSQL sits in the useful CLI niche between shell text tools, SQLite/DuckDB-style local querying, and heavier federated query engines. It is significant as a packaged single-purpose developer tool: install one binary, point it at heterogeneous data, and use SQL instead of format-specific scripts.

### Timeline

- 2019-03-03: public GitHub repository created.
- 2026-07-01: Homebrew formula metadata listed stable version 0.13.0 and binary bottles for macOS and Linux variants.

### Related projects

- Comparable tools in the same package-nerd neighborhood include DuckDB's CLI for local analytical SQL and other command-line query tools for files, but OctoSQL's plugin tables and database/file joins give it a federated-query flavor.

### Sources

- <https://api.github.com/repos/cube2222/octosql>
- <https://formulae.brew.sh/api/formula/octosql.json>
- <https://formulae.brew.sh/formula/octosql>
- <https://github.com/cube2222/octosql>
- <https://raw.githubusercontent.com/cube2222/octosql/master/README.md>


## Security Notes

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

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

## Other Package-Manager Records

- Nix - octosql: normalized package name match | nixpkgs package indexes: pkgs/by-name/oc/octosql/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- MacPorts - octosql: normalized package name match | MacPorts ports tree: databases/octosql/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Scoop - main/octosql: normalized package name match | Scoop official bucket manifest trees: bucket/octosql.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1


## Combined YAML source

View the package source record on GitHub. [combined/octosql.yml](https://github.com/mxcl/pkgdb/blob/main/combined/octosql.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph