Functionality

Core Chat

Hamster AI connects to a locally running Ollama model and gives you a full chat interface. Open it with Ctrl+Shift+H or from the system tray. The personality is brief, casual, and honest — it'll push back if you're wrong and admit when it's guessing.

Model switching You can change the active Ollama model any time from Settings → General without restarting the app.
🧠

Memory & Notes

Persistent facts, to-dos, notes, and a future feature backlog — all stored locally in SQLite.

🛡️

Modes

Work, Focus, Private, and Game Safe modes that suppress tracking and notifications automatically.

⌨️

Commands

Slash commands for memory, reminders, modes, diagnostics, and more.

🪟

Mini Widget

A floating input bar and response popup so you never have to open the full chat window.

System Context

Hamster AI reads lightweight PC context to make smarter suggestions — without ever capturing your screen or keylogging.

What it readsWhat it never touches
Active app / window titleScreenshots or screen recording
CPU and RAM usageWebcam or microphone (without your permission)
Idle timeKeyboard or mouse input
Fullscreen statusGame memory or files
Whether audio is playing (if plugin enabled)Work or private session content

Greeting System

Hamster AI greets you on startup (if enabled) and occasionally afterwards — at most once every 2–4 hours. Greetings are suppressed during all protected modes. No greeting will play over a call or a game.

Example greetings:

Personality System

The personality is configured in config/personality_profiles.json. The default profile is Hamster — brief, casual, lightly cheeky, and honest. You can edit it or add custom profiles from the Settings window.

Note The personality never overrides Work Mode, Private Mode, Focus Mode, Game Safe Mode, honesty rules, or your settings.

Anti-Cheat Safety

Hamster AI is designed to be invisible to anti-cheat systems. It does not inject into game processes, hook graphics APIs, read game memory, create in-game overlays, or automate input. When Game Safe Mode activates, all plugins pause and the app exists only as a background tray process.