Skip to main content
Kepler is a desktop app. Download the installer for your operating system from the releases page, open it, and sign in. The current version is 0.1.7-beta.

​
Download and install

Requires macOS 13 Ventura or later on Apple Silicon.
  1. Download Kepler-<version>-arm64.dmg from the releases page.
  2. Open the disk image and drag Kepler into Applications.
  3. Launch Kepler from Applications or Spotlight.

​
Verify the first launch

On first launch Kepler shows a sign-in screen. Sign in with Google, GitHub, or email through your browser. After that, Kepler asks three short questions about you (your name, where you sit in the stack, what you look after), then drops you on the chat landing where you connect a model. If you get as far as the chat landing, the install is good. The Quickstart picks up from there. To confirm the version at any time, open Settings > General > About, or on macOS use Kepler > About Kepler in the menu bar.

​
Updates

Kepler checks for a new version on its own, every few hours while it is open. Nothing installs without a click.
  • macOS and Windows: when an update is available, a pill appears in the sidebar and a row in Settings > General > Updates. Click it to download. When the download finishes, Kepler offers a restart and installs in place.
  • Linux: Kepler tells you a newer version exists and links to the release page. Install it with your package manager the same way you installed the first time.
You can also trigger a check from Settings > General > Updates.
Updating Kepler never touches your conversations, memory, or settings. They live outside the app bundle.

​
Requirements

Operating system

macOS 13 or later (Apple Silicon). 64-bit Windows. Linux with WebKitGTK 4.1 and GTK 3.

Account

A Kepler sign-in (Google, GitHub, or email). Free. It unlocks the hosted models and nothing else is required.

A model

Use the hosted Kepler models with your sign-in, or bring your own key for Anthropic, OpenAI, Google, xAI, AWS Bedrock, or any OpenAI-compatible endpoint. Ollama works for fully local models.

Your existing tools

Kepler uses what is already on the machine: kubectl and your kubeconfig, cloud CLIs, SSH config. There is nothing to install in your clusters.

​
Uninstall

Removing the app and removing your data are two separate steps. Uninstalling the app leaves your data in place so a reinstall picks up where you left off.
Quit Kepler, then drag Kepler from Applications to the Trash.

​
Where your data lives

Everything Kepler knows about you is in one folder in your home directory: ~/.kepler on macOS and Linux, %USERPROFILE%\.kepler on Windows. It holds your conversations, memory, kepler.md and preference files, watchers, workflows, artifacts, and settings. API keys and channel tokens are kept in your operating system’s keychain, not in that folder. To remove Kepler completely, delete that folder after uninstalling the app. This is irreversible: memory, session history, and every rule you taught Kepler go with it. If you only want a fresh start on memory, use Settings > Memory > Wipe memory instead and keep the rest. If you installed the optional kepler command-line helper from Settings > Experiments, it lives on your PATH and is removed separately. Run kepler help to see whether it is present.

​
Where to go next

Quickstart

Sign in, connect a model, open a workspace, ask your first question.

Troubleshooting

Kepler will not start, sign-in loops, the model is not responding.