Getting started
CloudBridge reads your cloud and model-provider bills into one ledger on your machine — from a billing API, or from the export you downloaded — and draws the trends. There is no sign-up, no sync and no telemetry. This page takes you from download to your first bill.
1. Install
Download the latest build from the Releases page:
| Platform | File |
|---|---|
| macOS (Apple silicon) | cloudbridge-macos-arm64.dmg |
| Windows (x64) | cloudbridge-windows-x64.exe |
macOS. Open the .dmg, drag CloudBridge to Applications and launch it from there. Releases are Developer ID signed and notarized, so they open without a workaround. If macOS blocks a current release, report the exact warning and your macOS version; do not remove quarantine protection as a routine installation step.
Windows. The .exe is not code-signed, so SmartScreen will likely stop it with Windows protected your PC. Check that the file came from the official Releases page, then click More info and Run anyway. Windows remembers the choice for that file; a new release asks again.
Linux and Intel Mac binaries are not published. Building from source needs Rust 1.95 or newer — see the development setup:
git clone https://github.com/JetSquirrel/cloudbridge.git
cd cloudbridge
cargo run --release2. Look around first, if you like
The browser demo runs the same pages on a sample bill. It keeps no credentials and reaches no provider, so importing, refreshing from a billing API and the SQL console are desktop-only.
In the app, an empty Overview offers Load demo data, or open Settings → Demo data. Demo accounts carry no credentials and are skipped by refreshes; Clear demo data on the same page removes them.
3. Add an account
Open Accounts, click Add account, pick the source and enter a name.
| Source | How the bill arrives | What it needs |
|---|---|---|
| Amazon Web Services | Billing API | Access Key ID + Secret — AWS |
| Alibaba Cloud | Billing API, or a bill export | AccessKey ID + Secret — Alibaba Cloud |
| Cloudflare | Billing API | Account ID + API token — Cloudflare |
| DeepSeek | Balance API, or a bill export | API key — DeepSeek |
| Volcengine (火山引擎) | Bill export | Nothing |
| OpenAI | Bill export | Nothing |
| Anthropic (Claude) | Bill export | Nothing |
Click Save. An API source fetches this month's and last month's bill straight away, so a wrong key shows up as that fetch failing.
4. Get the bill in
- An API source fetched its bill when you saved it. Refresh on the Overview fetches again once the refresh interval has passed.
- A file source — Volcengine, OpenAI, Anthropic, or Alibaba Cloud and DeepSeek when you want finer detail — needs its export: download it from the provider's console and click Import on the account's row. See Bill file import.
5. Read it
The Overview shows the window you pick: MTD, 30d or 12m. Choose USD or CNY under Settings → Reporting. From there:
- Overview and accounts explains the numbers.
- Alerts, rules and budgets tells you when spend jumps.
- Menu bar and background keeps that running with the window closed.
Something not showing up? See Troubleshooting.