# त्वरित प्रारंभ

## इंस्टॉलेशन

[डाउनलोड पेज](/hi/download) या [GitHub Releases](https://github.com/AQBot-Desktop/AQBot/releases) से नवीनतम इंस्टॉलर डाउनलोड करें।

### macOS

| चिप | फ़ाइल |
|-----|-------|
| Apple Silicon (M1 / M2 / M3 / M4) | `AQBot_x.x.x_aarch64.dmg` |
| Intel | `AQBot_x.x.x_x64.dmg` |

1. `.dmg` खोलें और **AQBot** को **Applications** फोल्डर में ड्रैग करें।
2. AQBot लॉन्च करें। अगर macOS ऐप को ब्लॉक करे, **System Settings → Privacy & Security** में जाएं और **Open Anyway** क्लिक करें।

> **macOS: "App Is Damaged" या "Cannot Verify Developer"**
>
> AQBot प्रोजेक्ट के अपने कोड-साइनिंग सर्टिफ़िकेट से साइन किया गया है, Apple Developer ID सर्टिफ़िकेट से नहीं। इसलिए ब्राउज़र से डाउनलोड करने के बाद भी macOS "AQBot is damaged and can't be opened" या "AQBot can't be opened because the developer cannot be verified" दिखा सकता है।
>
> पूरे सिस्टम का Gatekeeper बंद करने की ज़रूरत नहीं है — केवल AQBot को अनुमति दें:
>
> 1. Finder में Control दबाकर `AQBot.app` पर क्लिक करें, **Open** चुनें, फिर दोबारा **Open** क्लिक करें।
> 2. अगर फिर भी ब्लॉक हो, तो **System Settings → Privacy & Security** में जाएं, **Security** सेक्शन में AQBot ढूंढें और **Open Anyway** क्लिक करें।
> 3. AQBot दोबारा लॉन्च करें।
>
> Gatekeeper की अनुमति और Accessibility अनुमति अलग-अलग सेटिंग्स हैं। टेक्स्ट-सिलेक्शन टूलबार के लिए, ऐप में दिखने वाले संकेत के अनुसार **System Settings → Privacy & Security → Accessibility** में AQBot को भी सक्षम करें।

### Windows

| आर्किटेक्चर | फ़ाइल |
|------------|-------|
| x64 (अधिकांश PC) | `AQBot_x.x.x_x64-setup.exe` |
| ARM64 | `AQBot_x.x.x_arm64-setup.exe` |

इंस्टॉलर चलाएं और विज़ार्ड का पालन करें।

### Linux

```bash
# Debian / Ubuntu
sudo dpkg -i AQBot_x.x.x_amd64.deb

# Fedora / openSUSE
sudo rpm -i AQBot_x.x.x_x86_64.rpm

# AppImage
chmod +x AQBot_x.x.x_amd64.AppImage
./AQBot_x.x.x_amd64.AppImage
```

---

## प्रारंभिक सेटअप

### 1. Settings खोलें

AQBot लॉन्च करें और साइडबार के नीचे **gear आइकन** क्लिक करें, या <kbd>Cmd/Ctrl</kbd>+<kbd>,</kbd> दबाएं।

### 2. प्रदाता जोड़ें

**Settings → Providers** में जाएं और **+** बटन क्लिक करें।

1. एक डिस्प्ले नेम दर्ज करें (जैसे *OpenAI*)।
2. प्रदाता प्रकार चुनें (OpenAI, Anthropic, Google Gemini, आदि)।
3. अपनी API कुंजी पेस्ट करें।
4. **Base URL** कन्फर्म करें — बिल्ट-इन प्रकारों के लिए आधिकारिक एंडपॉइंट पहले से भरा है।

> **सुझाव**
>
> आप जितने चाहें उतने प्रदाता जोड़ सकते हैं।

### 3. मॉडल फ़ेच करें

**Fetch Models** क्लिक करें प्रदाता की API से उपलब्ध मॉडलों की सूची प्राप्त करने के लिए।

### 4. डिफ़ॉल्ट मॉडल सेट करें

**Settings → Default Model** में जाएं और प्रदाता और मॉडल चुनें जो नई वार्तालाप डिफ़ॉल्ट रूप से उपयोग करें।

---

## आपकी पहली वार्तालाप

1. साइडबार में **New Chat** क्लिक करें (या <kbd>Cmd/Ctrl</kbd>+<kbd>N</kbd> दबाएं)।
2. चैट के शीर्ष पर मॉडल सेलेक्टर से एक मॉडल चुनें।
3. एक संदेश टाइप करें और <kbd>Enter</kbd> दबाएं।
4. AQBot रियल-टाइम में रेस्पॉन्स स्ट्रीम करता है।

---

## शॉर्टकट

| शॉर्टकट | क्रिया |
|---------|--------|
| <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>A</kbd> | वर्तमान विंडो दिखाएं / छुपाएं |
| <kbd>Cmd/Ctrl</kbd>+<kbd>N</kbd> | नई वार्तालाप |
| <kbd>Cmd/Ctrl</kbd>+<kbd>,</kbd> | Settings खोलें |
| <kbd>Cmd/Ctrl</kbd>+<kbd>K</kbd> | Command palette |
| <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>G</kbd> | API गेटवे टॉगल करें |

---

## डेटा और बैकअप

### डेटा डायरेक्टरी

| पथ | सामग्री |
|----|---------|
| `~/.aqbot/` | एप्लिकेशन स्टेट — डेटाबेस, एन्क्रिप्शन कीज़, वेक्टर DB, SSL सर्टिफिकेट |
| `~/Documents/aqbot/` | यूज़र फ़ाइलें — इमेज, दस्तावेज़, बैकअप |

---

## अगले कदम

- [प्रदाता कॉन्फ़िगर करें](./providers) — AI प्रदाता जोड़ें और प्रबंधित करें
- [MCP सर्वर](./mcp) — AI क्षमताओं को बढ़ाने के लिए बाहरी टूल्स कनेक्ट करें
- [API गेटवे](./gateway) — अपने प्रदाताओं को लोकल API सर्वर के रूप में एक्सपोज़ करें