Claero is a desktop medical billing advocate for patients navigating US healthcare bills, EOBs, denials, prior authorizations, and insurance plan rules.

This workspace currently contains:

• ClaeroElectron/ — the runnable desktop application
• ClaeroLanding/ — a lightweight marketing site for the project
• claero-doc-pack/ — product, UX, and architecture docs

The original product docs describe a Tauri-based architecture, but the runnable app in this repository is currently the Electron implementation in ClaeroElectron/.

• bun 1.1+
• Node.js 20+ if you prefer npm for auxiliary tooling
• macOS is the most realistic environment for the current desktop integrations
• Optional accounts / credentials:
  • OpenAI API key
  • Perplexity API key
  • Gmail OAuth client
  • IMAP mailbox credentials
  • Ollama for local inference

.
├── ClaeroElectron/   # Desktop app
├── ClaeroLanding/    # Marketing / landing page
├── claero-doc-pack/  # Product and architecture docs
└── README.md

cd ClaeroElectron
bun install

Copy the example file and fill in only the providers you want to use:

cp example.env .env

The app supports three AI paths:

• CLAERO_OPENAI_API_KEY for OpenAI mode
• CLAERO_PERPLEXITY_API_KEY for Perplexity / Sonar-assisted mode
• CLAERO_OLLAMA_BASE_URL + CLAERO_OLLAMA_MODEL for local inference

Optional integrations:

• Gmail OAuth:
  • CLAERO_GMAIL_CLIENT_ID
  • CLAERO_GMAIL_CLIENT_SECRET
• IMAP:
  • CLAERO_IMAP_HOST
  • CLAERO_IMAP_PORT
  • CLAERO_IMAP_USERNAME
  • CLAERO_IMAP_PASSWORD
  • CLAERO_IMAP_TLS

bun run dev

Useful alternatives:

bun run dev:web
bun run build
bun run build:electron

cd ClaeroLanding
bun install

bun run dev

bun run build

Claero is designed around a local-first workflow:

• the desktop app runs on your own machine
• local inference can run through Ollama
• email, calendar, and plan documents stay close to the user

That makes it possible to run a privacy-conscious setup without relying entirely on a centralized cloud backend.

Before making substantial product or UI changes, read:

• claero-doc-pack/README.md
• claero-doc-pack/CLAUDE.md
• claero-doc-pack/docs/product-overview.md
• claero-doc-pack/docs/ui-style-spec.md