configure

fialr configure ai [options]

Set up the AI enrichment provider. Supports local Ollama (default) and cloud Claude API (BYOK). API keys are stored in the system keychain, not in config files.

Arguments

Argument	Description
`ai`	Configure the AI enrichment provider (currently the only subaction)

Options

Option	Description
`--show`	Display current provider and API key status
`--provider NAME`	Set provider: `ollama` (local) or `claude` (cloud)
`--key KEY`	Set API key for cloud provider (must start with `sk-ant-`)

When no flags are provided, runs in interactive mode.

Providers

Provider	Tiers	Setup	Cost
Ollama	All tiers	Install Ollama, pull model	Free (local)
Claude	2, 3 (Tier 1 with two-step confirmation)	API key from Anthropic	Pay-per-token

Tier 1 files use local AI (Ollama) by default. Cloud access for Tier 1 requires two-step confirmation (config flag + CLI flag). This is enforced in the enrichment orchestrator.

Key storage

API keys are resolved in this order:

ANTHROPIC_API_KEY environment variable (for CI and scripting)
System keychain via keyring library
Error with setup instructions

Keys set via --key are stored in the system keychain. They are never written to fialr.toml or any config file.

Platform	Backend
macOS	Keychain Access (`security` CLI)
Linux	Secret Service API (GNOME Keyring, KDE Wallet) via `keyring`

On Linux, ensure a Secret Service provider is running. Most desktop environments include one. For headless/server environments, you can use the ANTHROPIC_API_KEY environment variable instead.

Examples

# Interactive setup
fialr configure ai

# Set up Claude with API key
fialr configure ai --provider claude --key sk-ant-...

# Switch back to local Ollama
fialr configure ai --provider ollama

# Check current configuration
fialr configure ai --show