Jarvis
User GuidemacOS · Apple Silicon
JARVIS
Just A Rather Very Intelligent System
User Guide
A voice assistant for Mac with its own neural network.
Folders, movies, mail and documents — in a single sentence.
Mac · Apple SiliconРусский · EnglishWorks offline
jarvisapp.techOctober 2026
Jarvis · User GuideContents

Contents

What this guide is about

Jarvis lives on your Mac and does everything himself: finds and opens files, plays movies, reads mail and documents, and answers out loud. This guide explains how to install and set him up, how to connect an external AI, and how to talk to him.

Jarvis, open downloads — this is how spoken phrases are marked; you can change the words, Jarvis understands natural speech. ⌘D — keys. Yellow numbered circles on screenshots refer to the list under the picture.

jarvisapp.tech
Jarvis · User Guide01 · What Jarvis is

Section 01

What Jarvis is

It is a shell for your Mac in the spirit of Jarvis from “Iron Man”: a golden sphere in the centre, with the clock, weather, mail and folders around it — all run by a live voice assistant. He hears, thinks and speaks right on your computer, with no internet.

Hearing

Understands speech on the Mac

Speech recognition runs on the computer itself. Jarvis answers only to his name and never mistakes a movie soundtrack for a command.

Brain

His own neural network — or any external one

The own Gemma model is fine-tuned on real Jarvis commands and thinks in about a second and a half. If you prefer — ChatGPT, Claude, Gemini, DeepSeek or Alice.

Voice

Answers in a living voice

The neural voice Karen: a brisk business-like pace, no robotic intonation. Answers are short and to the point, one to three sentences.

Hands

Does everything himself

Folders, movies, mail, documents, the browser. Anything that changes or deletes files — only after your “yes”.

The main screen. Jarvis has just said hello: “Good afternoon, sir! What a nice day — nobody bothered you today, no new mail.” The widgets orbit the sphere.

Two rules that are never broken. Jarvis copies, moves, renames and deletes only with your consent — and first says what and where. Deleting means the Trash only: there is no permanent deletion in the program at all.
jarvisapp.tech
Jarvis · User Guide02 · Installation

Section 02

Installation

What you need

RequirementDetails
A Mac with an Apple processorM1 or newer. Jarvis does not run on Intel Macs.
Memory24 GB or more recommended. With the own AI, the brain, hearing, voice and the 3D scene live in memory at the same time — about 19 GB when idle. If an external AI thinks (ChatGPT, Claude…), you need about 13 GB less.
Microphone and speakersBuilt-in or a Bluetooth headset. If sound goes to headphones, Jarvis listens through their microphone.
CameraNeeded only for gesture control. An iPhone camera (Continuity Camera) works too.
InternetOptional. Needed for the weather, the browser and external brains, if you choose them.

Two parts: the app and the own AI

Part 1 · ≈ 7.5 GB

The app

The file Jarvis-…-arm64.dmg. Everything except the own AI: Karen’s voice, hearing, graphics, the browser and external brains with your key — ChatGPT, Claude, Gemini, DeepSeek, Alice.

Part 2 · ≈ 11.3 GB

The own AI

The .jarvisai file — Gemma 26B with the Jarvis adapter. Thinks right on the Mac, offline. Install it at once or later; it updates separately from the app.

On the website you choose before downloading: the app without the own AI, the full version (both files), or add the own AI later. One code works for both parts.

How to install

  1. The app. Open the disk image Jarvis.dmg and drag Jarvis into the Applications folder.
  2. First launch — with the right mouse button. The app is signed locally, without a developer certificate, so the first time macOS will not open it with a double click. Right-click the icon → “Open” → “Open”. After that it opens as usual.
  3. Allow access. macOS will ask about the microphone and speech recognition — without them Jarvis cannot hear a command. The camera is needed the first time you turn on gestures, access to the Mail app — for the mail widget.
  4. Answer the four questions of the first-launch wizard (section 03) — and Jarvis will say hello.
  5. The own AI. Double-click the downloaded .jarvisai file — or drag it into the Jarvis window, or press “Install from file…” in the Brain settings. Jarvis asks “Install the own AI (11.3 GB)?”, shows the progress and offers to think with the own AI. After that the downloaded file is no longer needed — a button in the same window moves it to the Trash.
After an update, permissions are asked again. macOS permissions are tied to the app signature, and it changes with every new build. This is normal: click “Allow” once, and that is it.

Together with Jarvis, a small program “Jarvis — Wake” is placed in your Applications folder — it listens for claps while Jarvis is closed (section 11).

jarvisapp.tech
Jarvis · User Guide03 · First launch

Section 03

First launch

On the first launch Jarvis asks four questions. All of it can be changed later in the settings, in the “About me” section; the “Wizard…” button there opens this wizard again.

The first-launch wizard. The choices are highlighted in gold. For “Mr + surname” a surname field has appeared; at the bottom — how Jarvis will greet you.

1 · Language

Русский or English. Everything switches at once: speech recognition, the voice, commands and help. You can also switch by voice: switch to Russian, then переключись на английский.

2 · Who will use it

A man or a woman. This decides which forms of address the next question offers.

3 · How to address you

For a man: sir (default), Mr + surname or by first name. For a woman: ma’am (default), miss — for a young woman, Mrs + surname — for a married one, or by first name. Just like Jarvis with Tony Stark.

If you pick an option with a surname or a first name, a field appears below: type the surname or the name. The bottom of the wizard shows right away how the greeting will sound: “Good afternoon, Mr Stark!”

4 · Who will do the thinking

Own AI — on this Mac. Gemma runs on the computer: no internet, nothing leaves the machine. Takes about 13 GB of memory. If the own AI is not installed yet, the button says so — “Own AI — not installed”, and until you install it an external AI thinks (section 02).

External — ChatGPT, Claude… The key goes into the settings, “Brain” section. How to get one and where to put it — section 05.

Press “Start” — Jarvis will load, say hello and give a short briefing.
jarvisapp.tech
Jarvis · User Guide03 · First launch

03.1Boot screen and greeting

Every launch starts with the boot screen: the rings spin up, in the lower left corner the node check runs line by line, and the wide bar under the sphere fills as loading goes on. At the top — a greeting for the time of day. Usually this takes 5–10 seconds: that is how long it takes to bring up the brain, hearing and voice.

The J.A.R.V.I.S. boot screen. Lower left — the boot log: file system, speech recognition, voice synthesis, workspace, language model, greeting.

What happens next

  • Intro music — if enabled in the settings: Jarvis’s own theme or your file. It fades as soon as Jarvis starts speaking.
  • The greeting out loud and as a line under the clock: “Good afternoon, sir!..”. The line disappears once the phrase is spoken.
  • The briefing: how much is unread in Mail and messengers (by the badge numbers in the Dock, the contents are not read) and what the weather is.
  • The microphone turns on by itself. Otherwise answering to his name would make no sense. You can see the state on the “Hearing” indicator under the clock.

The program window

Jarvis opens full screen. It is an ordinary macOS program: you can minimise it, switch to another and come back. The window position is remembered.

Quit the program like any other (⌘Q) or by voice: Good night, Jarvis. He will say goodbye and exit. All farewell and wake phrases are in section 11.

Called his name during the briefing? The briefing is skipped — Jarvis listens to you right away.
jarvisapp.tech
Jarvis · User Guide04 · Settings

Section 04

Settings

Opened with the gear button or with ⌘,. At the top — section buttons: About me, Voice, Intro, Hearing, Brain, Screen and graphics, Parental control, Guide, License and Help; a click scrolls straight to the section. Changes apply immediately; “Done” simply closes the window.

The “About me” section. “Mr + surname” is chosen: the row asks for the surname, below — how Jarvis will greet you.

About me

