Swipeer Documentation
Welcome to the command center. Swipeer is more than just a chat window—it's a local-first, model-agnostic workspace designed to bridge the gap between AI and your actual files.
Your chat-history, notes, and knowledge-base data is only stored locally on your device.
Use your own OpenRouter keys or run Swipeer offline with Ollama for unlimited access without credit limits.
Quick Installation
Swipeer is a high-performance native desktop application built with Electron. Follow the instructions for your operating system:
Run the .exe installer and follow the wizard.
Drag Swipeer.app to your Applications folder.
Make the AppImage executable and launch.
Permissions
On Linux, you may need to run: chmod +x Swipeer-v1.0.0.AppImage
Quickstart Setup
Get up and running with Swipeer in less than two minutes. Follow these simple steps to start boosting your productivity immediately.
1 Activate your License
Once you have purchased a license or registered for the Free Tier, you will receive an email containing your License Key. Open the app, go to Settings ➔ License, paste your key into the text field, and click Activate.
2 Set up AI Providers (Optional)
All users have access to cloud models out of the box using their Swipeer credits. However, if you are a Pro or Business user and want to use your own API keys via OpenRouter (BYOK), or if you want to use local models via Ollama, navigate to Settings ➔ Providers to enter your details. Check the OpenRouter section for more info.
⚡ The Most Important Step: Use the Shortcut!
Swipeer is designed to be your instantly accessible assistant. You don't need to keep the app window open in the background. Simply press the global shortcut:
This will instantly summon Swipeer on top of any application you are currently using, without breaking your flow. .
OpenRouter
OpenRouter
OpenRouter is our recommended provider for accessing unlimited usage with your own API key.
Go to Keys under your profile and generate a new key for Swipeer.
Go to Settings ➔ Providers, expand OpenRouter, paste the key, and activate the checkbox. Save and you are ready!
Important Note: You can either have OpenRouter OR your Swipeer Credits activated, but not both at the same time. If you check the box to activate OpenRouter, Swipeer will route requests through your OpenRouter key instead of your Swipeer subscription logic.
Why OpenRouter?
- ✔ Access models from 10+ different companies
- ✔ Pay only for what you use at wholesale prices
- ✔ No monthly subscriptions for each model
Local Privacy & Cloud: Ollama
Run local models like Qwen or Mistral entirely on your own machine, or connect directly to Ollama Cloud. For more information, visit Ollama.
Option 1: Complete Local Privacy
Requires powerful GPU
Option 2: Ollama Cloud (Local Proxy)
Run massive models without draining your own GPU resources. Sign in via your terminal, and your local Ollama daemon will securely route requests to the cloud.
In Swipeer, leave the Endpoint URL as
http://localhost:11434 (no API key needed).
Note: You need to run models via terminal (e.g. 'ollama run gemma3:4b' or
'ollama run
glm-5:cloud') once before they appear in Swipeer.
Also note that Ollama Cloud has usage limits which you can view at ollama.com/settings.
Option 3: Direct API / Custom Remote Servers
If you don't want to run Ollama locally at all, or if you have your own secured remote VPS server, you can configure Swipeer to connect directly.
- Go to Settings ➔ Providers
- Change the Endpoint URL to your server or
https://ollama.com - Enter your API Key / Token if the server is secured.
Swipeer automatically fetches all models available to your account!
Swipeer automatically pings
http://127.0.0.1:11434 by default. If you run Ollama on a different port,
update the URL in Settings ➔ Providers.
Chat History
Never lose a conversation again. Access your entire chat history via the folder icon in the sidebar. Use the search bar to find specific discussions instantly.
System Prompt (Persona)
Define the personality and behavior of your AI. Set a global instruction like "You are a Senior React Developer who prefers functional programming" to ensure every new chat starts with the right context and tone.
Smart Templates
Save and reuse your most powerful prompts. Type any character in the chat input to trigger the autosuggestion process and press TAB or Enter to add your template to the chat.
Built-in Presets:
Notes & Knowledge Base
A built-in Markdown Editor for your documentation, code snippets, and ideas. But it's more than just notes—it's your AI's long-term memory.
Context Injection
Toggle "Knowledge Base" on any note to strictly inject it into the AI's context window. Perfect for project requirements, API documentation, or coding guidelines.
100% Local & Private
Your notes never leave your machine (unless you choose a cloud model). No vector databases, no complex setup—just pure text context.
Web Links
Store your most-used URLs directly within Swipeer. Whether it's documentation, Jira boards, or staging environments, keep your important links just one click away without cluttering your browser bar.
HTTP Automations
Swipeer includes a built-in HTTP client (similar to Postman/Insomnia) that allows you to trigger external events or send data to other apps via webhooks and APIs.
Supported Methods
- → GET
- → POST (JSON / Form Data)
- → PUT / PATCH
- → DELETE
Advanced Auth
- → Bearer Token
- → Basic Auth
- → Custom API-Key Headers
Integration Examples
n8n / Make.com: Send data to a webhook to start a complex workflow (e.g., creating a JIRA ticket, saving a note to Notion, or emailing a summary).
Local API Testing: Test your developer endpoints without leaving the context of your AI pair-programmer.
Full Settings Reference
| Category | Features |
|---|---|
| GUI & Layout | Theme selection (Light/Dark), Font scaling (80% - 150%), Window staying behavior, and language selection. |
| License | Enter your key, check credit consumption, and see feature locks for Starter/Pro tiers. |
| Providers | Configure OpenRouter keys and custom Ollama endpoints. This is the heart of your AI engine. |
| Profile (Backup) | Export/Import your configuration. Perfect for transferring your setup to a new machine or backing up your templates. |
Keyboard Shortcuts
Speed up your workflow. Click the keyboard icon at the bottom of the sidebar to view a live map of all available shortcuts, including quick-create commands, window toggles, and navigation keys.