Configuration

The personal tier does not require an API key. For the Cloud tier, get your key at app.witanlabs.com/~/settings/api-keys:

export WITAN_API_KEY="sk_..."

Windows (PowerShell)

$env:WITAN_API_KEY = "sk_..."

Zero Data Retention

When WITAN_STATELESS=1 is set, files are processed in memory and immediately discarded. Nothing is stored. Useful for sensitive financial data:

export WITAN_STATELESS=1
witan xlsx render confidential-report.xlsx -r "Sheet1!A1:Z50"

Trade-off: Each command re-uploads the file since there is no server-side caching. Slightly slower for repeated operations on the same file, but guarantees zero data retention.

Environment variables

All configuration is via environment variables:

Variable Description Default
WITAN_API_KEY API key. Required for the Cloud tier.
WITAN_API_URL Custom API endpoint. https://api.witanlabs.com
WITAN_STATELESS Set to 1 for zero data retention mode — files processed but never stored. 0