First name or surname. The row tells you what to type: the surname for “Mr + surname” and “Mrs + surname”, the first name for “by first name”. Gender — it decides the list of forms of address. Address: sir, Mr + surname or by first name; for a woman — ma’am, miss, Mrs + surname or by first name. Below the row you see how Jarvis will greet you; while the needed field is empty, the old address stays. “Wizard…” — the first-launch wizard (section 03). Language of commands and answers — Русский or English.

Voice

Assistant voice: Karen (main), Karen-2, Serena, Vivian and the “▶ Check the voice” button. Answer with the voice — untick it, and answers appear only on screen. Answer volume. Manner of speech, measure, pauses and liveliness exist only for some voices: Karen and the other Qwen voices do not have these rows. Speech speed, bass and treble, “▶ Listen” and “Reset voice settings” (section 19).

Intro

Music at login: Jarvis’s theme, your own file, or off; for your own file — which part and how many seconds to play, the volume. Details — section 04.3.

Hearing

Answer to names — comma-separated, the first one is the main. Answer out loud to the name — “Yes, sir?”. Fall asleep after silence — how many seconds to wait for a command without the name (section 11). Lower the movie when I speak. Suppress speaker echo — hears “stop” better while he is talking through the built-in speakers. Wake by claps and sound devices.

Brain

Who thinks — the own AI or an external one (ChatGPT, Claude, Gemini, DeepSeek, Alice, Claude Code), the model, the key and “Check” (section 05). The “Own AI (Gemma 26B)” row — whether it is installed; “Install from file…”. Fine-tuned brain, Notice interesting things in what is open and Personal memory — what Jarvis has learned about you (section 17).

Screen and graphics · Parental control · Guide · License

Main screen, folder view, layout, hidden files, previews, graphics quality (section 04.1), gestures and the camera. Parental control — section 04.2. Guide — open this book inside Jarvis, on the Desktop, save the PDF or open it on the website. License — updates and “Unlink this Mac”; Help — section 24. At the bottom of the window — “Voice commands” and “Download the hand model”.

jarvisapp.tech
Jarvis · User Guide04 · Settings

04.1Graphics: quality, frames and resolution

Jarvis picks the graphics for your computer himself: he looks at the GPU, memory and the monitor’s refresh rate. On a Mac with an Apple processor that is the maximum — 200 % and as many frames as the monitor can show. If the program feels heavy, the graphics can be set by hand.

Settings → graphics. The auto-pick box is ticked, so the fields below show what was chosen and are locked. In the frame — what Jarvis found: the GPU, the monitor’s refresh rate and the result.

The rows in order

Graphics qualityMaximum frame rate · Cinematic (plus depth of field) · Balanced · Performance.
Pick automaticallyOn by default. While the box is ticked, Jarvis decides himself; untick it to choose by hand.
Frames per secondAuto — same as the monitor · 30 · 60 · 120. More frames — smoother, but a higher load on the GPU.
Render scaleThis is the graphics resolution. 100 % — the lightest · 150 % · 200 % — Retina, the sharpest. The window is always full screen anyway.
Save the GPU while the brain thinksWhile the brain prepares an answer, the scene runs at 30 frames: the answer comes sooner. The screen does not freeze.

How Jarvis picks by himself

ComputerQualityScaleFrames
Mac with an Apple processor (M1 and newer)Maximum frame rate200 %same as the monitor — 60 or 120
Discrete graphics cardBalancedby the screen60
Integrated Intel graphics and othersPerformance100 %60

What to choose if it stutters

  1. Untick “Pick graphics automatically”.
  2. Frames per second — 60. Almost as smooth to the eye, and the GPU load is noticeably lower.
  3. Render scale — 150 %. The picture is a touch softer, but lighter. 100 % is the lightest option for older Macs.
  4. Quality — “Balanced” or “Performance” if that did not help.
Changes show at once. No need to restart Jarvis. The load is easy to watch in the “Load” widget on the main screen: the CPU, video and RAM rings.
To restore the defaults — tick “Pick graphics automatically” again. The manual values are kept and come back if you untick it later.
jarvisapp.tech
Jarvis · User Guide04 · Settings

04.2Parental control

If a child uses the computer, turn on parental control. Jarvis will stop opening websites and carrying out requests that are not right for the age, and web search becomes safe. Turning the control off or changing the age takes the parent’s password.

Settings → “Parental control”. The age, the on/off box, the parent’s password and the “Apply” button. Below — what is on right now.

How to turn it on

  1. Open the settings (⌘,) and find the row “Parental control — a child at the computer”.
  2. Choose the age: 6+, 12+ or 16+, and tick the box.
  3. The first time the field is called “Make up a parent password”: enter a password of at least 4 characters.
  4. Press “Apply”. The line “Parental control is on: 12+” appears.

What is closed for each age

Topic6+12+16+
Adult content, gambling and bettingclosedclosedclosed
Drugs, weapons, gore, darknetclosedclosedclosed
Dating sitesclosedclosedopen
Safe search (Yandex, Google, Bing) and YouTube restricted modealways on while the control is on

What it looks like

  • In the built-in browser a closed site does not open: instead there is a notice “closed by parental control”.
  • To a spoken request to find or open such a thing Jarvis replies: “This is closed by parental control” — and names the topic.
  • Other browsers Jarvis will not launch on request, so the control cannot be bypassed through him.
  • Movie and file names are checked by explicit words; Jarvis does not know the age rating of the movie itself.

Change the age or turn it off

Choose another age or untick the box, enter the parent’s password and press “Apply”. Without the password the changes are not saved: “The parent password did not match”. The password is stored on the Mac only in encrypted form.

This controls what Jarvis does, not the whole Mac. A child can open Safari or another program by themselves, bypassing Jarvis. To restrict the whole computer, also turn on “Screen Time” in macOS System Settings.
jarvisapp.tech
Jarvis · User Guide04 · Settings

04.3Intro: music at login

When Jarvis opens — after claps, “Wake up, sleepyhead” or a normal launch — music plays. It yields to the voice: it fades as soon as Jarvis starts speaking, and fades out smoothly at the end. What to play and for how long — in the settings, the “Intro” section.

Settings → “Intro”. Your own file: the part that plays at login is highlighted in gold — from 0:24, 40 seconds out of three minutes.

What to play

Jarvis’s theme — the app’s own tune. Your own file — any song on your Mac: MP3, M4A, AAC, WAV, FLAC, OGG or OPUS. Off — a login without music.

Your own file: which part and how long

  1. Press “Choose a file…” and pick a song. Its sound track appears.
  2. Drag the edges of the gold frame — the start and the end of the part; drag the middle — the whole part moves. You can also type numbers: “from” — which second to start at, “play … s” — how many seconds. The result shows on the right, for example “0:24 — 1:04 · 40 s of 3:00”.
  3. “▶ Clip” — listen to the chosen part; a marker runs along the track. Press again to stop.

The part never goes past the end of the song. If you do not change it, the first 66 seconds play.

Volume

The “Music volume” slider and the ▶ button next to it — hear the intro just as it will sound at login. Volume 0 is the same as “Off”.

jarvisapp.tech
Jarvis · User Guide05 · The brain and external AI models

Section 05

The brain and external AI models

The brain decides what to do with your request: open a folder, find a file, read a letter, answer. By default the own AI — Gemma on this Mac — does the thinking. Instead of it you can connect ChatGPT, Claude, Gemini, DeepSeek, Alice or Claude Code. Whoever thinks — Jarvis does everything himself, and the confirmation rules do not change.

Connecting an external brain — step by step

  1. Get a key on the website of the chosen model (where exactly — the table on the next page). The key is a long string of letters and digits. Copy it whole.
  2. Open the settings (⌘,) and in the row “Brain — who thinks” pick the model from the list. Until there is a key, the name is marked “needs a key”, and the built-in one keeps thinking.
  3. In the “Model” row pick a variant: “smarter” or “faster”. The default one is fine to start with.
  4. Paste the key into the “Key …” field and press “Save”. The field clears and shows “saved ✓”.
  5. Press “Check”. Jarvis asks the model a short question and shows whether it answered and in how many seconds. If all is well, he says: “Working with Claude, sir”.
  6. Press “Done”. From now on the external model thinks. The built-in one is unloaded from memory and frees about 13 GB.

