Skip to content

Add --free flag for gateway free tier access - #83

Merged
crtahlin merged 1 commit into
mainfrom
feature/free-tier-82
Mar 3, 2026
Merged

Add --free flag for gateway free tier access#83
crtahlin merged 1 commit into
mainfrom
feature/free-tier-82

Conversation

@crtahlin

@crtahlin crtahlin commented Mar 3, 2026

Copy link
Copy Markdown

Summary

  • Add --free CLI flag and FREE_TIER env var that sends X-Payment-Mode: free header to the gateway, enabling rate-limited (3 req/min) access without wallet or x402 configuration
  • Update 402 error messages to mention --free as an alternative to --x402
  • Bump version 0.8.2 → 0.8.3

Closes #82

Changes

  • config.py: FREE_TIER env var
  • core/gateway_client.py: free_tier constructor param, header in _get_headers() + 3 upload methods, updated 402 error hint
  • cli.py: --free global flag, passed to all 15 GatewayClient instantiations
  • Tests: 6 gateway client tests + 3 CLI tests, all passing (554 total)
  • Docs: README, CLAUDE.md, CHANGELOG, .env.example updated

Test plan

  • pytest tests/test_gateway_client.py -k "FreeTier" — 6 passed
  • pytest tests/test_cli.py -k "FreeTier" — 3 passed
  • pytest --ignore=tests/test_integration.py — 554 passed, 18 skipped
  • Manual: swarm-prov-upload --free health
  • Manual: swarm-prov-upload --free upload --file /tmp/test.txt --std "PROV-STD-V1"

Add FREE_TIER env var and --free CLI flag that sends
X-Payment-Mode: free header to the gateway, enabling
rate-limited (3 req/min) access without wallet setup.

Bump version 0.8.2 → 0.8.3.
@crtahlin
crtahlin merged commit 5a1d812 into main Mar 3, 2026
11 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add --free flag for gateway free tier (X-Payment-Mode: free)

1 participant