> ## Documentation Index
> Fetch the complete documentation index at: https://docs.li.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Setup instructions for installing and configuring the LI.FI CLI

## npm (Global Install)

Install the CLI globally to use the `lifi` command anywhere:

```bash theme={"system"}
npm install -g @lifi/cli
```

Verify the installation:

```bash theme={"system"}
lifi health
```

## npx (No Install)

Run any CLI command without installing:

```bash theme={"system"}
npx @lifi/cli chains
npx @lifi/cli quote --from 1 --to 8453 --from-token USDC --to-token USDC --amount 1000000000
```

## Configuration

All configuration is via environment variables. No config files needed.

### API Key

Set your LI.FI API key for higher rate limits:

```bash theme={"system"}
export LIFI_API_KEY=your_key_here
```

| Configuration       | Rate Limit             |
| ------------------- | ---------------------- |
| No API key (public) | 200 requests / 2 hours |
| With API key        | 200 requests / minute  |

### Verify Your Key

```bash theme={"system"}
lifi auth show    # Display masked key
lifi auth test    # Validate key against the API
```

## Testing Your Setup

Run the health check to verify API connectivity:

```bash theme={"system"}
lifi health
```

List supported chains to confirm everything works:

```bash theme={"system"}
lifi chains
```

If both commands return data successfully, your CLI is ready to use.

<Card title="GitHub Repository" icon="github" href="https://github.com/lifinance/lifi-cli">
  Source code and development instructions
</Card>