Start Here
Set Up on Windows
Install Actual from PowerShell and verify the Windows client path
Actual publishes Windows x86_64 clients for NVIDIA CUDA and AMD ROCm. You need the corresponding GPU driver and runtime, an Actual account for online use, and PowerShell. Windows ARM64 is not supported by these builds.
Install from Computers#
- Sign in and open Computers.
- Choose Add lead computer, or select a cluster and choose Add child computer.
- Copy the Windows command.
- Paste it into PowerShell and run it within 10 minutes.
- Wait for installation and authorization, then open a fresh PowerShell window.
Use the exact generated command, including its credential and any channel already present. The install form does not guarantee a visible release-channel chooser.
Verify and start#
Get-Command actual
actual --version
actual whoami
actual
actual status
The installer places the client under your user profile and updates PATH. If the refreshed shell still cannot resolve it, try the generic CLI installation path:
& "$HOME\.actual\bin\actual.exe" --version
Check the version and account, then confirm the computer appears online in Computers. Installation does not guarantee the daemon has started; run actual explicitly.
Install a model#
Follow Model Discovery to download a model. Wait for installation before running actual models load. An empty picker means there may be no installed models.
Use actual status to verify the model is loaded before opening Chat or using an external application.
Troubleshooting#
If the computer never appears online, run actual login, open the exact device URL it prints, and sign in to the same account as the browser. A valid pending code authorizes automatically; an expired code needs a fresh login attempt.
If a model fails to load, check the GPU driver, CUDA or ROCm runtime, available memory, and actual logs --tail 100 --once. Reinstalling the CLI does not replace a missing GPU runtime.
See Machine Installation for startup options and Logs & Telemetry for diagnostic files.