The “Brain” rows in the settings after choosing Claude: the list of brains and the “Check” button, the model, the key field with the “Save” button and a hint where to get the key.

To go back to the own AI — pick “Own AI — Gemma on this Mac” in the same list. The first answer after the switch takes longer: the model is loading again.

How it feels in use

Own AI — Gemma

No internet, free

Fine-tuned on thousands of real Jarvis commands (the “Fine-tuned brain” switch). Thinks for 1.5–5 seconds. It is Gemma 26B, installed as a separate file (section 02).

External — ChatGPT, Claude and others

Smarter in long reasoning

A step takes 7–9 seconds, needs the internet and is billed by the model’s tariff. For everyday commands — folders, movies, volume — there is no difference: short phrases run without the brain at all.

What goes to the external model. The text of your request, a brief description of what is open on the screen, and the excerpts from documents or letters needed for the answer. Speech recognition and the voice stay on the Mac; whole files are never sent. The key is stored encrypted in the macOS Keychain and is never shown back — to replace it, just paste a new one.
jarvisapp.tech
Jarvis · User Guide05 · The brain and external AI models

05.1Where to get a key and which model to choose

BrainWhere to get the keyModels in the listBilling
Claude
Anthropic
console.anthropic.com → sign in → API Keys → “Create Key” → copy.Opus 5.5 — smarter · Sonnet 5.5 — faster · Haiku 4.5 — the fastestBy request volume; the card is linked on the Anthropic website.
Claude CodeNo key needed: works under your Claude Code sign-in on this Mac. If the list says “sign in needed” — in Terminal run claude, enter /login, then “Check”.Sonnet (default) · Opus · HaikuIncluded in the Claude subscription.
ChatGPT
OpenAI
platform.openai.com → API keys → “Create new secret key”.GPT-5 · GPT-5 mini — fasterSeparate from the ChatGPT Plus subscription: it does not cover keys.
Gemini
Google
aistudio.google.com → Get API key.Gemini 2.5 Pro · Gemini 2.5 Flash — fasterThere is a free tier.
DeepSeekplatform.deepseek.com → API keys.DeepSeek V3 · DeepSeek R1 — reasons longerCheaper than the rest.
Alice
YandexGPT
Yandex Cloud console → service account → API key. Besides the key you need the folder ID (starts with b1g…) — the settings have a “Yandex Cloud folder” row for it.YandexGPT Pro · YandexGPT Lite — fasterBy Yandex Cloud tariffs.

If something went wrong

What Jarvis showsWhat it means and what to do
“… — needs a key” in the listThe key is not saved yet. Paste it into the field and press “Save”.
“… not connected yet — the built-in one thinks”The choice is remembered, but there is no key. It starts working as soon as you paste the key.
“The key did not match”The key was not copied whole or was revoked on the website. Create a new one and paste it again.
“… is not responding right now”No internet, the limit or the balance ran out. Check the “Network” widget and your account on the model’s website.
“Claude Code: sign in needed”Terminal → claude → /login → “Check” in the settings.
“Own AI — not installed”The app is installed without the own AI, an external AI thinks with your key. Download the own AI on the website with the same code and double-click the .jarvisai file (section 02).
Only the own AI is affected by the switch “Fine-tuned brain — the adapter trained on Jarvis commands”: external ones do not need it. Everything else — reading documents, notes, mail, movies — works the same with any brain.
Tip. Start with the own AI: it is free and needs no network. Connect an external brain when you need long reasoning or your Mac’s memory is taken by browsers — with an external brain Jarvis is 13 GB lighter.
jarvisapp.tech
Jarvis · User Guide06 · The main screen

Section 06

The main screen

In the centre — the golden sphere with the clock. Around it, widgets drift slowly along a tilted orbit, and along the inner one — the icons of programs running in the background. Everything is alive: the sphere pulses when Jarvis speaks, the far half of the orbit passes behind the sphere.

1 2 3 4 5 6 7 8 9 10 11 12
1The sphere and the clock. The time, under it — the day of the week and the date. The sphere is a living hologram of golden streams.
2Indicators: Hearing · Brain · Voice · Network. A blue dot — all is well, grey — off, red — an error.
3Places. Home, Desktop, Documents, Downloads, Pictures, Music, Movies, Applications. A click opens the folder.
4System. Battery, free disk space, how much memory Jarvis takes and the swap.
5Devices. The Bluetooth headset with its charge, where the sound goes, external drives.
6Load. The input language, the microphone state and three rings: CPU, GPU, memory.
7Mail. The latest letters from the Mail app and the unread count. Read only.
8Network. Whether there is internet and through what: the weather, the browser and the external brain depend on it.
9Weather. Temperature around the clock, feels like, wind, humidity and a hint for the evening.
10Background programs. Hologram icons on the inner orbit: Safari, Mail, Messages… They turn gold under the pointer.
11Navigation. Back, forward, up and the name of the current place — “Main screen” or the folder name.
12Filter and buttons. Search by name (⌘F), new folder (⌘N), microphone (V), gestures (G), settings (⌘,).
jarvisapp.tech
Jarvis · User Guide06 · The main screen

06.1The widgets up close

Weather. The city is detected automatically; ask for another by voice: weather in Kazan tomorrow. Updated from Open-Meteo; if the network fails, it retries after 20 seconds, 1 and 2 minutes.

Mail. Letters come from the Mail app. A click on a letter opens it in a window inside Jarvis; if Mail is closed, iCloud Mail opens instead. Ask: what is in the letter from accounting?

Load. RU/EN — the input language. Next to it — the microphone state: “speaking”, “listening”, “mic off”. Rings: CPU, video, RAM. Spikes to 100% at the moment of an answer are normal.

System. Battery charge, free disk space, memory taken by Jarvis, and the swap. If the swap grows — close heavy programs or switch to an external brain.

Network. A green dot — the internet is there. Files, hearing, voice and the built-in brain work without a network too.

Devices. Connected Bluetooth devices with their charge, the current audio output, external drives. By voice: send the sound to the headphones.

Places. Quick access to the main folders. The same by voice: open documents, and back: main screen or ⌘D.

Buttons at the top. Filter by name, new folder, microphone (lit while Jarvis listens), gestures in front of the camera, settings.

Three views of the main screen

Chosen in the settings, the “Main screen” row. Orbit — the widgets revolve around the sphere (default). Callouts — panels at the sides with golden lines from the sphere. Classic — panels in the corners. The colours are the same everywhere: gold — the frame and the essentials, blue — all is well, red — errors.

jarvisapp.tech
Jarvis · User Guide07 · Folders

Section 07

Folders

A folder opens full screen: its core in the centre, the contents drifting around it along the orbit, and a golden lead running from the ring to every item. To enter a folder: say open downloads, click a place, or double-click a folder. To go back: main screen, the “Home” button or ⌘D.

1 2 3 4 5 6 7 8 9 10 11
1The path. “Home › Downloads”. A click on any link goes there; the arrows — back, forward, up.
2The folder name and its path on disk.
3Summary: how many items, the total size, how many are new today, the largest file. The strip on the right — what appeared over 30 days.
4Breakdown by type: photos, video, archives, folders, spreadsheets… A click on a type keeps only that type.
5“Grid” — switch to the ordinary grid of cards (the “Arc”, “Grid” or “Spiral” layout from the settings).
6The folder core: the name and the number of items. For nested folders the core shows the breakdown arcs and the size.
7A file card: an icon or a preview, the name, size and type. The card comes alive under the pointer.
8The details panel of the selected item: type, size, when modified, what is inside.
9“Open folder” and “Show in Finder”.
10The status line: how many items, folders, what is selected and the frame rate.
11The voice panel: what Jarvis heard and what he answered (section 10).
jarvisapp.tech
Jarvis · User Guide08 · Files

Section 08

Files

