Carely User Manual

1 What you downloaded

You downloaded Carely.zip. Carely installs itself the first time you run it — it builds its own private environment, installs what it needs, and adds a Carely icon to your Desktop. After that, you just use the Desktop icon.

There is nothing to configure: no API keys, no servers. It only needs an internet connection.

First, extract the zip

• Windows: right-click Carely.zip → Extract All… → choose a folder (e.g. your Desktop).
• Linux / Raspberry Pi: right-click → Extract Here, or in a terminal: unzip Carely.zip

2 Windows

1. Open the extracted Carely folder.
2. Right-click Start-Windows.bat → Run as administrator. It will also ask for administrator itself — click Yes. (This is only needed once, so Windows doesn't block the freshly downloaded files.)
3. Let it finish — it shows "✓ All checks passed" and creates a Carely icon on your Desktop.
4. From now on, just double-click the Carely icon on your Desktop.

3 Linux & Raspberry Pi

Easiest — double-click the launcher

1. In the extracted folder, double-click Carely.desktop.
2. If asked, choose Execute (or Execute in Terminal).

Or — from a terminal

1. Open the extracted folder, then open a terminal there.
2. Run: bash Start-Linux-macOS.sh
3. The first run asks for your password once (sudo) to install the audio and window libraries. This is normal.

When it finishes it creates a Carely icon on your Desktop — use that from then on.

Raspberry Pi — lighter on-screen companion (one-time)

The Raspberry Pi has a smaller graphics chip, so tell Carely to render its on-screen companion lighter. It's the same companion — only the rendering is lighter, so it stays smooth on the Pi.

1. In the extracted Carely folder, open a terminal.
2. Run this once: echo 1.0 > render_q.txt
3. Then start Carely as usual (Carely.desktop, or bash Start-Linux-macOS.sh).

If the window won't open or there's no sound

• Audio/mic: sudo apt install portaudio19-dev
• No window: make sure Chromium is installed — sudo apt install chromium-browser. Carely shows its screen in a full-screen Chromium window, and plays sound through it.

Then run the setup again.

4 macOS

Open Terminal, drag the Carely folder into it to move there, then run bash Start-Linux-macOS.sh. If it complains about audio, run brew install portaudio and try again.

5 Requirements & updating

• Python 3.11 or newer. On Windows the setup opens the download page automatically if it's missing.
• Internet connection (voice + cloud data).

When a new version is available, Carely tells you inside the app with a download link. To update: download the new Carely.zip, delete the old folder, and run the setup once. Nothing to migrate — your account and data live in the cloud.

6 Caregiver web portal

The desktop app is for the patient. As a family member or caregiver you don't install anything — you use the Caregiver Web Portal in your browser, on any phone, tablet, or computer.

1. Open the portal from the Get Started page — or open it directly and bookmark it.
2. Sign in with the same account the patient's app uses.
3. From there you can read AI conversation reports, manage medication reminders and contacts, update the patient's profile, and send a one-tap emergency alert.