CashPilot-Desktop

command module
v0.20.3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 26, 2026 License: GPL-3.0 Imports: 43 Imported by: 0

README

CashPilot Desktop

Release Downloads Stars License


What is CashPilot Desktop?

CashPilot Desktop is a local-first, cross-platform desktop application for deploying and monitoring passive-income and DePIN services. Instead of running CashPilot as a Docker container and accessing it via browser, CashPilot Desktop bundles everything into a single installable app with system tray integration and a guided setup wizard.

It can run in two modes:

  • CashPilot mode -- Full dashboard with service management, earnings tracking, container deployment, and fleet orchestration
  • Worker Node mode -- Lightweight agent that connects to an existing CashPilot instance to run services on this machine

Built with Wails (Go + vanilla TypeScript) for a lightweight, cross-platform experience with native performance.

Features

  • One-click install -- No Docker knowledge required; the app handles container setup for you
  • System tray (macOS) -- Runs quietly in the background with quick-access status and earnings summary; menu-bar icon is macOS-only today (Windows/Linux planned)
  • Real-time monitoring -- Live earnings, service health, container stats, and node uptime
  • Multi-node fleet -- Aggregate view across your entire CashPilot fleet from a single window
  • Auto-updater -- Planned (not yet implemented)
  • Guided setup wizard -- Step-by-step onboarding with Docker detection and installation guidance
  • Cross-platform -- Native builds for macOS (ARM64), Windows (x64), and Linux (x64)
  • Lightweight -- Minimal resource usage thanks to native Go backend with webview frontend
  • Secure -- Credentials encrypted at rest with AES-256-GCM; master key in the OS keychain. Signed/notarized installers are planned.

Installation

Download the latest release for your platform:

Platform Format Download Notes
macOS (Apple Silicon) .dmg Download Unsigned (right-click → Open to bypass Gatekeeper)
Windows (x64) .exe (NSIS) Download Unsigned unless a signing cert is configured in CI
Linux (Debian/Ubuntu) .deb Download Raw binary (.deb packaging planned)

System Requirements

Requirement Minimum
Docker Docker Desktop (macOS/Windows) or Docker Engine / Podman (Linux)
RAM 4 GB (8 GB recommended for multiple services)
Disk 2 GB free (more for service containers)
Network Residential IP recommended for most services

Quick Start

  1. Download and install CashPilot Desktop for your platform
  2. Launch the app -- the setup wizard detects Docker/Podman and guides you through installation if needed
  3. Choose your mode -- CashPilot (full dashboard) or Worker Node (connect to existing instance)
  4. If Worker Node -- enter your CashPilot instance address and fleet key
  5. Start earning -- browse the service catalog, deploy containers, and monitor earnings from the system tray

Supported Services

Some catalog links are affiliate/referral links -- see Disclosure.

CashPilot bundles a catalog of 39 active passive-income services across multiple categories (the catalog also carries 11 retired entries, which the app hides and refuses to deploy). A representative selection is shown below.

Before you start: how bandwidth-sharing works

Most services in this catalog are bandwidth-sharing apps (sometimes called proxyware). When you run one, it routes other people's internet traffic out through your home IP address and pays you a share of the fee. That traffic is usually ordinary web browsing -- but you don't choose it or see it, so it's worth understanding the trade before you opt in:

  • Your connection carries the traffic. Requests from these networks look like they come from your IP, so only run this if you're comfortable with that.
  • Check your ISP's terms first. Some ISP contracts prohibit reselling or sharing your connection, which can make bandwidth-sharing a terms-of-service problem even where it is otherwise legal. Read your own agreement before signing up.
  • It's all opt-in. Start with the services you understand and add others only as you're comfortable.

Not every service resells your IP. Compute and storage providers -- Storj (spare disk space) and GPU services like Vast.ai and Salad (spare compute) -- pay for hardware resources, not for routing traffic through your connection. The catalog is a mix, so pick what suits you.

