Skip to content

Files & storage ​

klars stores workspace records and artifacts on the computer running its local service. Desktop and browser clients can use the same service and store.

Service and customization files ​

Paths below are defaults. Settings shows the active configuration and customization locations when you use a custom setup.

LocationContents
~/.klars/app/The private local service data directory.
~/.klars/app/workspace.sqliteWorkspace records such as projects, conversations, captures, and runs.
~/.klars/app/artifacts/Saved graph artifact files.
~/.klars/app/server.jsonPrivate discovery record for the running service.
~/.klars/app/secrets/Encrypted credentials and vault key material.
~/.klars/config.yamlGlobal klars configuration.
~/.klars/ui/Theme, layout, custom CSS, and customization history.
<project>/.klars/project.yamlProject configuration when saved through klars.

~ is your user home directory, including on Windows. Local project source stays in the folder you opened. GitHub sources are cloned into a managed folder on the service machine.

Change a location ​

  • KLARS_DATA_DIR or klars serve --data-dir PATH selects a service store.
  • KLARS_HOME selects the global configuration/customization home; it does not by itself move the service store.
  • KLARS_CONFIG selects a global configuration file.
  • KLARS_PYTHON selects a service Python interpreter at launch.

A custom data directory has its own service discovery. Training processes relying on the default discovery record will need an explicit address and credential.

Desktop logs ​

PlatformService log
macOS~/Library/Application Support/klars/service.log
Windows%APPDATA%\klars\service.log

These logs belong to the desktop host. A terminal-launched klars serve reports startup diagnostics in that terminal.

Local view preferences ​

Theme choices, onboarding tips, panel preferences, and project resume markers use browser-profile storage. They can differ between browser profiles or between desktop and browser even when workspace records come from the same service.

Resetting a view preference is different from deleting the service store. Automatic cloud synchronization is not provided.

Back up deliberately ​

Quit the owning app or stop klars serve before copying its private data directory. Keep your project source and required model files with your normal project backups. Protect credential material and backups with the same care as the original store.

Use Export graph for a selected graph artifact and customization Export for appearance settings; neither is a complete workspace backup.

Your models. Your machine. Your next idea.