Help
How to set Vakyartha up, use it every day, keep it under your control, and fix things when they go wrong.
01 / First steps
Follow the download page. If you open the app yourself and macOS won’t open it, go to System Settings, Privacy & Security, and choose Open Anyway. You only need to do this once.
The first time you open Vakyartha, it shows Get started: a short checklist of what it needs. For a free model that runs on your Mac, Vakyartha offers to install the app that runs it and downloads the models it needs. You can also add your own key for an online AI service.
Type in the message box, or pick one of the ideas under the greeting. Small answers stay in the chat. Larger ones, like a table, chart or form, open in the canvas beside it.
Voice, apps, connections and the look of the app are all optional. Come back to Settings, Get started at any time to see what is still missing.
02 / Everyday use
Tables, charts, forms and dashboards open beside the chat. Switch between full and split view with Command-Shift-F, and drag the divider to resize. Every answer is kept in Artifacts, where you can search for it and open it again.
Press Command-D or the microphone to dictate a message; Return stops, Escape discards. Conversation mode, Command-Shift-D, keeps listening and reads replies aloud, so you can answer questions and approvals out loud.
Use the speaker on any reply, or right-click it. Tables are read row by row and charts as a sentence. Choose the voice and speed in Settings, Voice.
Choose Work in folder under the message box. Vakyartha works on a safe copy, and you review each changed file before anything reaches your real folder.
Work holds tasks you run now or schedule for later. Each run keeps a record of what was done, so you can check it and carry on.
A local model costs nothing. With an online service, Settings, FinOps shows each answer’s size and likely cost, and you can export it.
Connect a chat channel in Settings and answer from anywhere while the app runs in your menu bar.
03 / Apps
Apps keep their own data on your Mac and work without a model answering every click. Open Apps in the sidebar to see them all.
Click its card. The apps that come with Vakyartha work as soon as you open them, with no setup.
An app can refresh in the background while Vakyartha is open. Turn this on or off in the app’s Background tab.
Some apps turn their news into a short programme. Listen plays it like radio; Watch adds headlines and charts that follow along.
Browse the catalog, then add an app or skill from inside Vakyartha. Nothing new runs until you turn it on.
Browse the catalog ↗04 / Your control
Every tool and every website an app or connection can reach has one of three choices.
It can be used without asking each time. Choose it for things you trust and use often.
Vakyartha pauses and shows you the request first. Anything that writes, deletes or goes online starts here.
It is never used.
Click the shield on the app’s card. Change as many choices as you like, then press Save changes; nothing changes until you save.
Apps exactly as Vakyartha ships them start with the access they declare, so they work with no setup. Your own choices always win. To turn this off, open Settings, General, Trust Vakyartha apps.
05 / When something goes wrong
Doctor checks your installation and tells you what to do next. Open Operation Center from the Apps page or the Vakyartha icon in the menu bar; Doctor is its first tab.
Builds are not yet notarized by Apple. Go to System Settings, Privacy & Security, and choose Open Anyway. You only need to do this once.
Open Settings, Get started. The first two steps must be done: a model is connected and a default model is chosen. If the free local model is missing or stopped, the page offers to start it or download it.
A local model runs on your Mac, so its speed depends on your Mac and on what else is running. Long chats take longer; start a new chat for a new subject. You can also choose an online model for a single chat from the menu under the message box.
Its access may be set to Ask or None for the source it reads. Open the shield on the app’s card and check its tools and destinations. Doctor lists every app that cannot refresh and why.
It may be waiting for your approval: look for a request in the chat. Press Escape to stop a reply at any time.
Check that macOS allows Vakyartha to use the microphone, in System Settings, Privacy & Security, Microphone. Then check Settings, Voice.
Run a checkup in Doctor. Each finding says what was checked, what it found and the next step. Some fixes, like restarting a stopped app or downloading a missing model, Doctor can apply after you confirm.
Meet Doctor ↗
06 / Shortcuts
The same list is in the app under Settings, About.
07 / Questions
On your Mac. Settings, About shows the data folder, with Show in Finder. Your keys are kept in the macOS Keychain.
With a local model, chatting works offline. Anything that reads the web, an online AI service, or an app that fetches news or prices needs a connection.
A small notice beside Settings in the sidebar tells you when an update is ready. Nothing installs until you say so. Choose how Vakyartha checks in Settings, General, Updates.
A local model runs on your Mac at no charge. An online AI service you connect may charge you; Settings, FinOps shows what each answer is likely to cost.
macOS on Apple Silicon. Windows and Linux are not available yet.
To remove your keys, use Remove for each one in Settings, Providers. Note the data folder in Settings, About, then quit Vakyartha and move it to the Trash. To remove your chats and app data too, delete that data folder.