Skip to main content

Simple CLI for

Project description

Simple CLI for Happywhale

LinkedIn Medium Twitter URL Mastodon Follow DOI CI happywhale Hits-of-Code PyPI version Donate Donate

Happywhale is a global citizen science project dedicated to whale and dolphin research and conservation. The user-friendly Happywhale app allows anyone to share photos of encounters with these marine mammals, which are then processed by a team of scientists and volunteers using advanced image recognition algorithms. Identified individuals are tracked over time and across locations, yielding valuable insights into their behavior and aiding in the preservation of critical habitats.

The CLI is designed to interact with the website and allow for you to perform operations like search, download and more using underlying api end points. The CLI provides tools based on API endpoints that may change and evolve and can lead to compatibility issues without API documentations so this tool will be developed as needed to support the larger community needs.

Disclaimer: This is an unofficial tool. Is not licensed or endorsed by It is created and maintained by Samapriya Roy.

happywhale -h
usage: [-h] {readme,auth,species,stats,fetch,search,download} ...

Simple CLI for HappyWhale API

positional arguments:
    readme              Go to the web based happywhale cli readme page
    auth                Saves your username and password
    species             Get species list
    stats               Go site stats for happywhale
    fetch               Fetch details on an encounter based on encounter id
    search              Search and export results (Default: Global 1 month)
    download            Download images from search results (Default: Global 1 month)

  -h, --help            show this help message and exit


You can cite the tool too

Samapriya Roy. (2023). open-oceans/happywhale: Simple CLI for API (0.0.2).

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

happywhale-0.0.3.tar.gz (15.6 kB view hashes)

Uploaded Source

Built Distribution

happywhale-0.0.3-py3-none-any.whl (14.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page