whiskr

whiskr is a private, self-hosted web chat interface for interacting with AI models via OpenRouter.

Features

• Private and self-hosted (data stored in localStorage)
• Supports any model available on your OpenRouter account
• Real-time streaming responses
• Edit, delete, or copy any message
• Persistent settings for model, temperature, and other parameters
• Full conversation control including clearing and modifying messages
• Smooth UI updates with morphdom, selections, images, and other state are preserved during updates
• Easy model selection:
  • Tags indicate if a model supports tools, vision, or reasoning
  • Search field with fuzzy matching to quickly find models
  • Models are listed newest -> oldest
• Reasoning effort control
• Web search tool
• Structured JSON output

TODO

• Statistics for messages (tps, token count, etc.)
• Retry button for assistant messages
• Import and export of chats
• Image and file attachments

Built With

Frontend

• Vanilla JavaScript and CSS
• morphdom for DOM diffing without losing state
• marked for Markdown rendering
• highlight.js for syntax highlighting
• Fonts: Inter (UI), Comic Code (code)
• Icons: SVGRepo
• Color palette: Catppuccin Macchiato

Backend

• Go
• OpenRouter for model list and completions

Getting Started

1. Copy .example.env to .env and set OPENROUTER_TOKEN:

cp .example.env .env

2. Build and run:

go build -o whiskr
./whiskr

3. Open http://localhost:3443 in your browser.

Usage

• Send a message with Ctrl+Enter or the send button
• Just add a message with the add button
• Hover over a message to edit, delete, or copy it
• Adjust model, temperature, prompt, or message role from the controls in the bottom-left
• Use the model search field to quickly find models (supports fuzzy matching)
• Look for tags in the model list to see if a model supports tools, vision, or reasoning

License

GPL-3.0 see LICENSE for details.