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

# Быстрый старт

> Установите и подключите Linkly AI за несколько минут

Это руководство поможет создать первую локальную базу знаний для ИИ.

<Tip>Если ваш ИИ умеет выполнять команды, отправьте ему `Set up https://linkly.ai/docs/ru/agent-setup.md`. Он прочитает [руководство для агентов](/docs/ru/agent-setup) и проведёт через установку и проверку.</Tip>

## Перед началом

<CardGroup cols={2}>
  <Card title="Linkly AI Desktop" icon="desktop" iconType="duotone">Индексирует документы и предоставляет поиск, структуру и чтение.</Card>
  <Card title="Linkly AI CLI" icon="terminal" iconType="duotone">Командная строка для подключения к приложению, удобная для агентов.</Card>
  <Card title="MCP Server" icon="plug" iconType="duotone">Открытый протокол доступа к контексту; запускается вместе с Desktop.</Card>
  <Card title="linkly-ai-skills" icon="wand-magic-sparkles" iconType="duotone">Официальные инструкции для агентов; настоятельно рекомендуются.</Card>
</CardGroup>

## Шаг 1. Установка

<Card title="Скачать Linkly AI" icon="download" href="https://linkly.ai/#download">Выберите свою операционную систему.</Card>

<Tabs>
  <Tab title="macOS" icon="apple"><Steps><Step title="Откройте установщик">Откройте `.dmg`.</Step><Step title="Перетащите в Applications">Перетащите **LinklyAI**.</Step><Step title="Запустите">Откройте приложение через Launchpad или Finder.</Step></Steps></Tab>
  <Tab title="Windows" icon="windows"><Steps><Step title="Запустите установщик">Откройте `.exe`.</Step><Step title="Завершите установку">Следуйте мастеру.</Step><Step title="Запустите">Откройте **LinklyAI** из меню Пуск.</Step></Steps></Tab>
  <Tab title="Linux" icon="linux"><Steps><Step title="Запустите AppImage">`bash chmod +x LinklyAI-*.AppImage ./LinklyAI-*.AppImage `</Step></Steps><Note>Нужны x86\_64 и glibc 2.35+, например Ubuntu 22.04 или Debian 12. При проблемах см. [FAQ](/docs/ru/faq).</Note></Tab>
</Tabs>

## Шаг 2. Первоначальная настройка

<Steps>
  <Step title="Пройдите мастер">На экранах cover → sign-in → preparing → get-started выберите язык и тему, примите Privacy Policy, при желании отключите телеметрию. Вход можно пропустить: локальный индекс, поиск и MCP работают без аккаунта. Дождитесь индексации примеров и нажмите Get started.</Step>
  <Step title="Добавьте свои документы"><Warning>После мастера индексируются только примеры. Без этого шага ваши файлы не появятся в поиске.</Warning>Добавьте каталоги в **Settings → Folders** или поместите файлы в `~/LinklyAI`. В macOS при нехватке прав выдайте Full Disk Access и перезапустите приложение.</Step>
  <Step title="Подключите ИИ-инструменты">Передайте помощнику запрос: <Prompt description="Установи Agent Skill linkly-ai-skills и подключи LinklyAI">Установи Agent Skill linkly-ai-skills и подключи LinklyAI. Руководство: [https://linkly.ai/docs/ru/use-skills](https://linkly.ai/docs/ru/use-skills)</Prompt> Либо настройте MCP вручную по адресу `http://127.0.0.1:60606/mcp`. Для Claude Code: `claude mcp add --transport http linkly-ai http://127.0.0.1:60606/mcp`; для Codex: `codex mcp add linkly-ai --url http://127.0.0.1:60606/mcp`. Фактический порт показан в настройках.</Step>
</Steps>

## Шаг 3. Первое использование

Индексирование занимает от нескольких минут до десятков минут. После первого запуска в фоне загружается около **710 МБ** моделей: примерно 639 МБ для семантического поиска и 70 МБ для OCR. Поиск по ключевым словам доступен сразу, семантический — после загрузки и индексации.

<Tip>Расшифровка аудио и видео по умолчанию выключена. Включите **Audio transcription** и **Video transcription** в **Settings → Index**. Подробнее: [Настройки индекса](/docs/ru/indexing).</Tip>

<Card title="Поиск через Launcher" icon="keyboard">Нажмите `⌘/Ctrl + Shift + L`, введите слова или описание. Значок L в трее: правый клик открывает Search, левый — ИИ-чат. Подробнее: [Launcher](use-launcher).</Card>

<Card title="Работа с ИИ-агентами" icon="robot">После интеграции или установки [Skills](use-skills) добавляйте к запросу `используй linkly-ai`.</Card>