sochen/autofax
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Automated hourly fax sender for insurance claims with printable HR reports
10 commits 1 branch 0 tags 100 KiB
Python 90.1%
Shell 7.7%
Batchfile 2.2%
Find a file
Sochen d72a0c13c5 Clean up: remove dead Telnyx statuses, doula references, personal info, fix README 
- Remove legacy Telnyx status strings (delivered, sent, queued, sending)
- Remove duplicate save_log/generate_report calls in main()
- Remove hardcoded personal fax number from GUI placeholder
- Replace "doula coverage claim" with generic "claim" in HTML reports
- Fix README: "7 days" → "3 successful deliveries", remove unnecessary number purchase step

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-07 01:08:50 +00:00
claims Initial commit: automated hourly fax sender for insurance claims 2026-03-06 11:36:47 +00:00
.env.example Make from number optional, Sinch auto-assigns 2026-03-06 22:33:45 +00:00
.gitignore Add Telnyx setup wizard, remove PROJECT.md from repo 2026-03-06 21:35:18 +00:00
autofax.py Clean up: remove dead Telnyx statuses, doula references, personal info, fix README 2026-03-07 01:08:50 +00:00
build.sh Initial commit: automated hourly fax sender for insurance claims 2026-03-06 11:36:47 +00:00
build_windows.bat Initial commit: automated hourly fax sender for insurance claims 2026-03-06 11:36:47 +00:00
config.py Make from number optional, Sinch auto-assigns 2026-03-06 22:33:45 +00:00
gui.py Clean up: remove dead Telnyx statuses, doula references, personal info, fix README 2026-03-07 01:08:50 +00:00
install.sh Run first fax 2 minutes after install, then hourly 2026-03-06 22:49:37 +00:00
README.md Clean up: remove dead Telnyx statuses, doula references, personal info, fix README 2026-03-07 01:08:50 +00:00
requirements.txt Initial commit: automated hourly fax sender for insurance claims 2026-03-06 11:36:47 +00:00
uninstall.sh Initial commit: automated hourly fax sender for insurance claims 2026-03-06 11:36:47 +00:00

README.md

AutoFax

Automated hourly fax sender for insurance claim submissions. Sends your claim via Sinch's fax API every hour and generates a printable HTML report documenting every attempt and its status -- useful for showing HR or the insurance company that their fax system is rejecting claims.

Quick Start (Windows GUI)

If someone gave you AutoFax.exe on a flash drive:

  1. Double-click AutoFax.exe
  2. Fill in the Sinch credentials (Project ID, Key ID, Key Secret, From Number)
  3. Set the destination fax number
  4. Click Browse and select your claim PDF
  5. Click Start Hourly Faxing

Config is saved next to the exe, so it remembers your settings. Reports are generated in a reports/ folder next to the exe -- open fax_report.html in a browser and print it for HR.

Building the Windows Executable

On a Windows machine with Python 3.10+ installed:

build_windows.bat

This produces dist/AutoFax.exe -- a single self-contained file you can copy to a flash drive.

Sinch Account Setup

  1. Sign up at dashboard.sinch.com
  2. Go to Settings > Access Keys and create a key pair
  3. Note your Project ID (shown at the top of the dashboard)
  4. Configure:
cp .env.example .env
# Edit .env with your Sinch credentials and the destination fax number

Test for free: Use +19898989898 as the destination number to simulate fax delivery without charges.

Linux/Server Setup (CLI + cron)

1. Add Your Claim

Place your claim PDF in the claims/ directory:

cp /path/to/your/claim.pdf claims/

2. Install & Start

chmod +x install.sh
./install.sh

This will:

  • Create a Python virtual environment
  • Install dependencies
  • Set up an hourly cron job
  • Stop automatically after 3 successful deliveries

3. Manual Test

venv/bin/python autofax.py

Reports

After each fax attempt, a printable HTML report is generated at reports/fax_report.html. Open it in a browser and print to PDF for HR. It includes:

  • Timestamp of every attempt
  • Delivery status (DELIVERED, FAILED, QUEUED)
  • Confirmation IDs
  • Error details for failures

Notifications

Optional push notifications via ntfy. Configure in .env (CLI) or in the GUI settings.

Uninstall (CLI)

./uninstall.sh

Cost

Sinch pricing: $0.045/page flat rate, no monthly commitment. 30 faxes x 5 pages = 150 pages = ~$7 total.