The cards behave like in Finder, only prettier. Everything can be done with the mouse, the keyboard or by voice — the result is the same. The simplest way is to tell Jarvis what you need.

A document. The real macOS icon, name, size, type.

Photos and video are shown with a preview of the contents.

A folder: a ring with the item count. Turns gold when you drag onto it.

What you can do

ActionWith the mouse and keysBy voice
SelectClick; ⌘ — add, ⇧ — a range; ⌘A — allselect all pictures · select donald
OpenDouble click or Enteropen the report · open the note in a text editor
Move or copyDrag onto a folder or a place; while dragging ⌥ — copy, ⌘ — movemove this to the desktop · copy the note to archive
Rename · new folder⌘R · ⌘Nrename the note to important · create a folder reports
Compress · unpack · pathRight button — the context menucompress this · unpack the archive · copy the path
To the Trash⌘⌫delete this — only after your “yes”
Find by name⌘F — the filter in the current folderfind the contract on the computer — across the whole Mac
If there are several programs, Jarvis asks which one to open with and remembers the answer for that file type. Photos, video, PDF and text open in a window inside Jarvis (next page).
Smart little things. If a name is taken, the copy gets the name “file copy.txt”. A folder cannot be put inside itself. The progress bar counts bytes, not the number of files.
jarvisapp.tech
Jarvis · User Guide08 · Files

08.1Viewing and hologram windows

Photos, video, music, PDF and text open right here — in a window with a hologram frame. The main window stands in the centre, the others wait as thumbnails along the edges; a click on a thumbnail’s title brings it back to the centre. Windows never overlap and never slide off the screen.

A viewing window. Upper left — the type and name of the file, on the right — minimise, maximise, close. On the main screen one window fits between the widgets, and only the clock hides behind it.

What opens inside

  • Photos — at full size.
  • Video and music — the built-in player with seeking, pause and full screen (section 14).
  • PDF — the built-in viewer.
  • Text — notes, .md, .txt.
  • Letters, web pages, WhatsApp and Telegram — in windows too (section 15).

Window commands

close the windowthe current one
close all windowsall at once
minimise · maximiseor Esc — minimise
biggerenlarge the window
show it hereopen the selected item in a window
show the placesslide out the side panel
Esc minimises, it does not close. One accidental key press should not cost you a movie. To bring the window back — click its thumbnail at the bottom.
jarvisapp.tech
Jarvis · User Guide09 · Mouse, trackpad and keyboard

Section 09

Mouse, trackpad and keyboard

Mouse and trackpad

ActionWhat it does
Hoverthe card comes alive: light runs along the outline, a glint across the preview
Click · double clickselect · open
Dragmove onto a folder, into a place on the left or onto a path link at the top
Wheel · two fingersscroll the rows
Two fingers sideways · pinch on the trackpadrotate the scene · zoom in and out (in the “Grid” view)
Right buttonthe context menu

Keyboard

Moving around
← → ↑ ↓between cards; with ⇧ — select
Enter · ⌘↓open
Spacelook up close
⌫ · ⌘↑one level up
⌘[ · ⌘]back · forward
⌘Dthe main screen and back to the folder
Home · Endto the start · to the end
PgUp · PgDnpage by rows
Files
⌘C ⌘X ⌘Vcopy · cut · paste
⌘A · Escselect all · clear the selection
⌘N · ⌘Rnew folder · rename
⌘⌫to the Trash
⌘Ffilter by name
Assistant and view
Vmicrophone: listen / do not listen
Ggestures in front of the camera
Bthe built-in browser
Hhide and show the side panel
1 2 3arc · grid · spiral
0return the camera to the start position
Escminimise the hologram window
⌘,settings
⌘Qquit Jarvis
On the main screen the file keys do nothing — there are no cards there, and ⌘⌫ will not send to the Trash what you cannot see. Enter a folder, and everything turns on.
jarvisapp.tech
Jarvis · User Guide10 · Voice

Section 10

How to talk to Jarvis

Speak as you would to a person. One sentence — what to find, where to look and what to do with it. If several options fit, Jarvis does not guess — he asks.

The name rule

A command starts with the name: Jarvis, open downloads. Without the name Jarvis does not react — so a movie soundtrack and other people’s conversations never become commands. The name alone, without a command, gets a short “Yes, sir?”, and he keeps listening.

After a command is done Jarvis listens for another 10 seconds without the name: “Done, sir. Any further instructions?”. Small things — volume, pause, minimise — he does silently. How he wakes and falls asleep — section 11.

Interrupting

While Jarvis is speaking, say Jarvis, stop, enough, not that or let me clarify, I need… — he falls silent and listens. Just to cut the answer short: quiet.

If several were found

Jarvis shows a numbered list and asks. Answer the first, number three, the last, name the file (february), say all or cancel. You can also click the options with the mouse.

Numbers and names

Names can be said in your language even if the file is written differently: “donald” finds donald_face.png. Numbers are understood as words: “version fifteen” → v15. Formats — by ear: “pdf”, “word”, “excel”, “jpeg”.

Anything risky — only after a “yes”. Before copying, moving and deleting Jarvis says what and where, and waits for your “yes”. “No” cancels. While he is answering, the microphone is closed for him, so he does not hear his own voice.

The voice panel

Listening — the microphone is open. On the right — the sound level and a cross that closes the panel; V or the microphone button turn hearing off completely.

Command → Thinking → Answering. At the top — what he heard, below — the answer. While the brain searches, you can see what exactly: “Searching the documents…”. Longer than three seconds — he says “Let me look”.

Done — what exactly was done: not just “done”, but “Noted. The note is in Documents, in the Jarvis folder”.

jarvisapp.tech
Jarvis · User Guide11 · Waking and sleep

Section 11

Waking and sleep

Jarvis has three states: closed, waiting for his name, and listening. From closed he is woken by two claps and a phrase, from waiting — by his name, and a farewell closes him.

Jarvis is closed — claps

  1. Clap your hands twice — sharply, one after another. A short silence is needed before the first clap.
  2. A quiet signal sounds — the claps were heard, Jarvis is waiting for the phrase.
  3. Within six seconds say the wake phrase (the list on the right). The long variant triggers on its first words already.
  4. Jarvis opens: the boot screen, intro music, the greeting and the briefing — what came in and what the weather is.

The claps are heard by a small background program, “Jarvis — Wake” (next page). Its microphone only watches the loudness, and the phrase is recognised on the Mac; nothing is recorded or sent anywhere. While Jarvis is open, it lets go of the microphone.

Phrases that wake him after the claps

Wake up, sleepyheadWake up, sleepyhead, we have a lot of workПросыпайся, соня Wake up, JarvisWake up, FridayПросыпайся, Джарвис

Any name from the settings (“Answer to names”) works. “On Friday” is a weekday, not a call. To check whether the program hears the claps, look at the icon in the menu bar: it says “Waiting for ‘Wake up, sleepyhead’”.

Jarvis is open — the name

JarvisJarvis, open downloadsFridayДжарвис

The name alone — “Yes, sir?”, after that the command can be said without the name. The name together with a command — straight to work. How many seconds after answering he waits for a command is set by “Fall asleep after silence” (45 s by default); then he waits for the name again. This is the “sleep” of hearing: the microphone works, but reacts only to the name.

How to stop, put to sleep and close

PhraseWhat happens
quiet · stop · enoughHe falls silent and cuts the answer short. Keeps listening.
stop listening · turn off the microphoneHearing is off completely — he will not even answer to his name until you press V or the microphone button.
Good night, JarvisA short farewell — and the program closes. The name is required, at the start or the end of the phrase. If Jarvis is already listening after “Yes, sir?”, the name is not needed. Polite words do not get in the way: “All right, Jarvis, thanks for the work, good night”. But words about something else break the farewell: “while the music plays”, “good night, kids” — not a command.
Bye, Jarvis · Jarvis, see you soon · see you tomorrow · see you · goodbye
Jarvis, shut down · power off · close down · finish up
Спокойной ночи, Джарвис · Пока, Джарвис · Джарвис, выключайсяThe same in Russian.
After the farewell the “Jarvis — Wake” program keeps listening for claps. In the morning — two claps and “Wake up, sleepyhead”, and Jarvis is back.
jarvisapp.tech
Jarvis · User Guide11 · Waking and sleep

