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 tools (set the EXA_TOKEN to enable):
  • search_web: search via Exa in auto mode; returns up to 10 results with short summaries
  • fetch_contents: fetch page contents for one or more URLs via Exa /contents
• Structured JSON output
• Statistics for messages (provider, ttft, tps and token count)
• Import and export of chats as JSON files

TODO

• Image and file attachments
• Authentication

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
• Exa for web search and content retrieval (/search, /contents)

Getting Started

1. Copy example.config.yml to config.yml and set tokens.openrouter:

cp example.config.yml config.yml

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
• Use ![alt](url) in your message to display an image inline. If the model supports vision, the same image URL is passed to the model for multimodal input.

License

GPL-3.0 see LICENSE for details.