Where Totsum keeps its files

Everything Totsum writes stays on your device. This page lists where, so that you can back it up, move it or delete it. Nothing here is encrypted by Totsum itself; the protection of these files is that of your user account and your disk.

The folders

AI models, the prompt cache, the licence key and the hardware-tuning file

• Windows: C:\Users\<account>\.totsum\
• macOS: ~/.totsum/

Diagnostic logs, the default workspace folder, the problem reports you prepare to send us, and the setup helper’s record of the licence-agreement confirmation

• Windows: %APPDATA%\Totsum\
• macOS: ~/Library/Application Support/Totsum/

Crash-recovery snapshots

• Windows: %LOCALAPPDATA%\Totsum\autosave\
• macOS: ~/Library/Application Support/Totsum/autosave/

Preferences, and the in-application record of the licence-agreement confirmation

• Windows: the registry key HKEY_CURRENT_USER\Software\Totsum\TotumData
• macOS: ~/Library/Preferences/com.totsum.TotumData.plist

Workspace files (.totsum) and exports are saved where you choose. The workspace file page describes what a saved workspace contains.

What the files hold

The licence key is a text file in the .totsum folder. It carries the e-mail address it was issued to.

The prompt cache lives in a kv_cache folder inside .totsum. It holds tokenised prompt prefixes and model state that speed up the AI model, and it may therefore contain fragments of your questions, of your table and column names, and of your data values. Its default maximum size is 5 GB; when that limit is reached, the oldest entries are replaced. You can delete the folder at any time, and Totsum rebuilds it as you work.

The crash-recovery snapshots are written while a session is open: the tables you loaded, as Parquet files, and a small session file that names your computer. A normal exit removes them. At most two abandoned sessions are kept.

The diagnostic logs are in a logs folder. In ordinary builds, error records are stripped before they are written: Totsum keeps the type of error and the code locations, and drops the error message and the source line, either of which could quote a file name, a column name or a value from your data. The log can name the folder where the model file lives, which contains your account name.

The report branding you enter, that is your logo, your organisation’s name and the names you type as prepared for and prepared by, is stored with the preferences, so that your next report starts with it.

The trial usage record

While you use the free trial, Totsum counts the questions asked since installation, in order to apply the trial’s cap. The record holds that number and a value used to detect editing, and nothing else. To make casual resetting harder, it is written to more than one place, and the highest valid value counts:

• trial_usage.json in the .totsum folder, on both systems;
• on Windows, a usage_stamp value in HKEY_CURRENT_USER\Software\Totsum\TotumData and a usage.dat file in %APPDATA%\Totsum\;
• on macOS, a usage.dat file in ~/Library/Application Support/Totsum/.

Deleting one copy restores it from the others, so removing the record means removing every copy. Uninstalling does that for you: on Windows through the normal uninstaller, on macOS through the Uninstall Totsum tool that the installer places in Applications, because dragging the app to the Trash cannot run anything of ours.

Removing everything

On Windows, uninstall Totsum from Settings → Apps. On macOS, run Uninstall Totsum. Either removes the application, the trial usage record and the report branding. Models, caches, preferences and the files you created yourself may stay in place; the folders above are where to find them.