11.1The “Jarvis — Wake” program

Installs itself on the first launch of the built Jarvis: into the user’s Applications folder (visible in Launchpad and Spotlight) and as a shortcut on the Desktop. It starts at login and lives as an icon in the menu bar — Jarvis himself can be closed meanwhile.

The menu bar icon

What is in it

The state (“Waiting for ‘Wake up, sleepyhead’”, “Jarvis is open”, “paused”), Pause — stop listening for a while, Open Jarvis — without claps, Restart, Log and Turn off.

Jarvis settings

The “Wake by claps” row

Next to it — the state: running, off or not installed. The buttons Turn off / Turn on and Restart; the switch “Claps — start at login”.

How to clap so that it works

Intro music, greeting and briefing

07:30

Claps and “Wake up, sleepyhead”

Jarvis opens, the intro music plays: Jarvis’s theme, your own file (in the settings — which part and how many seconds, section 04.3) or off. The music yields to the voice: it fades as soon as Jarvis starts speaking.

07:31

Greeting and briefing

A greeting for the time of day, then the briefing: how much is unread in Mail and messengers and what the weather is. “Someone managed to write”, “lots of work” or “a nice day — time to make coffee”. Called by name — the briefing is skipped.

Daytime

Commands by name

Called — “Yes, sir?”. Done — “Done, sir. Any further instructions?” and he listens for another 10 seconds without the name. If you have already answered his question, he does not finish the unsaid part afterwards.

23:30

Farewell

Good night, Jarvis — a short farewell, and the program closes until morning. Without the name these words do nothing: a movie soundtrack will not close the program.

jarvisapp.tech
Jarvis · User Guide12 · Voice commands

Section 12

Voice commands: files and folders

These are examples, not formulas: Jarvis understands natural speech — “where is the contract”, “check whether there are such files there”, “new folder reports”. The full list is always at hand: say what can you do or press “Voice commands” in the settings.

Find and act at once

find the movie Harry Potter on the computer and play it
find the document letter in pdf format and open it
find the report on the mac and move it to downloads
find the contract on the computer and delete it
find donald — only in the current folder

Where to look: “on the computer”, “on the mac”, “everywhere” — across the whole home via Spotlight; without these words — in the current folder. Type: movie, video, photo, document, music, archive, folder, program, spreadsheet, presentation. Format: “in pdf format”, “with the docx extension”.

Open

open downloads · documents · desktop
open the folder archive · go to reports
open the note in a text editor
up · back · forward · refresh
home · main screen

Programs

open the program music
open the program music and play the moonlight sonata
open the movie in QuickTime
close the program mail

Move and copy

copy the note to archive
move this to the desktop
copy all movies to downloads
copy · cut · paste

Change

create a folder reports
rename the note to important
duplicate this · copy the path
compress this · unpack the archive
show in Finder

Delete — to the Trash only

delete this · delete the report
He first says what he is deleting and asks. Does it only after your “yes”.

Selection and order

select all pictures · select donald
select all · clear the selection
sort by size · by date · by name · by type
show only video · show everything
show hidden files · hide hidden files

View and details

grid · arc · spiral · zoom in · centre
how many files are in this folder · where am I
what is here · the size of this
jarvisapp.tech
Jarvis · User Guide12 · Voice commands

12.1Windows, sound, movies, documents and the internet

Windows and the screen

close the window · close all windows
minimise · maximise · bigger
show it here · show the places
go back to the main screen

Sound and volume

turn it up · quieter · volume 40 percent
mute the sound · unmute
send the sound to the headphones · to the speakers
turn off the microphone · stop listening

Movies and music

play “Distant Stars” · play the movie The Hobbit
pause · continue · full screen
skip 20 seconds · back · to the 45th minute · from the start
switch to the original · bring back the Russian dub · another audio track
all videos on the computer

Weather

what’s the weather · what about tomorrow · weather in Kazan

Mail and documents

what came in the mail? · what is in the letter from accounting?
what is the total in the renovation estimate? — found in the documents
remember: car inspection on October 14 at 10 am
when is the car inspection? — answered from the note
what is in this document? · what is the article about?

Internet

find a cartoon about a cat on youtube and play it
search the internet for the weather in Moscow
open the site habr.ru · open youtube
open the first one · page back · close the browser
open mail · open WhatsApp · open Telegram

Assistant

what can you do · quiet
turn on gestures · turn off gestures
switch to Russian · переключись на английский
Good night, Jarvis · Bye, Jarvis
Short phrases — instantly. A command of up to seven familiar words (“open downloads”, “turn it up”, “weather”) is carried out by a strict rule in a fraction of a second, without waiting for the brain. Long and unusual requests go to the brain — 1.5–5 seconds on the built-in one and 7–9 on an external one.
Polite words do not get in the way. “Please open the downloads folder for me” is the same as “open downloads”. Questions and turns of phrase are understood too: “where is the contract”, “check whether there are such files there”.
In Russian — word for word. After switch to Russian the same commands work: «найди на компьютере фильм Гарри Поттер и запусти его», «скопируй заметку в архив», «удали это» — and ask for confirmation in the same way.

The built-in help. Opens with the phrase what can you do or the “Voice commands” button in the settings.

jarvisapp.tech
Jarvis · User Guide13 · Second brain

Section 13

Second brain: documents and notes

Ask about the contents without naming the file — Jarvis finds the answer in your documents and tells you where it came from. No answer — he says so and never makes anything up. Works with any brain, built-in or external.

“Jarvis, what is the total in the renovation estimate?” — “By the estimate — 486,000 ₽: materials 212,000, labour 274,000. That is from ‘Renovation estimate.xlsx’.” While he searches, the panel shows: “Searching the documents…”.

How it works

  • Searches the Documents, Desktop and Downloads folders through macOS search — builds no index of its own, uses no memory, answers in a fraction of a second.
  • Reads PDF and scans (recognises the text), Word, RTF, Excel, PowerPoint, web pages and plain text.
  • In a long document finds the most relevant passages — even from the middle of a fifty-page report.
  • Answers strictly by the text and names the source document.

Reads what is open

Opened a letter, a PDF or an article in the browser — ask what is this about? or what does the letter ask for?. If you turn on “Notice interesting things in what is open” in the settings, Jarvis points out the main thing himself whenever you open something — no more than once in 40 seconds and never interrupting you.

“Remember that…”

Say Jarvis, remember: car inspection on October 14 at 10 am.

  • A note appears in the folder Documents › Jarvis › Notes — an ordinary text file with the date in its name. It is visible in Finder; old notes are never overwritten.
  • A week later ask when is the car inspection? — Jarvis answers from the note.
  • Notes can be opened and edited like any file.
jarvisapp.tech
Jarvis · User Guide14 · Movies and sound

Section 14

Movies and sound

Movies play in the built-in player, in a window inside Jarvis. It handles sound that ordinary players stay silent on, and puts the Russian track first.

“Jarvis, play ‘Distant Stars’.” The movie opened in a window; the panel says “Playing ‘Distant Stars’”. Speak during the movie — the sound goes down so that Jarvis can hear you.

What the player can do

  • Any sound. AC3, E-AC3, DTS and TrueHD — what usually lives in MKV — are decoded inside Jarvis and stay in sync with the picture.
  • Tracks. Russian by default, otherwise the main one. Switch by voice: switch to the original, bring back the Russian dub, put on the Vizgunov translation.
  • Seeking. skip 20 seconds, back (10 seconds), to the 45th minute, from the start. Pause, continue, full screen — by voice or with the player buttons.
  • Titles out loud — by meaning. “Distant Stars”, not “Distant.Stars.2024.1080p.BluRay.x264.mkv”. On screen — the full name.

