Table of Contents
Promptly is an AI Chat app designed specifically for Wear OS devices, allowing you to interact with various AI models directly from your smartwatch. It offers a seamless and intuitive way to get quick answers, generate creative text & images, and manage your AI conversations on the go. The companion phone app facilitates transferring your API key to your Wear OS device.
Promptly provides a comprehensive set of features to bring the power of AI to your wrist:
- ✨ Multi-AI Provider Support: Connect to and switch between various AI providers, Gemini, OpenAI, Anthropic, Grok, & Ollama, allowing you to leverage different models for diverse needs.
- 🗣️ Voice and Keyboard Input: Easily input prompts using your voice or the on-screen keyboard for quick and convenient interaction.
- ✍️🖼️ Text and Image Generation: Generate both text-based responses and images directly from your smartwatch, expanding the possibilities of AI interaction.
- 📚 Conversation History: Keep track of your past interactions with AI, allowing you to review and revisit previous prompts and responses.
- 🧠 Persistent Memory: Enable the AI to remember specific information across conversations, leading to more personalized and contextually aware interactions.
- 🎭 Customizable Personas: Define unique roles or styles for the AI to adopt, influencing its tone and behavior to match your preferences.
- 🔧 Flexible Settings: Configure various aspects of the app, including AI model parameters (e.g., temperature, max tokens), history retention, and API key management.
- 📱 Companion Phone App: Transfer API keys from your phone to your watch, simplifying the setup process.
text_generation.webm
image_generation.webm
Important: Promptly requires you to provide your own API keys for the AI providers you wish to use. The app will not function without valid API keys.
- Obtain API Keys from various AI Providers: Gemini, OpenAI, Anthropic, Grok, Ollama. When using Ollama, an API key is optional/not required.
- Install Promptly Wear OS App: Download Promptly from the Google Play Store on your Wear OS device.
- Install Promptly Companion Phone App: Download the Promptly companion app on your Android phone. This makes sending your API key to your watch fast and easy.
- Send API Keys to Watch:
- Once you have your API key from one of the providers above we need to transfer the API key to your phone and then use the Promptly companion phone app to send the keys to your watch.
- The easiest method to do that is to use Google Keep https://keep.google.com
- Using a web browser, create a new note in Google Keep https://keep.google.com
- Paste your API key in the note
- On your Android phone install Google Keep on Android
- Open Keep on your Android phone and you should see the note with the API key, if not give it a few minutes to sync
- Highlight the entire API key and copy it to the clipboard
- Open the Promptly companion phone app
- Make sure the watch show Watch Connected, if the watch doesn't show connected make sure Promptly is open and running on your Wear OS device.
- Select your AI provider you have an API key for in the Promptly phone companion app
- Paste your API key and click Send to watch
- Verify API Keys on Watch:
- Open Promptly on your Wear OS watch
- Tap Settings (⚙️ icon in the bottom left)
- Tap AI Providers
- Tap the AI provider you have an API key for
- Tap Configure API Key
- You should see part of your API key you sent with from the companion app, first few and last few characters
- Tap Verify
- Your key should show Verified if everything is working. If this fails, verify you have the correct AI provider selected and that you have the correct API key sent to the device.
- Start Chatting: Once your API keys are verified, you can start interacting with your chosen AI models directly from your Wear OS device, by navigating back to the home screen of the Promptly Wear OS app
[Link to Google Play Store (Coming Soon!)]
[Link to Google Play Store (Coming Soon!)]
This section provides a comprehensive guide to all features and settings within the Promptly app on your Wear OS device.
|
Prompt Button: Tap to initiate voice input for your prompt or on-screen keyboard. Speak clearly, and the app will transcribe your words into text. You can also swipe up or down on the prompt button to cycle between recent models. Settings Cog: Access the main application settings, where you can configure AI providers, history, memory, and other app preferences. Cycle AI Providers: Cycle between the enabled AI providers. History Icon: Navigate to your prompt history, allowing you to review past conversations and AI responses. |
 |
Enable/Disable: Each AI provider can be enabled or disabled. To enable a provider, you must first add and verify a valid API key. Configure API Key: Add or Remove an API Key Change Model: Within a provider's settings, tap "Model" to select a different AI model if available. Different models may offer varied performance or capabilities. Model Settings: Temperature and max tokens. |
 |
Enable/Disable History: Toggle the Enable/Disable option in the History settings to control whether your conversations are saved locally on the watch. Configure Max History Items: Use the "Max History Items" slider to set the maximum number of past conversations the app will store. Older items will be automatically removed when this limit is reached. Clear History: Tap "Clear History" in the History settings to permanently delete all stored conversation history from your watch. This action cannot be undone. |
 |
What is Memory?: The memory feature allows the AI to retain specific pieces of information across different conversations. This helps the AI provide more personalized and contextually relevant responses over time. Add Memories: Tap "Add Memory", then type in any key information, facts, or preferences you want the AI to remember. Save your entry to add it to the AI's long-term memory. Delete Memories: Will remove all memories from the AI's long-term memory. This action cannot be undone. |
 |
Overview: Personas enable you to define a specific role, style, or set of characteristics for the AI. The app automatically incorporates your active persona into every prompt, influencing the AI's tone and behavior. |
| Overview: Change the look and feel of the app by selecting a theme that best suits your style. |
 |
Revert all application settings: Revert all application settings, including AI provider configurations, API keys, history, memories, and personas, back to their default factory values. Please note that this action is irreversible and will clear all custom data. |
- DNS lookups fail for locally hosted Ollama - Promptly can access the Internet via cellular, WiFi, or Bluetooth over your phone when accessing AI providers. However, there is a limitation of Wear OS where it will fail to do DNS lookups for hostnames within RFC1918 IP space (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16) when using only Bluetooth over your phone, this limitation does not exist when using cellular or WiFi. You may run into this if you are hosting Ollama locally and your watch is connected to your phone via Bluetooth with WiFi or cellular disabled/off. The work around for this is to either disconnect Bluetooth and use WiFi or cellular, or instead configure the Ollama URL to use IP address rather than hostname/fqdn.
-
How can I generate images? - Go to Settings, AI Providers, select your provider, Change Model, select an image generating model. On the Home Screen tap the provider and input a prompt. Sometimes you may have to phrase your request as "Generate an image of ..."
Supported image generation models:
- Gemini: imagen-3.0-generate-002, gemini-2.0-flash-preview-image-generation, gemini-2.0-flash-exp-image-generation
- OpenAI: gpt-image-1, dall-e-2, dall-e-3
- Anthropic: N/A - no image models available
- Grok: Coming Soon...
- Ollama: Coming Soon...
-
The companion phone app says "Watch Disconnected" - Verify Bluetooth is enabled on your Android phone and your Wear OS device. Open the Google Pixel Watch app, also called "Watch", on your Android phone and verify your watch shows as "Connected" then try again. Make sure Promptly is also running on your Wear OS device.
-
No AI Providers Enabled - This means you need to have a verified API key and then enable the AI provider. See getting started section above.
-
API key verification fails - Make sure you are sending the entire API key, it must be exactly as it is provided to you from the AI provider.
- AI generated videos
- Additional AI providers and models
See the open issues for a full list of proposed features (and known issues).
Project Link: https://github.com/tuxthepenguin84/promptly