Authentication

KARIANA uses a token-based authentication system that supports both online and offline use. After your initial sign-in, the plugin works offline for up to 30 days before requiring re-authentication.

How it works

1. First launch — The plugin shows two options: "Login to Kariana" and "Setup Local Model"
2. Login to Kariana — Opens your browser to sign in via Google or email
3. After sign-in — A license token is saved locally on your machine
4. Offline use — The plugin validates your token locally, no internet needed
5. After 30 days — The plugin asks you to sign in again to refresh your token

First-time setup

On your first launch, you must have an internet connection to authenticate. After that, KARIANA works fully offline.

If you select "Setup Local Model" without having authenticated first, you'll see a message asking you to connect to the internet and log in.

Subscription expired

When your token expires (after 30 days) or your subscription lapses, the plugin shows "Your subscription seems expired!" with a button to log in again. This is the same screen whether you're online or offline — click Login to Kariana when you have internet access to renew.

Using a local model

After your initial authentication, you can use KARIANA with a local LLM (LM Studio, Ollama) without internet. The plugin only needs internet for:

• First-time authentication
• Token renewal (every 30 days)
• Cloud AI providers (Claude, AWS Bedrock)

Token storage

Your authentication token is stored locally on your machine in a per-user application-data directory. It contains your user ID, subscription tier, and expiration date, and is cryptographically signed to prevent tampering.

Troubleshooting