Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.darkbloom.dev/llms.txt

Use this file to discover all available pages before exploring further.

The Darkbloom macOS app lives in your menu bar and gives you a native interface for managing your provider without touching the terminal. It wraps the same darkbloom CLI under the hood, so everything you can do in the app you can also do from the command line — the two are fully equivalent.

​
Features

One-click start and stop

Start or stop your provider from the menu bar with a single click. No need to open a terminal.

Real-time throughput

See tokens per second and active request counts update live as your Mac serves inference requests.

Idle detection

The app monitors whether you are actively using your Mac. When it detects activity, it pauses the provider so inference does not compete with your own work. Serving resumes automatically when the Mac goes idle again.

Provider scheduling

Set specific hours and days when your Mac should serve. Outside those windows, the provider disconnects and the backend shuts down to free GPU memory.

Earnings dashboard

View your balance and recent earnings history without leaving the app.

Auto-start at login

Optionally start the provider automatically when you log in to your Mac, so your machine earns whenever it is on and idle.

​
Accessing settings

Click the Darkbloom icon in the menu bar to open the status panel. From there, click Settings to access the full configuration view, where you can:
  • Choose which model to serve
  • Configure scheduling windows
  • Enable or disable auto-start at login
  • Enable or disable automatic updates

​
Idle detection

Idle detection watches for keyboard, mouse, and other user activity signals from macOS. When you start using your Mac — opening applications, typing, moving the mouse — the provider pauses so the GPU is available for your own work. When your Mac goes idle again, the provider resumes automatically. This happens transparently. You do not need to manually stop and start the provider around your work sessions.
Idle detection is separate from scheduling. Scheduling defines fixed time windows when the provider is allowed to run. Idle detection operates within those windows and further pauses serving when you are actively using the machine.

​
Earnings display

The menu bar panel shows your current balance and a summary of recent earnings. For a full breakdown with per-request detail and withdrawal options, use the web console at darkbloom.dev or run darkbloom earnings in the terminal.

​
Setup wizard

When you launch the app for the first time, a setup wizard walks you through:
  1. Detecting your hardware
  2. Downloading a model matched to your machine’s memory
  3. Linking your Darkbloom account
  4. Starting the provider
If you have already installed and configured the provider via the CLI, the app connects to the existing configuration and launchd service automatically.