powder-cli 0.1.1

Upload financial statements and extract structured data from the command line

powder-cli

Python CLI for the Powder API — upload financial statements and extract structured data.

Installation

pip install powder-cli

Requires Python 3.10+.

Quick Start

1. Set Your API Token

export POWDER_API_TOKEN="your-token-here"

Add to ~/.zshrc or ~/.bashrc to persist. To get a token, contact [e-mail].

Alternatively, use powder configure for interactive setup (saves to ~/.config/powder/config.json).

2. Upload a Statement

powder upload statement.pdf

This returns an upload ID that you'll use to check status and retrieve data.

3. Check Status

powder status 12345

Or watch until processing completes:

powder status 12345 --watch

4. Retrieve Data

powder data 12345

View data as a table:

powder data 12345 --format table

Supported File Types

Format	Extensions
PDF	.pdf
Images	.png, .jpg, .jpeg
Spreadsheets	.xlsx

Maximum file size: 50 MB

JSON Output

All CLI commands support --json for machine-readable output. The flag goes before the command:

powder --json upload statement.pdf
powder --json status 12345
powder --json data 12345

Authentication

The CLI checks for credentials in this order:

1. POWDER_API_TOKEN environment variable
2. ~/.config/powder/config.json (created by powder configure)

To get an API token, contact [e-mail].

Claude Code Plugin

A Claude Code plugin is available at Powder-Finance/claude-code-powder-plugin for conversational document uploads:

/Powder:setup     # Install CLI + verify token
/Powder:upload    # Upload → process → extract → summarize
/Powder:data      # Fetch data for an existing upload
/Powder:status    # Check processing status