Docker-Deployable Services

Services CashPilot can deploy and manage automatically via Docker containers.

Service Residential IP VPS IP Devices / Acct Devices / IP Payout
Anyone Protocol ✅ ✅ Unlimited Undocumented Crypto (ANYONE)
Bitping ✅ ✅ Unlimited Undocumented Crypto (SOL)
Earn.fm ✅ ✅ Unlimited 1 Crypto
EarnApp ✅ ❌ 15 Undocumented * PayPal, Gift Cards, Wise
Honeygain ✅ ❌ 10 1 PayPal, Crypto
IPRoyal Pawns ✅ ❌ Unlimited 1 PayPal, Crypto, Bank Transfer
MystNodes ✅ ✅ Unlimited Unlimited Crypto (MYST)
PacketStream ✅ ❌ Unlimited Undocumented PayPal
ProxyBase ✅ ✅ Unlimited Undocumented Crypto
ProxyBase Markets ✅ ✅ Unlimited Undocumented Crypto (USDC)
ProxyLite ✅ ✅ Unlimited Undocumented Crypto, PayPal
ProxyRack ✅ ✅ 500 Undocumented PayPal, Crypto
Repocket ✅ ❌ 5 Undocumented PayPal, Crypto
Storj ✅ ✅ Unlimited Undocumented ** Crypto (STORJ)
Traffmonetizer ✅ ✅ *** Unlimited Unlimited Crypto (USDT), PayPal
URnetwork ✅ ✅ Unlimited Undocumented Crypto

Undocumented means the provider publishes no per-IP device limit, not that there is none. Check the provider's terms before running a second instance behind one address. Unlimited is a limit the provider states it does not impose.

* EarnApp's own terms forbid running its software in containers, on virtual machines and on servers, which is exactly how CashPilot deploys it. The stated penalty is a terminated account with any pending payment cancelled. It is listed so the choice is yours, not hidden.

** Storj nodes on the same /24 subnet share data allocation, reducing per-node earnings.

*** Traffmonetizer's Terms of Service require a residential IP; running it on a VPS may not comply with those terms, so check before you deploy.

Browser Extension / Desktop Only

These services have no Docker image. CashPilot lists them in the catalog with signup links and earning estimates.

Service Residential IP VPS IP Devices / Acct Devices / IP Payout Status
Bytebenefit ✅ ❌ Unlimited Undocumented PayPal Active
Bytelixir ✅ ❌ Unlimited 1 Crypto Active
Dawn Internet ✅ ❌ Unlimited 1 Crypto (DAWN) Active
Deeper Network ✅ ❌ Unlimited 1 Crypto (DPR) Active
Ebesucher ✅ ✅ Unlimited 1 PayPal Active
Gradient Network ✅ ❌ Unlimited 1 Crypto (GRADIENT) Active
Grass ✅ ❌ Unlimited 1 Crypto (GRASS) Active
Helium ✅ ❌ Unlimited 1 Crypto (HNT) Active
Nodepay ✅ ❌ Unlimited 1 Crypto (NC) Active
Nodle ✅ ✅ Unlimited 1 Crypto (NODL) Active
PassiveApp ✅ ❌ Unlimited 1 Crypto, PayPal Active
Sentinel dVPN ✅ ✅ Unlimited 1 Crypto (DVPN) Active
Spide ✅ ❌ Unlimited 1 Crypto Active
Teneo Protocol ✅ ❌ Unlimited 1 Crypto (TENEO) Active
Theta Edge Node ✅ ✅ Unlimited 1 Crypto (TFUEL) Active
Titan Network ✅ ❌ Unlimited 1 Crypto (TNT) Active
Uprock ✅ ❌ Unlimited 1 Crypto Active

GPU Compute

GPU-intensive computing services. Requires compatible hardware.

