> ## Documentation Index
> Fetch the complete documentation index at: https://cheetahai.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> System requirements and installation guide for Cheetah AI

## System Requirements

### macOS (Apple Silicon)

| Requirement      | Minimum            | Recommended |
| ---------------- | ------------------ | ----------- |
| Operating System | macOS 11 (Big Sur) | macOS 13+   |
| Processor        | Apple Silicon (M1) | M2/M3/M4    |
| Memory           | 8GB RAM            | 16GB RAM    |
| Storage          | 500MB              | 1GB         |

<Note>
  Windows, Linux, and Intel Mac support is in development and coming soon.
</Note>

## Download

Download the latest version from [cheetahai.co](https://cheetahai.co).

## Installation Steps

<Steps>
  <Step title="Download the DMG">
    Download the `.dmg` installer file from the official website.
  </Step>

  <Step title="Mount the Disk Image">
    Double-click the downloaded `.dmg` file to mount it.
  </Step>

  <Step title="Install the Application">
    Drag Cheetah AI to your Applications folder.
  </Step>

  <Step title="Launch Cheetah AI">
    Open from Applications or use Spotlight (`Cmd+Space`, type "Cheetah AI").

    <Note>
      On first launch, macOS may display a security warning. Right-click the app and select "Open" to bypass Gatekeeper verification.
    </Note>
  </Step>
</Steps>

## Account Setup

After installation, complete the following steps to activate your account:

1. Launch Cheetah AI
2. Click "Sign In" on the welcome screen
3. Authenticate with Google or GitHub
4. Your subscription will be automatically activated

## Automatic Updates

Cheetah AI checks for updates automatically on launch. When an update is available:

1. A notification appears in the status bar
2. Click to download the update
3. Restart the application to apply changes

You can also manually check for updates via the application menu.

## Uninstalling

To remove Cheetah AI from your system:

1. Quit Cheetah AI if running
2. Drag Cheetah AI from Applications to Trash
3. Optionally, remove configuration data from `~/.cheetah-ai/`

## Troubleshooting

<AccordionGroup>
  <Accordion title="Application won't open - 'damaged' or 'unidentified developer' error">
    This occurs when macOS Gatekeeper blocks unsigned applications.

    **Solution 1:** Right-click the app and select "Open", then click "Open" in the confirmation dialog.

    **Solution 2:** Run the following command in Terminal:

    ```bash theme={null}
    xattr -cr /Applications/Cheetah\ AI.app
    ```
  </Accordion>

  <Accordion title="Application crashes on launch">
    Try the following steps:

    1. Delete the application from Applications
    2. Remove the configuration folder: `rm -rf ~/.cheetah-ai`
    3. Download a fresh copy from cheetahai.co
    4. Reinstall the application
  </Accordion>

  <Accordion title="Sign-in issues">
    If you're having trouble signing in:

    1. Ensure you have a stable internet connection
    2. Try signing in with a different authentication provider
    3. Clear browser cookies if using OAuth redirect
    4. Contact support at [support@cheetahai.co](mailto:support@cheetahai.co)
  </Accordion>
</AccordionGroup>