What is Avelyn?
Everything you need to know about the local offline AI assistant: privacy, capabilities, and integrations.
Q.What is Avelyn?
Avelyn is a hybrid, privacy-first AI writing assistant specifically designed for macOS. It integrates system-wide, allowing you to highlight text in any application (like Chrome, Slack, Word, or VS Code), hit a customizable global keyboard shortcut, and refine or rewrite your prose instantly using local offline models or secure cloud APIs.
Q.Is the application safe to use?
Yes, this utility is highly secure. Unlike traditional cloud writing assistants that stream your inputs to remote servers, Avelyn operates with zero background keylogging. In local mode, calculations run in-memory without network requests. In cloud mode, your API keys are stored locally and fully masked inside settings to prevent over-the-shoulder leaks.
Q.Is it completely offline?
Yes. When configured with local offline engines like Ollama, the assistant operates 100% offline. No active internet connection is required to rewrite, format, translate, or proofread your text, making it ideal for air-gapped workstations or sensitive corporate environments.
Q.How does the hybrid multi-provider architecture work?
Avelyn supports Local Ollama, Avelyn Cloud (OpenRouter), and Custom API endpoints. In 'Auto Provider' mode, it automatically routes tasks based on classification and text size (e.g. sending coding tasks to the Coding Provider, and long texts to the Writing Provider), with automatic fallbacks if a provider goes offline.
Q.Can I cancel generations or customize context limits?
Yes. Avelyn includes immediate query cancellation to halt model streams instantly, saving local CPU/GPU cycles and API tokens. You can also configure the active context window size (such as 2,048 or 4,096 tokens) in settings to prevent system RAM pressure.
Q.Why is the system different from cloud alternatives?
The system is different because it is built from the ground up for complete data sovereignty, zero keylogging, and multi-provider flexibility. Rather than locking you into one vendor, Avelyn lets you combine local open weights models with secure pay-as-you-go cloud APIs.
Q.What macOS versions are supported?
The software supports macOS 13 (Ventura), macOS 14 (Sonoma), and macOS 15 (Sequoia) or newer. It is optimized to run on both Intel-based Macs and Apple Silicon machines (M1, M2, M3, M4 series), though Apple Silicon is highly recommended for faster token generation and lower memory latency during local LLM model execution.
Q.Can I connect custom OpenAI-compatible models?
Yes. By choosing the 'Custom API' provider, you can connect LM Studio, vLLM, or any private OpenAI-compatible endpoint. Simply input your base URL, API key, and model ID inside the settings panel.
Q.Is there any background network tracking?
Absolutely not. The application code is built with zero telemetry dependencies. It does not contain analytic tracking scripts, error reporting mechanisms that connect to external endpoints, or remote config fetching. Your texts, keys, and logs remain strictly on your local device.
Detailed Security Architecture Overview
To fully establish trust, the application uses local macOS sandboxing rules that restrict standard network bindings. Unlike typical macOS writing assistants that maintain active HTTP connections to send text packets to remote cloud queues, this utility enforces static isolation.
When a user triggers the global shortcut command palette, the local memory buffer is temporarily filled with the copied text selection. The text block is analyzed locally, processed using CPU or GPU acceleration, and pasted back. The clipboard cache is immediately cleared, preventing data leakage across applications.
Additionally, our offline AI assistant on macOS utilizes advanced OS level security permissions. The utility requires Accessibility permissions solely to communicate with open editors via standard UI scripting interfaces. It does not monitor keyboard interrupts in the background when inactive, meaning it never functions as a keylogger. This is a critical distinction for anyone comparing privacy-focused tools to cloud alternatives.
The architecture is also fully compatible with corporate VPNs, firewall rules, and air-gapped systems. Since all network requests are blocked by the system-level sandbox, security operations center (SOC) analysts can verify that no outbound traffic packets are generated during editing. This allows immediate onboarding in financial institutes, medical software editing desks, and aerospace development firms.
By decoupling local rewriting from the cloud, users can confidently edit proprietary source code, internal spreadsheets, and confidential emails without violating company compliance frameworks or security protocols. To see how this compares to cloud alternatives, view our detailed comparison guides:
- Explore the Avelyn vs ChatGPT: Local ChatGPT Alternative Guide.
- Explore the Avelyn vs Grammarly: Privacy-First Grammarly Alternative Guide.
- Learn about native optimizations in the About Avelyn Philosophy Page or review model integrations in the Avelyn AI Integration Page.
Ready to enhance your writing locally?
Get started with this privacy-first assistant for macOS and run Llama 3 or Gemma 3 offline today.
Apply for Beta Access