Version: Next

Installation

Several options for installing super are available:

To install the SuperDB Python client, see the Python library documentation.

Homebrew

On macOS and Linux, you can use Homebrew to install super:

brew install brimdata/tap/super

Once installed, run a quick test.

We offer pre-built binaries for macOS, Windows and Linux for both amd64/x86 and arm architectures in the super GitHub Release page.

Once the super binary is unpacked from a downloaded package, run a quick test.

If you have Go installed, you can easily build super from source:

go install github.com/brimdata/super/cmd/super@latest

This installs the super binary in your $GOPATH/bin.

Once installed, run a quick test.

note

If you don't have Go installed, download and install it from the Go install page. Go 1.23 or later is required.

super is easy to test as it's a completely self-contained command-line tool and requires no external dependencies.

To test super, simply run this command in your shell:

echo '"hello, world"' | super -z -

which should produce

"hello, world"

To test super db, we'll make a SuperDB data lake in ./scratch, load data, and query it as follows:

export SUPER_DB_LAKE=./scratch
super db init
super db create Demo
echo '{s:"hello, world"}' | super db load -use Demo -
super db query "from Demo"

which should display

{s:"hello, world"}

Alternatively, you can run a lake service, load it with data using super db load, and hit the API.

In one shell, run the server:

super db init -lake scratch
super db serve -lake scratch

And in another shell, run the client:

super db create Demo
super db use Demo
echo '{s:"hello, world"}' | super db load -
super db query "from Demo"

which should also display

{s:"hello, world"}