Volume and ducking

  • turn it up · quieter · volume 40% · mute the sound · unmute.
  • Turn the movie down when I speak — the setting is on by default: as soon as you start speaking the sound goes down, and comes back after the answer.
  • Sound on Bluetooth headphones? Jarvis listens to you through their microphone.

If it did not play

A rare format that could not be read — Jarvis offers to open it in IINA or VLC: “‘…’ does not play here. Play it in IINA?”. Answer “yes”. To open in an external player right away: open the movie in IINA.

Protected video (Netflix and the like) does not play inside — it needs a separate player or Safari.
jarvisapp.tech
Jarvis · User Guide15 · Mail, messengers and the internet

Section 15

Mail, messengers and the internet

The “Mail” widget. The latest letters from the Mail app; in the right corner — how many are unread.

Mail

Jarvis reads letters from the Mail app — read only, he never sends or deletes anything. Ask what came in the mail? or what is in the letter from accounting? — he reads it and points out the main thing: “They ask you to sign the act by Friday”. A click on a letter in the widget opens it in a window; if Mail is closed — iCloud Mail opens inside Jarvis.

The briefing after the greeting

Unread items are counted by the badge numbers in the Dock: Mail, Messages, Telegram, WhatsApp, Viber, Slack and other running programs. The contents are not read and no permissions are needed.

Messengers

iCloud Mail, WhatsApp and Telegram open in windows inside Jarvis — these are their web versions, the sign-in is kept between launches: open WhatsApp. SMS and iMessage have no web version, so open messages launches the Messages app.

The built-in browser

The B key or by voice. The page opens inside Jarvis, in a holographic frame. Site names are understood in any form: “on youtube”, “on vk”, “in wikipedia”.

PhraseWhat happens
find a cartoon about a cat on youtube and play itsearch and play the first result
find a concert on vksearch on the site
search the internet for the weather in Moscowweb search
open the site habr.rugo to the address
open the first one · pause · full screenplayback control
page back · close the browsernavigation
Sites Jarvis knows by name

YouTube, VK, VK Video, RuTube, Wikipedia, Yandex, Google, DuckDuckGo and Maps. Any other — by address: “open the site …”.

The browser lives in a separate session. The file window is cut off from the network, and the internet is only where you asked for it. Video on websites plays; protected video (Netflix) does not.
jarvisapp.tech
Jarvis · User Guide16 · Gestures in front of the camera

Section 16

Gestures in front of the camera

Files can be handled by hand: the camera sees your hand and the cursor repeats its movements. Turn it on with the G key, the palm button at the top or the phrase turn on gestures. The first time, macOS asks for camera permission.

GestureAction
✋ Open palmmove the cursor — it follows the tip of the index finger
👌 Pinchgrab an item; a pinch on empty space and a drag — rotate the scene
Release the pinchput it down; over a folder — move it inside
☝︎ Point and hold for 0.85 sopen
✌︎ Two fingerstoggle between copy and move
👍 Thumb upconfirm
✊ Fist, hold for 0.5 sclear the selection
✋ A sharp move to the leftone level up
Two hands pinched, move apartzoom in and out

Tips

  • The mouse always wins. Move the mouse — control returns to it; let it rest — the hand works again.
  • Sensitivity in the settings: how small a hand movement crosses the whole screen.
  • Mirror the camera — if the movements feel “backwards”.
  • Even light on the hand and a plain background help a lot.

The iPhone camera

An iPhone near the Mac appears in the list as an ordinary camera (Continuity Camera) and is offered first. If the iPhone is asleep or far away — pick the built-in camera in the drop-down list on the gesture panel.

The hand model

Recognition of 21 hand points runs on the Mac, without a network. If the model file is missing, a simplified tracker works — the cursor and grabbing without individual fingers; the full version comes back with the “Download the hand model” button in the settings (about 7 MB, once).

jarvisapp.tech
Jarvis · User Guide17 · Personal memory

Section 17 · new

Personal memory

Jarvis adapts to its owner: it remembers what you call people, files and programs, which words it misheard and which requests it handled well. The longer you work together, the better it understands you in particular. Everything is stored only on this Mac.

What it remembers

WhatExample
Your wordsMom is Olga Ivanovna on WhatsApp; the report is the file “Quarterly report.xlsx”; mail is the right website or program.
MishearingsYou corrected not Petrov, Petrova — Jarvis remembers. After several identical corrections it gets it right on its own.
Successful requestsThe phrase and what it did. Next time a similar request is understood faster and more accurately.
Where you writeWhich messenger you usually use for each person: text Sam goes straight to the right app.
Programs and volumeWhat you open spreadsheets, documents and videos with; your usual volume.

How to teach it

  • Say it directly (in Russian for now): «Джарвис, запомни, что Саня — это Александр Петров в WhatsApp» — “remember that Sanya is Alexander Petrov on WhatsApp”.
  • It asks on its own. If you pick the same thing several times, Jarvis offers: “Remember that ‘the report’ is ‘Quarterly report’?” Answer “yes” or “no”.
  • Correct it right after a mistake: “not Petrov, Petrova”.

To note a task or a date, it is still a note: remember: car inspection on October 14 (section 13).

View and forget

Settings → Brain → “Personal memory”. The switch is on from the start. The “Remembered” row shows how many entries there are and of what kind. “View” lists them by group; the cross next to an entry forgets it (“Restore” is available for 10 seconds). “Forget everything” — press twice; the memory file goes to the Trash, and you can restore it from there.

By voice (in Russian for now): «забудь про Саню», «забудь всё, что запомнил» — Jarvis asks again and forgets only after “yes”.

Only on this Mac. The memory is a file in the program folder. It is not sent to an external AI (ChatGPT, Claude and others). Turn the switch off and Jarvis stops remembering and applying it; what it remembered can still be viewed or forgotten.
Parental control. While it is on, the memory is not used. Voice commands for the memory work in Russian for now.
jarvisapp.tech
Jarvis · User Guide18 · Reading documents aloud

Section 18 · new

Reading documents aloud

Jarvis reads a letter, a contract, an article or a manual in a natural voice — sentence by sentence, with pauses, while the current line is highlighted in the window. Numbers, dates, sums, contract clauses and abbreviations are spoken the way a person would say them.

How to start

  • Open the document in the “Preview” window and press the “Read aloud” button in the top right corner of the window. While reading it turns into “Pause”, and on pause into “Continue”.
  • Or by voice: read this document aloud, read my latest email — Jarvis finds it, opens it and starts reading.
  • Word, PDF, text and other documents that open in “Preview” can be read.

Tables and bookmarks

Jarvis reads a table row by row, the way a person would. For a large one it asks: the whole table or only the totals; you can also say read only the table totals.

When you stop, the place is remembered. Come back to the document even the next day and Jarvis asks: “Continue from where we stopped?” Answer “yes” or no, from the beginning.

Commands while reading

SayWhat happens
read from section three · from clause 2.1 · from the beginninggo to the right place
next · back · skipnext or previous sentence, section
pause · continuestop and continue from the same place
repeat · repeat the paragraphread the sentence or paragraph again
read slower · faster · as usualreading pace
where are we · remember this placename the section and clause · set a bookmark
stop · enoughfinish reading, the place is remembered
While Jarvis is reading, you don’t need to say its name before a command. Start talking about something else and it stops and listens. A couple of minutes after “stop”, short words like “next” go back to the movie and ordinary commands.
jarvisapp.tech
Jarvis · User Guide19 · Questions and voice

Section 19 · new

Asks if it didn’t understand

If the main detail is missing, Jarvis doesn’t guess — it asks one short question. Your answer completes the request, and it carries it out.