Service Residential IP GPU Required Min Storage Payout Status
Flux ✅ ❌ 220GB Crypto (FLUX) Active
Golem Network ✅ ❌ 20GB Crypto (GLM) Active
io.net ✅ ✅ N/A Crypto (IO) Active
Nosana ✅ ✅ 50GB Crypto (NOS) Active
Salad ✅ ✅ N/A PayPal, Gift Cards Active
Vast.ai ✅ ✅ 100GB Crypto, Bank Transfer Active

Note: Earnings vary widely by location, hardware, and demand.

CashPilot Desktop vs Web

Feature Desktop App Web (Docker)
Installation One-click installer docker compose up -d
Docker management Built-in (auto-detects, guides install) Requires Docker pre-installed
System tray integration macOS only No
Auto-updates Planned Manual image pull
Background operation Native OS service Container must stay running
Fleet management Yes Yes
Earnings dashboard Yes Yes
Target audience End users, non-technical Self-hosters, sysadmins
Resource usage ~80 MB RAM ~80 MB RAM (container only)

Architecture

CashPilot Desktop (Wails 2.x)
├── Go Backend (app.go, internal/)
│   ├── Container runtime    — Docker/Podman detection, deploy/stop/restart
│   ├── Earnings collectors  — Polls service APIs for earnings
│   ├── internal/exchange    — FX rates (crypto + fiat → display currency)
│   ├── Fleet management     — Multi-node coordination via HTTP
│   ├── fleet_server.go      — Token-auth worker/mobile heartbeat API
│   └── SQLite database      — Config, credentials (OS keychain), earnings history
├── Frontend (vanilla TypeScript + Vite)
│   ├── Dashboard            — Real-time earnings and service status
│   ├── Setup wizard         — Onboarding flow with runtime detection
│   ├── Service catalog      — Browse and deploy services
│   ├── Settings             — Display currency and preferences
│   └── Fleet                — Connected worker/node status
└── Wails Runtime            — Window management, system tray, native bindings

The Go backend handles all business logic, container orchestration, and data collection. The TypeScript frontend communicates via Wails bindings (direct Go function calls, no HTTP). State is persisted in a local SQLite database, with credentials encrypted at rest (AES-256-GCM) under a master key held in the OS keychain.

Development

Prerequisites

Dev Workflow

wails dev              # Hot-reload dev mode (Go + TypeScript)
go test -race ./...    # Run Go tests

Build from Source

git clone https://github.com/GeiserX/CashPilot-Desktop.git
cd CashPilot-Desktop
wails build

Running Tests

make test

FAQ

How is this different from the CashPilot Docker container?

It's the same passive-income management system, but packaged as a desktop app instead of a Docker container. You get system tray integration, auto-updates, a guided Docker installation wizard, and a native window -- no need to manage Docker yourself or access a web UI via browser.

Do I still need Docker installed?

Yes. CashPilot Desktop manages Docker containers for you, but Docker (or Podman) must be installed. The setup wizard detects if a compatible runtime is missing and guides you through installing Docker Desktop (macOS/Windows) or Docker Engine (Linux).

How much can I earn?

Honestly, this is beer money, not a salary. Earnings vary widely based on location, ISP, number of devices, and which services you run, but as a rough guide:

  • A single home connection running a stack of bandwidth apps typically earns around $5-25/month.
  • A well-equipped household that also shares spare storage or GPU time might reach $30-75/month.
  • Hundreds a month is possible, but it takes a real fleet of machines, capable GPUs, or speculative token rewards -- not a single home connection.

Two things keep expectations realistic. Stacking many bandwidth apps on one connection hits diminishing returns, because they compete to sell the same idle bandwidth. And DePIN token rewards are speculative -- their value can drop sharply, so treat crypto payouts as a bet rather than a guarantee. The steadier earners are bandwidth, storage, and GPU compute. The dashboard tracks your actual earnings over time so you can see what works for your setup.

Is it safe?

