HiddenAI
A macOS application that creates a floating, hideable window for interacting with OpenAI's GPT-4o. Capture screenshots, record audio, and get AI assistance directly on your desktop.
- Floating Window: Create a window that can be toggled with keyboard shortcuts (Cmd+B)
- Screenshot Analysis: Capture your screen and get AI analysis (Cmd+P)
- Audio Transcription: Record audio and transcribe with Whisper (Cmd+R)
- Text Conversations: Chat directly with GPT-4o
- Customizable Context: Configure the AI's system message for your specific needs
- Window Management: Adjust transparency, move with keyboard shortcuts, and toggle click-through mode
- macOS 12.0+
- Xcode 14.0+ (for building from source)
- OpenAI API Key
- Download the latest release from the Releases page
- Mount the DMG by double-clicking it
- Drag the HiddenAI application to your Applications folder
- Important macOS Security Note:
- Since this app is not signed with an Apple Developer certificate, macOS security features will block it
- To fix this, open Terminal and run:
xattr -cr /Applications/HiddenAIClient.app - This command removes the quarantine attribute that macOS adds to downloaded applications
- After running this command, you can open the app normally from your Applications folder
- Enter your OpenAI API key in Settings
-
Clone the repository:
git clone https://github.com/insearcher/hiddenai.git cd hiddenai -
Open the project in Xcode:
open HiddenAIClient.xcodeproj
-
Build and run the application (⌘R)
- ⌘+B: Toggle window visibility
- ⌘+R: Toggle Whisper transcription (voice recording)
- ⌘+P: Capture screenshot for AI analysis
- ⌘+Arrow Keys: Move window around the screen
- ⌘+Q: Quit application
- Click the gear icon to open Settings
- Enter your OpenAI API key
- Customize your AI context
- Adjust window transparency
The application requires the following permissions:
- Microphone: For audio recording with Whisper
- Screen Recording: For capturing screenshots
- Accessibility: For global keyboard shortcuts
- Your OpenAI API key is stored locally in UserDefaults
- Audio recordings are temporarily saved to your local disk during transcription
- No data is sent to any server except OpenAI's API (using your API key)
- The application does not collect any telemetry or usage data
This happens because macOS adds a "quarantine" attribute to applications downloaded from the internet as a security measure. To fix this:
- Open Terminal (from Applications/Utilities)
- Run this command:
xattr -cr /Applications/HiddenAIClient.app - Try opening the app again
xattr: This command manages extended attributes on files-cr: Removes (-r) all attributes recursively through the application bundle, including the quarantine (-c) attribute- This is completely safe and simply tells macOS that you trust this application
Contributions are welcome! Please see our Contributing Guide for more details.
This project is licensed under the MIT License - see the LICENSE file for details.
This project uses GitHub Actions to automate the release process. To create a new release:
- Go to the "Actions" tab in the GitHub repository
- Select the "Build and Release" workflow
- Click "Run workflow"
- Enter the version number (e.g., v1.0.0)
- Click "Run workflow" to start the build process
The workflow will:
- Build the macOS application
- Create a DMG package
- Generate a changelog based on commits since the last release
- Create a GitHub release with the DMG file attached
- OpenAI for providing the API
- The SwiftUI community for resources and inspiration