Metadata-Version: 2.4
Name: find-life
Version: 0.2.0
Summary: Taxonomic name search.
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: click>=8.3.3
Requires-Dist: httpx>=0.28.1

# find-life

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

## Install

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

## Usage

```sh
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:**

```sh
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](https://find-life.org) — visualizes the full tree of life as a navigable graph.