All service containers run isolated via Docker. Credentials are stored in the OS keychain (macOS Keychain, Windows Credential Manager, Linux Secret Service). The app communicates only with localhost and the services you choose to deploy. No telemetry, no analytics, no data leaves your machine unless a service requires it.

What happens if the app crashes?

Docker containers continue running independently -- they don't stop when CashPilot Desktop is closed. Reopening the app reconnects to your running containers and resumes monitoring.

Can I run CashPilot Desktop on multiple machines?

Yes. Use Worker Node mode on additional machines -- they connect to your main CashPilot instance (either Desktop or Docker) and appear in the fleet dashboard. Each worker runs its own set of services and reports status back.

Disclosure

This project's service catalog may contain affiliate/referral links. If you sign up through them, the project maintainer may earn a small commission at no extra cost to you. This helps support development.

Ecosystem

Project Type Description
CashPilot Backend Multi-service passive income aggregator and fleet manager
CashPilot-android Android Agent Monitoring agent for passive income apps on Android
cashpilot-mcp MCP Server Monitor earnings from AI assistants via Model Context Protocol
cashpilot-ha Home Assistant Earnings and service status sensors for your smart home
n8n-nodes-cashpilot n8n Node Automate earnings workflows in n8n

License

GPL-3.0 -- Sergio Fernandez, 2026

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
cmd
catalogsync command
Command catalogsync vendors the CashPilot web catalog (services/**.yml) into this repository and, in -check mode, reports when the vendored copy has drifted from it.
Command catalogsync vendors the CashPilot web catalog (services/**.yml) into this repository and, in -check mode, reports when the vendored copy has drifted from it.
e2e
harness
Package harness holds the fakes the end-to-end tests drive the real app against: a stateful Docker Engine API, canned earning providers and a canned exchange-rate feed.
Package harness holds the fakes the end-to-end tests drive the real app against: a stateful Docker Engine API, canned earning providers and a canned exchange-rate feed.
internal
bgservice
Package bgservice registers the CashPilot executable with the current user's OS service manager so its headless --daemon supervisor auto-starts at login, restarts on crash, and survives the GUI being closed and a reboot — Docker-parity native supervision with no admin (see docs/NATIVE-SUPERVISION.md, Phase B).
Package bgservice registers the CashPilot executable with the current user's OS service manager so its headless --daemon supervisor auto-starts at login, restarts on crash, and survives the GUI being closed and a reboot — Docker-parity native supervision with no admin (see docs/NATIVE-SUPERVISION.md, Phase B).
catalogsync
Package catalogsync vendors the CashPilot web catalog into this repository and applies the small set of Desktop-only deltas declared in catalog-overlay/.
Package catalogsync vendors the CashPilot web catalog into this repository and applies the small set of Desktop-only deltas declared in catalog-overlay/.
compose
Package compose writes a docker-compose.yml for CashPilot services.
Package compose writes a docker-compose.yml for CashPilot services.
exchange
Package exchange converts service-earnings amounts between currencies for the CashPilot Desktop dashboard.
Package exchange converts service-earnings amounts between currencies for the CashPilot Desktop dashboard.
fleetnet
Package fleetnet validates the URL of a remote CashPilot worker before the desktop (master) makes an authenticated request to it.
Package fleetnet validates the URL of a remote CashPilot worker before the desktop (master) makes an authenticated request to it.
health
Package health answers a question the container runtime cannot: is this service actually EARNING, as distinct from merely running?
Package health answers a question the container runtime cannot: is this service actually EARNING, as distinct from merely running?
preflight
Package preflight answers one question before a deploy runs: what, on THIS machine, will stop this service earning?
Package preflight answers one question before a deploy runs: what, on THIS machine, will stop this service earning?
upstream
Package upstream lets this Desktop optionally report to a CashPilot server as a worker.
Package upstream lets this Desktop optionally report to a CashPilot server as a worker.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL