Skip to main content
Find answers to the most common questions about setting up and using Aether. If your question isn’t covered here, check the Troubleshooting page or open an issue on GitHub.
  • Android: Android 8.0 Oreo (API 26) or higher on arm64-v8a devices.
  • iOS & macOS: iOS 15.0+ / macOS 12.0+, currently available via TestFlight and coming soon to the App Store.
Aether itself is free and open-source under the GPL-3.0 license. You only pay for the LLM API usage charged directly by your chosen provider (OpenAI, Anthropic, etc.). Aether does not add any fees or markups.
Yes. API keys are stored in Aether’s private app storage on your device and sent only to the respective provider’s API endpoint when you make a request. Aether has no servers of its own and never receives or logs your keys.
The AI chat features require an internet connection to reach LLM provider APIs — the models themselves run in the cloud. However, the Alpine Linux runtime and shell tools work fully offline once the environment has been initialized, so you can run local scripts and commands without a connection.
Aether ships with an Alpine Linux arm64 root filesystem that runs via proot — a user-space tool that emulates a Linux environment without requiring root access. This gives the AI agent a real Linux shell where it can execute commands, install packages with apk, and use standard UNIX tools to complete tasks.
No. Root access is not required. Agent Mode can use Shizuku, which uses Android’s ADB (Wireless Debugging) interface to grant elevated permissions without rooting your device. Experimental Root authorization is also available as an alternative.
Yes. The built-in Alpine Linux runtime handles shell-tool use cases — file manipulation, scripting, package installs — without either app. Termux is required for Termux commands and by the current Agent Mode setup; Shizuku is one of the two Agent Mode authorization methods.
Extensions are packages that add new tools, UI surfaces, or application behaviors to Aether. They can be TypeScript scripts (interpreted at runtime by the Pi framework) or compiled Kotlin/DEX native mods (injected directly into the app as a Compose or WebView UI layer). A single extension package can extend the Pi agent and inject native UI into Aether at the same time. See the Extension Developer documentation for details on building your own.
Chat history is stored in a local database inside Aether’s private app storage on your device. It is never synced to any server, cloud service, or Aether infrastructure. Your conversations stay on your device.
Download the latest APK from the GitHub Releases page (or grab a nightly build from Nightly Link) and install it over your existing version. Android will perform an in-place upgrade that preserves all your data, settings, and chat history.