SARAS COMPANION HELP
SARAS Windows Companion: every button and setup step explained
Updated 11 November 2026. This guide describes the new separate-page Companion interface in the dev.11 release. Earlier versions can have older labels and the confusing hidden AI fields. Use the current Windows download page to check your installed version.
Start in five steps
- Install SARAS and open its version-labeled Desktop or Start menu shortcut.
- Open Devices. Create a QR/code, sign in on your phone at SARAS Mobile, and approve matching codes on both sides.
- Open Security and allow only the Windows controls you want.
- Open Settings → AI connection on this laptop. Choose provider, paste key, load/select a model, save and test.
- Start account connection. On mobile, open My Devices → Control laptop. Keep the laptop awake and online.
Where do I enter my SARAS AI API key?
In the Windows Companion, open Settings → AI connection on this laptop. Select the matching provider, paste its key, click Load available models, choose a model and Save & activate AI. Then Test selected AI. Keys are stored encrypted on your Windows account and are not entered into the public download website. The paired phone uses your laptop’s configured AI connection.
Use one Gemini key for chat and voice
Save a Gemini key and chat model in Settings → AI connection. The Gemini voice panel reuses the same encrypted key, even if you later activate another saved chat provider. Sync speech models and voices, select them separately, allow speech text sharing and Save voice choice. Generate a voice test and press Play; use your own-language sample to assess pronunciation. Your paired phone can use that configured voice through the laptop while mobile voice permission is enabled. Existing Windows voices remain available when Gemini voice is disabled.
Chat and speech use different model capabilities. Listing a model does not guarantee quota or successful generation. No real Gemini key was included or used for release tests; account-specific access, latency and pronunciation must be tested by you. Gemini does not provide exact lip timing in this integration. The current Google speech-generation documentation describes model and language support; Urdu and Saraiki quality is not guaranteed here.
What is the App password field for?
The App password belongs to the older local/private controller mode and stays under Advanced. It is not Google’s password or the mobile SARAS app PIN. Normal online account pairing does not require it. Do not reset it just to configure AI. Resetting it can sign out affected local sessions.
What do the sidebar pages do?
Home gives a connection overview. Devices handles pairing and connection. Security handles local permissions. Activity shows status, approvals and logs. Settings contains AI, shared folder, startup and updates. The selected page is highlighted; loading, success and error messages are shown beside the relevant action.
Full button and field reference
| Button or field | Purpose, requirements and next step |
|---|---|
| Home | Connection overview and shortcuts to Devices, Security, Activity and Settings. |
| Devices | Pairing and account connection. This is the normal online phone connection page. |
| Security | Choose what your paired phone may do on this laptop. |
| Activity | Current connection status, errors, approvals and execution/service log. |
| Settings | Visible laptop AI settings, shared folder, startup, updates and advanced local/private settings. |
| This is my laptop | Local ownership consent. Only tick if you requested this connection on a laptop you are allowed to control. |
| Show QR / generate new code | Creates a short-lived QR and code. Open the signed-in mobile app, choose Scan laptop QR, then compare and approve on both devices. |
| Connect using phone code | Enter a fresh eight-digit code generated on your signed-in phone. This is the manual alternative to QR. |
| Approve this account | Compare the displayed confirmation code with the phone and approve the requesting account. It is not an app password. |
| Start account connection | Starts the outbound authenticated bridge after approved pairing. Paired alone does not mean online. |
| Start connection after approval | Automatically starts the approved account connection. It does not grant extra keyboard, power or voice permissions. |
| AI provider | Select Groq, Gemini or OpenRouter to match the API key you own. |
| API key | Paste the provider key privately on the laptop. Leave blank to retain that same provider’s saved key. Never paste a Google password here. |
| Load available models | Contacts the selected provider and lists available model IDs. Availability does not guarantee free quota or access to every model. |
| Model | Select a model returned by your provider. Old or misspelled IDs can produce a 404 response. |
| Save & activate AI | After encrypted-saving consent, saves provider/key/model with Windows protected storage on this Windows account. This is independent of account pairing. |
| Test selected AI | Sends a short test to that selected provider/model. Success proves that test request worked, not that every AI feature or future request is guaranteed. |
| Shared folder | Limits approved file actions to the chosen folder. Choose a specific folder you are allowed to share. |
| Browse folders | Opens the Windows folder picker. If the picker is behind the app, use Alt+Tab; you may also paste a folder path. |
| Save shared folder | Requires an existing connection and stopped PC access. Saves the new allowed folder; restart account connection when ready. |
| Power permission | Allows approved shutdown/restart and radio controls under the existing safeguards. Wi-Fi off may disconnect the laptop; shutdown/restart has a cancellation window. |
| Desktop input permission | Allows reviewed mouse/keyboard actions in the intended foreground window. Sensitive actions still require approval. Top-left pointer stop remains available. |
| Mobile voice permission | Allows approved speech text from mobile to be spoken on the laptop and generated audio returned to mobile. It is not continuous background phone microphone access. |
| Apply laptop permissions | Saves power, keyboard/mouse and mobile-voice choices while retaining pairing. |
| Open SARAS app | Opens the configured online mobile controller for a public account connection. It does not itself start a stopped laptop bridge. |
| Start companion | Starts the saved connection. For paired public accounts it reuses the saved account device credential. |
| STOP PC access | Stops PC actions locally. Use this before changing shared folders, switching connections or applying updates. |
| Close SARAS services | Closes owned SARAS services. To reopen, use the version-labeled Desktop or Start menu shortcut; reinstalling is not necessary. |
| Cancel shutdown | Cancels a pending SARAS shutdown/restart countdown where Windows still permits cancellation. |
| Approve / Reject local action | Handles a pending local review. Inspect the exact action and arguments first. This is separate from pairing approval. |
| Start when I sign in to Windows | Enables startup for the configured companion. The PC must still be awake and connected for remote control. |
| Disable automatic startup | Removes SARAS’s own startup entry. It does not uninstall the app. |
| Check signed update | Checks the pinned update feed and verifies the owner’s update signature. This signature is different from a Microsoft Windows publisher certificate. |
| Download verified update | Downloads and validates the offered update. It does not immediately replace the running version. |
| Install downloaded update | Requires stopped PC access and approval. After applying, close and reopen SARAS. Keep recovery options available. |
| Restore previous installed version | Selects the previous installed release after confirmation. It is recovery for an existing retained release, not a download of any arbitrary old version. |
| Advanced local/private connection | Preserves the earlier private/local controller mode. New public users should use Devices account pairing instead. |
| Server address | Advanced controller destination. Public account pairing uses https://saras.farhanbalouch.com; do not replace it with a random preview or localhost to fix account pairing. |
| App password | Protects the earlier local/private controller login. It is not your Google password, API key or mobile SARAS PIN. Normal account pairing does not require entering it. |
| Reset local app password | Changes only the local/private password; preserves chats and signs out affected local sessions. It does not reset Google login or the online mobile PIN. |
| Vercel Preview automation token | Developer-only access for an explicitly protected preview. Public users normally do not need it. It is not an AI provider API key. |
| Save, test & connect | Advanced legacy local/private configuration action. The normal online account flow uses Devices and Start account connection instead. |
| Pair with QR — local preview / Connect my laptop | Earlier private/local pairing actions. Use the upper Devices account QR/code flow for the online public controller. |
Understand the status before trying again
- Paired, offline: account ownership is saved, but the Companion bridge is not online. Start account connection and inspect Activity. Do not repeatedly create new pairings.
- Online, access disabled: the laptop is reachable but PC actions are not authorized/enabled.
- Loading: wait for a final status; a request being received does not prove completion.
- Stop current PC access: use STOP PC access before switching connections, changing shared folders or applying an update.
- Model 404: check provider and current model ID with Load available models; test that provider. Quota, billing and provider outages are separate errors.
- Wrong or expired QR/code: generate a fresh code and approve the matching request. Do not reuse old codes.
- PIN on every internal page: refresh/apply the current PWA update. Internal Control laptop/My Devices navigation should retain unlock; leaving the app locks it.
- Missing shortcut: use the latest installer’s Desktop shortcut option. New shortcuts include the full development version. Closing the app is not a reason to reinstall every time.
Which features need internet or an AI key?
The online phone controller needs internet on both devices and a running Companion. Manual supported Windows actions do not require an AI key. General AI chat and ambiguous natural-language planning require a valid provider/model/quota. Installed Windows voices and bundled local recognition can work locally; browser recognition, web research, weather and provider services can require internet. An installed PWA opening offline does not mean it can remotely control an offline PC.
Permissions and privacy
Share only your chosen folder and approve sensitive actions. Do not share API keys, app passwords or pairing codes with others. Disconnect, Block and Remove in the mobile dashboard revoke device access; removing a list entry does not uninstall the Windows app. The current installer is unsigned and Windows may show a publisher warning. A guide or matching checksum is not a Microsoft safety certification.
Download SARAS · Installation guide · Version history · Supported action catalog