> For the complete documentation index, see [llms.txt](https://docs.kira.thiennguyen.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kira.thiennguyen.dev/getting-started/installation.md).

# Installation

Kira is a native macOS application shipped as a `.dmg` disk image.

## Requirements

* **macOS** (Apple Silicon and Intel are both supported; release builds are universal binaries).
* An **AWS IAM Identity Center (SSO)** start URL you can sign in to.
* For [Smart Query](/user-guide/smart-query.md) only: the `claude` CLI installed locally (optional).

## Install from a `.dmg`

1. Download the latest `kira-<version>-macOS.dmg` from [kira.thiennguyen.dev](https://kira.thiennguyen.dev).
2. Open the `.dmg` and drag **kira.app** into your **Applications** folder.
3. Launch Kira from Applications (or Spotlight: `Cmd+Space` → "kira").

## First launch

Kira is distributed outside the App Store, but release builds are **signed and notarized by Apple**, so macOS Gatekeeper opens them normally — no bypass steps are required.

The first time you open any app downloaded from the internet, macOS may show a one-time confirmation dialog. Click **Open** and Kira launches.

## Updates

Kira checks for updates in the background (by default roughly every **6 hours**) and can also check on demand. When a newer version is available, Kira offers to download and install it for you. Auto-checking and the interval can be turned off in the app's update settings.

## Next step

Continue to [SSO & First Login](/getting-started/sso-login.md) to connect Kira to your AWS accounts.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.kira.thiennguyen.dev/getting-started/installation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.