Install and first run

Get Agnos from the Microsoft Store, open it for the first time, and later update or remove it.

Requirements

  • Windows 10 (version 2004 or later) or Windows 11, 64-bit.
  • about 400 MB for the program, plus room for your documents and what Agnos makes from them.
  • No administrator rights and no Python. Agnos brings its own copy.
  • An internet connection to install it and for your licence. Nothing else.

Agnos opens in its own window using Microsoft Edge or Google Chrome. If neither is installed, it opens in your default browser.

Install

Agnos comes from the Microsoft Store. Microsoft checks and signs it, so it installs with no warnings, and the Store keeps it up to date.

  1. Press Download from the Microsoft Store on the download page, or open Agnos in the Microsoft Store. The Microsoft Store opens on Agnos.

  2. Press Get. Windows installs Agnos for your account, with nothing to approve.

  3. Press Open, or find Agnos in the Start menu.

On a work computer where the Microsoft Store is turned off, ask your IT team. They can install Agnos for you with winget. Microsoft Intune can also deploy it as a free Microsoft Store app, though we haven’t tested that ourselves yet. See Install on many computers.

Where Agnos keeps things

Windows installs the program and looks after it. Your work is kept apart from it, in a folder of its own, so an update never touches your work.

FolderWhat is in it
%USERPROFILE%\AgnosYour library: the database, your files, the cleaned text, your licence and the logs.

%USERPROFILE% is your own folder, so the library is C:\Users\<you>\Agnos. Type %USERPROFILE%\Agnos into the File Explorer address bar to go there.

Agnos does not encrypt your library. If your documents are sensitive, use Windows disk encryption, such as BitLocker.

Move your library

  1. Close Agnos: open Help in Agnos and press Stop Agnos.

  2. In the Start menu, open Edit environment variables for your account.

  3. Add a variable named AGNOS_HOME set to the new folder, for example D:\Agnos.

  4. Move the contents of %USERPROFILE%\Agnos into that folder.

  5. Open Agnos.

First launch

The first time Agnos opens, it prepares its library, which can take a few minutes. Later launches are quicker.

The first screen offers two ways to start:

  • Open the sample project to try every step on five small documents. See Quick start.
  • New project to start with your own documents. See Import documents.
The Projects screen of Agnos.
The first screen: start a project of your own, or open the sample. The bottom of the menu shows the trial.

Your 14-day trial

The trial starts the first time Agnos opens, with no key and no card. For 14 days, everything in Pro works, including every kind of export.

The bottom of the menu shows the days left; press it to open the Licence page. After the trial, your projects, cleaning, Preview and Review keep working and nothing is deleted, but exporting needs a licence. See Pricing and Trial and licences.

Close and stop

Closing the window does not stop Agnos. It keeps cleaning in the background, and opening Agnos again brings the window back at once. To shut it down, open Help and press Stop Agnos.

If Agnos isn’t responding, open Settings › Apps › Installed apps, press … next to Agnos, choose Advanced options, then Terminate.

Update

The Microsoft Store updates Agnos by itself. To update at once, open the Microsoft Store, go to Library and press Get updates.

Your library and licence stay where they are. A 2.x licence includes every 2.x update.

The first time a new version opens, it backs up your database to %USERPROFILE%\Agnos\data\backups. It keeps the five most recent backups.

Uninstall

Right-click Agnos in the Start menu and choose Uninstall, or find Agnos in Settings › Apps › Installed apps.

Your library stays in %USERPROFILE%\Agnos, so reinstalling finds your work as you left it. To delete your work too, delete that folder.

Had Agnos from this website before?

Copies of Agnos from before the Microsoft Store kept their library in %LOCALAPPDATA%\Agnos. To bring your projects to the Store version:

  1. Close the old copy: open Help and press Stop Agnos.

  2. Uninstall it from Settings › Apps › Installed apps, and choose No when it asks about your library.

  3. Make a folder named Agnos in %USERPROFILE%, and move the contents of %LOCALAPPDATA%\Agnos into it.

  4. Get Agnos from the Microsoft Store and open it. Your projects and your licence are there.

Moving to a new computer? With a key bought online, first press Deactivate this device on the old computer's Licence page, so the key is free. An offline key works on one computer only, so write to us for a key for the new one. See Moving to a new computer.

Something here wrong or unclear? Tell us and we will fix the page.