Skip to main content

Search the taxonomy of any organism by scientific or common name.

Project description

find-life

CLI for looking up the taxonomy of any organism by scientific or common name. Pulls data from find-life.org, which sources taxonomy from find-life-database (an actively maintained fork of ITIS), fossil records from the Paleobiology Database, and summaries from Wikipedia.

Install

pip install find-life
# or
uv tool install find-life

If you don't have a Python environment configured, I recommend installing uv first:

curl -LsSf https://astral.sh/uv/install.sh | sh

Then run uv tool install find-life.

Usage

find-life search <name> [OPTIONS]

Options:

Flag Description
--scientific Search scientific names only
--common Search vernacular names only
-f, --format Output format: text (default), table, or json

Examples:

find-life search penguin
find-life search "Sphenisciformes" --scientific
find-life search penguin --format json
find-life search penguin --format table

Output (text format):

Taxonomy:
Chordata  (Phylum)
  └─ Vertebrata  (Subphylum)
    └─ ...
      └─ ▶  Sphenisciformes  (Order)
         └─ Spheniscidae  (Family)

First appeared: 66 – 59.24 Ma

Wikipedia: Penguins are a group of flightless semi-aquatic sea birds...
Source:    https://en.wikipedia.org/wiki/Penguin

Commands

  • find-life search <name> — look up a taxon
  • find-life init — reset or reconfigure your API token

Configuration

A token is provisioned automatically on first use and stored in ~/.find-life/config.json. Run find-life init to reset it.

Website

Explore the data interactively at find-life.org — visualizes the full tree of life as a navigable graph.

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

find_life-0.2.1.tar.gz (4.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

find_life-0.2.1-py3-none-any.whl (5.7 kB view details)

Uploaded Python 3

File details

Details for the file find_life-0.2.1.tar.gz.

File metadata

  • Download URL: find_life-0.2.1.tar.gz
  • Upload date:
  • Size: 4.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for find_life-0.2.1.tar.gz
Algorithm Hash digest
SHA256 aa0f75dba2185a8a9f83b6d1ac5982044d2fd9d167a65cf578219ab92a21c3db
MD5 daf68d78dcd75b895bd51c6c1395d38d
BLAKE2b-256 c84eeaa50d0cb52536c2db2848719c40de1069eb90ef82abbfb566f56a17295f

See more details on using hashes here.

File details

Details for the file find_life-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: find_life-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 5.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for find_life-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b6efe25583d11d0b037330b79a1df03b36503b2761e0f99ff578c259493b2a06
MD5 f48b44218d8961ec192c8c583b61acc5
BLAKE2b-256 537b5125c66e18b2908dac67a6e5f8661673add684a21d6b376f0efc77a95fc7

See more details on using hashes here.

Supported by

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