Ui.Vision RPA says Hello!
Thank you for installing Ui.Vision RPA - the open-source task and test automation tool for Chrome, Edge and Firefox. Let's get started:
First: open Ui.Vision
- Chrome and Edge hide new extensions behind the puzzle-piece icon in the toolbar. Click it, find Ui.Vision RPA in the list and press the pin symbol next to it, so the Ui.Vision icon stays visible.
- In Firefox the Ui.Vision RPA icon is already in the toolbar, right next to the address bar.
- Click the Ui.Vision icon to open the side panel.
- Click the Ui.Vision icon to open the sidebar. In Firefox the toolbar icon is the only way to open it, so keep it handy.
- Switch to the AI Chat tab, choose the free Ui.Vision AI when asked, and type what you want to automate — for example "open ui.vision and click the download button". That is your first macro.
Stuck at any point? Real people answer in the Ui.Vision forum — asking there is the fastest way to get going.
New in Version 10: the AI does the work for you
Ui.Vision has always combined classic web automation with local, fast and free computer vision and OCR. On top of that foundation sit large language models — and Version 10 turns that AI from a set of commands into an assistant: the AI tab in the side panel now builds and fixes complete macros for you. Thanks to the new free Ui.Vision AI tier it works right after installation, with no API key and no signup.
Ui.Vision AI in action
The AI macro assistant: it writes and fixes your macros
Open the AI Chat tab in the Ui.Vision side panel and describe what you want in plain language — "create a macro that fills out this form" — or press Fix with AI on a macro that just failed. The assistant then works like a colleague sitting at your browser:
- It inspects the live page (the DOM) to find locators that still work on the next run.
- It writes the macro straight into the Macro tab, so you watch every command appear.
- It runs the macro, reads the log and iterates on failures until the macro works — with a cap on fix loops, so it never spins forever.
- It can capture element images itself and build image-based targets for uiv.findImage and visualAssert. The crop preview is shown right in the chat.
- It explains each action in plain language, so you can follow — and learn from — what it does.
Your own macros are safe. Everything the AI creates lands in its own AI_Chat folder. The assistant never overwrites the macros you wrote yourself.
Curious how it knows every Ui.Vision command and all the real-world automation tricks? We publish the assistant's complete, unedited instructions: The Ui.Vision AI System Prompt. That page doubles as a compact best-practices handbook for web automation — cookie-consent banners, shadow DOM, OCR text targeting, error recovery — and it shows how to replace the prompt with your own in Settings > AI > System Prompt.
Free Ui.Vision AI — no API key, no signup
The one-time setup dialog in the AI Chat tab: pick the free Ui.Vision AI, or use your own AI.
The first time you open the AI tab, Ui.Vision asks you once which AI you want to use. Both answers are good answers:
- "Use Ui.Vision AI — free, no setup needed" — we run the model for you. It is free during the V10 beta, and there is no signup and no API key to manage. Because it is a hosted service, your chat content (including the screenshots the assistant takes) is sent to our server for one purpose only: computing the AI answer. It is not stored.
- "I use my own AI — open settings" — bring your own API key, or point Ui.Vision at a model running on your own machine so that nothing leaves your computer at all. See the supported AI providers.
Either way, the macros themselves keep running 100% locally inside your browser extension. That is the point of the local-first design: the AI helps you write and repair the automation, but replaying it — the clicking, typing, image search and OCR — happens on your machine, exactly as before. You can change your choice at any time in Settings > AI.
Where to go next
- The 12 minute video tutorial - browser, Windows, Mac and Linux automation in one go
- Ui.Vision RPA User Manual - every command explained, with examples
- Install the XModules - needed for desktop automation, local file access and the PDF/OCR features
- Questions, ideas, bug reports? Meet fellow users and the team in the forum
One thing worth knowing today: your macros are stored locally in your browser, never in the cloud. That is good for your privacy, but it also means uninstalling the extension deletes them. Use Export to back up the macros you care about - Ui.Vision RPA also reminds you every seven days.