You saidIt asks
create a folder“What should I name the folder, sir?”
send a message“Who should I send it to?”
text Lena“What should I write?”
launch a program“Which program should I launch?”
find“What should I find?”
  • Answer without the name — the question waits about 25 seconds.
  • No more than two questions per request; if it still doesn’t work out, Jarvis says so honestly.
  • stop or never mind drops the question.
  • A correction instead of “yes”. To “Send to Lena on WhatsApp: ‘…’?” say on Max instead or no, to Olya — Jarvis sends nothing and asks again: “Send to Lena on Max: ‘…’?”
  • “Of course not”, “don’t”, “no need” mean “no”. Anything risky still happens only after a separate “yes”.

Voice tone and speed

Settings → Voice, right under “Answer volume”:

  • Speech speed — from normal up to +25%: shorter sounds and pauses, same timbre.
  • Bass — a fuller or lighter voice; treble — brighter or softer (±6 dB).
  • “▶ Listen” and “Reset voice settings”.

By default the voice sounds exactly as before. Only Jarvis’s voice changes — not music or movie sound.

By voice:

  • speak faster · normal speed
  • lower voice · higher voice
  • more bass · less treble
  • reset voice settings

A voice step is 10% of speed or 2 dB. At the limit Jarvis says it can’t go further.

jarvisapp.tech
Jarvis · User Guide20 · Living companion

Section 20 · new in 4.0

A living companion

Jarvis no longer just carries out requests: he takes an interest in your day, recognises each family member by voice and reminds you of what matters. All of it runs on your Mac, offline.

Voice commands on this page work in Russian for now: say the phrase in Russian (shown first), the translation follows in brackets.

He starts the conversation

