✦ Instantly

Your always-ready AI assistant for macOS.

A native macOS AI assistant that lives in a floating panel, summoned with a hotkey.
Built with SwiftUI, powered by Ollama.

Features • Getting Started • Usage • Contributing

---

Features

• ⌨️ Hotkey Activation — Summon the assistant instantly with a global keyboard shortcut.
• 💬 Floating Panel — A sleek, always-accessible chat panel that stays out of your way.
• 🤖 Ollama Integration — Chat with local LLMs privately, no data leaves your machine.
• 📎 Active App Context — Automatically detects the active app for context-aware assistance.
• 🏷️ @Mentions — Use @actions to trigger quick actions like translation, summarization, and more.
• ⚙️ Customizable Settings — Configure models, assistants, appearance, and hotkeys to your liking.
• 🌙 Dark Mode — Beautiful dark mode interface that feels native to macOS.
• 🚀 Launch at Login — Optionally start Instantly when your Mac boots up.

Requirements

• macOS 14.0+
• Xcode 16.0+
• Ollama installed and running locally

Getting Started

1. Install Ollama

   Download and install from ollama.com, then pull a model:

   ollama pull llama3

2. Clone & Open

   git clone https://github.com/duongductrong/Instantly.git
   cd Instantly
   open Instantly.xcodeproj

3. Build & Run

   Press ⌘R in Xcode. Grant Accessibility permission when prompted.

Usage

• Press your configured hotkey to summon the floating panel.
• Type a message or use @ to mention a quick action (e.g. @Translate hello world).
• The assistant responds using your locally running Ollama model — fast and private.

Contributing

git clone https://github.com/duongductrong/Instantly.git
cd Instantly
open Instantly.xcodeproj

Build and run with ⌘R. PRs and issues are welcome!

License

MIT License — see the LICENSE file for details.