Getting started

Installation
Mac OS
1
brew install dataframehq/tap/whale
Copied!
All others (and local development)
You'll need to have rust installed for the following commands to work.
​Click here for installation instructions.
If you are not on macOS (or are looking to build whale from source for development purposes), you should (a) clone the whale repository and run (b)make && make install in the base directory of the repo.
1
git clone https://github.com/dataframehq/whale.git
2
cd whale/
3
make && make install
Copied!
The Makefile commands don't explicitly add an alias for the whale binary, so you'll want to add the following alias to your .bash_profile or .zshrc file.
1
alias wh=~/.whale/bin/whale
Copied!
This method is generally preferred for development as well, as the virtual environment is exposed and modifiable in ~/.whale/libexec/env.
Advanced syntax highlighting
We highly recommend installing bat to enable advanced syntax highlighting (once detected, whale will use bat over cat automatically).
Quick start (local usage)
Start by running:
1
wh init
Copied!
This will assist you in:
Setting up the necessary file structure in ~/.whale.
Setting up your warehouse connection credentials.
Registering a cron job in your crontab, so whale can periodically scrape metadata.
Once that is complete, either wait for the cron job to run, or run wh pull & to manually kick off a job in the background, if you're feeling impatient.
If you instead want to use a git server like github to back your catalog, see Git setup.
Basic usage
To obtain a list of available commands, run:
1
wh -h
Copied!
To run whale's search engine, run:
1
wh
Copied!

Next - Setup

Connection configuration

Last modified 11mo ago

Copy link

Contents

Installation

Mac OS

All others (and local development)

Advanced syntax highlighting

Quick start (local usage)

Basic usage