In quiet moments, about every quarter of an hour, from 8 am to 11 pm — never during a film or while you are busy — Jarvis asks how your day went. Tell him your plans and he will remember and later ask how it went.

  • отстань (leave me alone) — silent until morning;
  • не сейчас (not now) — silent for an hour;
  • давай поболтаем (let's chat) — asks right away.

Recognises voices

For an unfamiliar voice Jarvis asks who it is, then recognises that person and uses their name.

  • я хозяин (I'm the owner) — deleting or moving files needs a “yes” in the owner's voice;
  • Соне 8 лет (Sonya is 8) — Jarvis speaks more simply to the child, recognised by voice;
  • whisper — he answers more quietly.

Reminders and family dates

SayWhat happens
напомни через 20 минут выключить духовку (remind me in 20 minutes to turn off the oven)Said aloud on time — even while minimised to the sphere. Also “what are my reminders”, “cancel the reminder”.
у мамы день рождения 12 марта (Mom's birthday is March 12)Remembered and announced in advance every year.
Morning and eveningA morning summary for each person; on “good night” — what tomorrow holds.
Welcome backBack at the Mac after a break — a short note on what arrived.
Only on this Mac. Voices, notes from conversations and dates stay in the app folder and are never sent anywhere.
jarvisapp.tech
Jarvis · User Guide21 · Games and screen

Section 21 · new in 4.0

Games, tales, the screen and music

Jarvis has become livelier: he reacts to what you say, plays with children, tells stories and can look at what is on your screen.

Voice commands on this page work in Russian for now: say the phrase in Russian (shown first), the translation follows in brackets.

WhatHow
Gamesдавай поиграем в загадки (let's play riddles), also cities and quiz. Answer without his name; “I don't know” — he gives the answer, “enough” — ends the game.
Bedtime storyрасскажи сказку (tell a story) — a new kind story every time, ending with “Good night”.
Live reactions“Right, one moment” while thinking, “Oh, great!” on good news. The sphere glows in tune with the conversation.
Look at the screenпосмотри на экран (look at the screen), помоги с этой ошибкой (help with this error) — Jarvis reads the text in another app's window and explains it. The first time macOS asks for permission: System Settings → Privacy & Security → Screen Recording → Jarvis.
Music for the moodвключи музыку под настроение (play music for my mood) — a YouTube selection in the built-in browser.
macOS Shortcutsзапусти команду «Включи свет» (run the shortcut “Lights on”) — your shortcuts from the Shortcuts app.
The screen stays on the Mac. The text is read locally and the snapshot is deleted at once. With an external brain selected, only the recognised text is sent to it.
jarvisapp.tech
Jarvis · User Guide22 · Sphere and follow-up

Section 22 · new in 4.0

Minimised mode and talking without the name

Jarvis can hide in a small sphere in the corner of the screen and keep listening. And after you call him by name, you can carry on without saying “Jarvis” — like talking to a person.

Minimise to the sphere

Russian: свернись в сферу (minimise to the sphere), спрячься (hide); English: minimize. The window goes to the Dock and a golden sphere appears in the corner; Jarvis keeps listening, answering and reminding, and frees the Mac's video memory.

Bring back

покажись (show yourself), вернись на экран (come back to the screen); while minimised — simply разверни (expand). Or click the sphere or the Dock icon — the window returns straight to full screen.

Talking without the name

After “Jarvis, …” you have another 30 seconds from the end of his answer to go on without the name — clarify, continue, correct. Each phrase extends the time.

открой загрузки (open Downloads) → нет, стой, не то — открой документы (no, wait, not that — open Documents) — understood as a correction.

Another voice nearby without the name is not a command — only “stop” while Jarvis is speaking.

Answers sooner

Since 4.0.3 Jarvis starts speaking with the first ready part of the answer — 1–2 seconds earlier.

jarvisapp.tech
Jarvis · User Guide23 · Long tasks

Section 23 · new in 4.0

Long tasks

Several things at once can be dictated calmly, with pauses: Jarvis listens to the end, repeats back how he understood it, and only after your “yes” carries it out in order.

Voice commands on this page work in Russian for now: say the phrase in Russian (shown first), the translation follows in brackets.

StepYouJarvis
1Джарвис, запиши задание (Jarvis, take down a task)“Listening. Dictate — say “that's all” when you finish.”
2Find the October invoice in Downloads … then send it to Ivan in Telegram … and remind me to pay it tomorrow at 10Listens without interrupting and waits longer for pauses; no name needed. Nothing is done yet — it is written down.
3это всё (that's all)“I understood it like this: first — …; second — …; third — …. Shall I start?” If something is unclear, he asks.
4да (yes)Does the steps one by one, silently, and sums up in one phrase: “Done, sir: three steps completed.”

Correcting

  • On the summary: нет (no) — “What should I fix?”; or straight away “no, Ivan Petrov” — he adds it and repeats the plan.
  • While working: стой, не то (stop, not that); later — продолжай задание (continue the task).
  • отмена (cancel) — the task is forgotten.

If a step fails

If a step needs clarification, Jarvis asks and stops; answer, then say “continue the task”. If a step fails, he says which one and does not go on without you.

jarvisapp.tech
Jarvis · User Guide24 · Updates and help

Section 24 · new in 4.0

Updates and helping the developer

Since version 4.0.3 updates are small — usually 10–20 MB — and install with one button inside Jarvis. If something is wrong, you can report it in two clicks.

Update with a button

  1. When an update is out, Jarvis tells you himself and Settings show a hint.
  2. Settings → “License” → “Update to …”. The download takes a couple of minutes.
  3. “Restart” — Jarvis comes back updated.

The voice, models, your own AI and all settings stay in place. If the new version fails to start, Jarvis returns to the previous one by himself.

Occasionally, when the voice or hearing models change, the full version is needed — the button then reads “Download …”, and installation is as in section 02.

Report a problem

Settings → “Help make Jarvis better” → describe what happened → “Report a problem”.

The developer receives: your description, the error log (it has none of your phrases; home folder, user name, e-mail and purchase code are removed), the Jarvis and macOS versions, the Mac's chip and memory, and the request number — to reply by e-mail.

Weekly report

The checkbox “Send an anonymous report once a week” is off by default. The report holds only numbers: how many commands and how often Jarvis did not understand, failures, how fast he answered, the version. No phrases, files or purchase code — a random number instead of you. Untick it and the collected data is forgotten.

jarvisapp.tech
Jarvis · User Guide24 · Updates and help

24.1What's new in 4.1 and 4.1.1

4.1 — does, not chats

  • Requests like “what's in my mail” or “open settings” are carried out right away instead of turning into a chat. You can still talk: “what do you think…”, “I'm bored”.
  • Fewer filler words: a short “Yes, sir” only when an answer takes longer.
  • When Jarvis offers something (“Check your Telegram messages?”), just say “go ahead” or “yes”.
  • “Good night” and “Bye” close the app at once.

New commands

  • “Open settings”, “voice settings”.
  • “What's in my Telegram?”, “Any new messages?”
  • “Forget my name” — back to “sir”.
  • “Play music”, “play the song …”, “next song”.
  • “Read me a fairy tale about …”.
  • “Open the latest file in Downloads”.

Video and music play in the built-in player; WhatsApp and Telegram open as Mac apps. Before sending in WhatsApp, Jarvis asks “Send?”.

4.1.1 — memory like clockwork

Jarvis's brain is its heaviest part — about 12 GB of memory. Now Jarvis decides by itself when to keep it in memory and when to free it for other apps:

  • You step away from the Mac for 10 minutes — the brain leaves memory.
  • You come back — touch the mouse or keyboard — the brain loads in advance, before your first request.
  • A film is playing and memory is low — the brain rests.
  • The Mac slows down from lack of memory — the brain leaves if it hasn't been needed for a while.
  • You say “Jarvis…” — the brain loads while you finish your request (1.5–3 s).
  • During a conversation or while Jarvis is answering, the brain is never touched.

While you are at the Mac and memory is fine, the brain stays — answers are as fast as before.

Fixed: previously, after start-up Jarvis could not free memory even when the Mac began swapping.

jarvisapp.tech
Jarvis · User Guide25 · Safety and privacy

Section 25

Safety and privacy

Jarvis does a lot, but nothing behind your back.

Files

Only after a “yes”

Copying, moving, renaming and deleting — only with your consent. Jarvis first says what and where, then waits for the answer. “No” cancels.

Trash

No permanent deletion

“Delete” always means “to the Trash” — through the macOS system mechanism. Anything deleted can be brought back from the Trash.

Hearing and voice

On your computer

Speech is recognised and synthesised on the Mac. Recordings go nowhere. While Jarvis speaks, his own voice is marked as echo and does not count as a command.

Files

Cut off from the network

The file window physically cannot reach the internet. The browser works in a separate session and goes online only where you asked.

What goes to the internet

WhatWhere and why
WeatherThe city name — to the Open-Meteo service. Without a network the widget is simply empty.
Personal memoryNowhere: it is stored only on this Mac and is not sent to an external brain (section 17).
The built-in browserOnly the pages you opened yourself or asked to find.
An external brainOnly if you chose it: the text of the request and the excerpts from documents or letters needed for the answer. The own AI sends nothing.
Safe searchWith parental control on, family mode is added to Yandex, Google and Bing queries, and YouTube gets restricted mode.
Updates, reportsUpdates come from jarvisapp.tech, only on your button. “Report a problem” — only when you press it; the weekly report — only if ticked, without your phrases or files (section 24).
Mail and messengersThe windows with web versions go to their own sites, like an ordinary browser. The mail widget reads letters from the Mail app locally.
External brain keys are stored encrypted in the macOS Keychain and are never shown back, even in the settings.
Logs in the Library/Logs/Jarvis folder help with troubleshooting and contain no phrases of yours — only events.
jarvisapp.tech
Jarvis · User Guide26 · If something is wrong

Section 26

If something is wrong

What happenedWhat to do
Does not open after installationRight-click the icon → “Open” → “Open”. Needed once: the app is signed locally.
Does not react to the nameLook at the “Hearing” indicator under the clock and the line in the “Load” widget: if it says “mic off” — press V. Check the permissions: System Settings → Privacy & Security → Microphone and Speech Recognition. After an update they are asked again. Sound on Bluetooth headphones — Jarvis listens through their microphone, speak into them.
Takes a movie for a commandThis should not happen: commands are by name only. Make sure “Turn the movie down when I speak” is on, and say the name clearly, in a pause.
The external brain does not answerSettings → “Brain — who thinks” → “Check”. The notes “needs a key”, “the key did not match”, “not responding right now”, “sign in needed” are explained in section 05.1.
Everything is slow, the GPU is loadedSettings → untick “Pick graphics automatically” → 60 frames and 150 % scale (section 04.1). To restore — tick the box again.
A site says “closed by parental control”Parental control for a child is on. Change the age or turn it off — in the settings, with the parent’s password (section 04.2).
The answer is on screen, but there is no voiceThe voice ran out of memory at the peak. Jarvis repeats the phrase himself after the memory is freed; a short warning appears on screen. Close heavy programs or switch to an external brain.
Thinks for a long timeShort requests run instantly, long ones go to the brain (1.5–5 s on the built-in one, 7–9 s on external ones). The first answer after changing the voice or the brain takes longer — that is a one-off.
Video without sound or not playingSay play it in IINA or open in VLC. Protected video (Netflix) does not play inside.
The weather is emptyNo internet — the “Network” widget shows it. Jarvis retries after 20 seconds, 1 and 2 minutes.
Gestures do not workCamera permission: System Settings → Privacy → Camera. The hand model is needed — “Download the hand model” in the settings. Do not move the mouse: it takes over control.
Claps do not wake himThe “Jarvis — Wake” icon in the menu bar shows the state; in the settings — “Restart”. Clap sharply, twice, with a pause of silence before the first clap; say the phrase within six seconds after the signal (section 11).
Mixes up your words or namesCorrect it right away: “not Petrov, Petrova”, or teach it once (section 17). A wrong entry can be forgotten in “Personal memory”.
The wrong music at loginSettings → “Intro”: the theme, your own file or off; for your own file — the part on the track (section 04.3).
Didn't help · update failsSettings → “Report a problem” — the log (without your phrases) goes to the developer by itself. If an update fails to start, Jarvis returns to the previous version (section 24).
The fastest way to check that all is well: say Jarvis. The reply “Yes, sir?” means hearing, brain and voice are in place.
jarvisapp.tech
Jarvis · User GuideCheat sheet

On one page

Cheat sheet

Wake up, sleepyhead

After two claps, when Jarvis is closed.

Jarvis

The reply “Yes, sir?” — and he listens.

Jarvis, open downloads

The folder full screen. Back: “main screen” or ⌘D.

find the contract on the computer and open it

Searches the whole Mac; with several matches — asks.

move this to the desktop

Says what and where, and waits for your “yes”.

delete the report

To the Trash only, and only after a “yes”.

play “Distant Stars”

The movie in the built-in player, the Russian track first.

what is the total in the renovation estimate?

An answer from your documents with the source named.

remember: car inspection on October 14

A note in Documents › Jarvis › Notes.

read this document aloud

Reads with highlighting; “next”, “repeat”, “stop”.

remember that Mom is Olga Ivanovna

Personal memory (in Russian for now): then just “text Mom”.

Джарвис, запиши задание

Take down a task: dictate, “that’s all” — he repeats it back.

свернись в сферу

Minimise to the sphere; back — “покажись”.

напомни через 20 минут…

Remind me in 20 minutes — said aloud, even minimised.

Good night, Jarvis

Says goodbye and closes. Also “Bye, Jarvis”, “see you soon”, “shut down”.

Keys worth remembering

V listen · G gestures · B browser · ⌘D main screen · ⌘, settings
Enter open · Space look up close · ⌘⌫ to the Trash · Esc minimise the window · ⌘Q quit

An external brain in a minute

⌘, → “Brain — who thinks” → choose ChatGPT, Claude, Gemini, DeepSeek or Alice → paste the key from the model’s website → “Save” → “Check” → “Done”. Back to the own AI — in the same list. Details — section 05.

Jarvis is an independent project, developed on voluntary contributions. Android has a test version; iPhone and Windows are in the works.
Project website: jarvisapp.tech
jarvisapp.tech