Скачать и установить

Эта страница поможет вам скачать, установить и впервые запустить Elftia.

Системные требования

Перед установкой убедитесь, что ваше устройство соответствует следующим минимальным требованиям:

Платформа	Минимальная версия	Архитектура
Windows	Windows 10 (64-bit) или выше	x64 / arm64
macOS	macOS 10.15 (Catalina) или выше	Intel / Apple Silicon
Linux	Ubuntu 20.04 / Fedora 36 / Debian 11 или аналог	x64

Рекомендации по оборудованию:

• ОЗУ: 4 ГБ и более (рекомендуется 8 ГБ)
• Дисковое пространство: не менее 500 МБ свободного места
• Сеть: требуется интернет-соединение для вызова LLM API

Опциональные зависимости (требуются для функций Agent):

Elftia автоматически определит наличие следующих инструментов при первом запуске. Если вы планируете использовать функции Agent (редактирование кода, файловые операции, Shell-команды и т.д.), рекомендуется установить их заранее:

Инструмент	Назначение	Загрузка
Node.js 18+	Среда выполнения MCP-сервера, выполнение некоторых инструментов	nodejs.org
Git	Управление версиями, управление проектами	git-scm.com
uv / uvx	Управление пакетами Python (требуется для некоторых MCP-серверов)	astral.sh/uv

Эти зависимости необязательны — если вам нужна только базовая функциональность AI-чата, их можно пропустить.

Скачать

Официальный сайт

Посетите страницу загрузки на официальном сайте Elftia и выберите версию для вашей операционной системы.

GitHub Releases

Вы также можете скачать последнюю или предыдущие версии со страницы GitHub Releases. Каждый релиз содержит следующие установщики:

Платформа	Формат установщика	Пример имени файла
Windows	Установщик NSIS	Elftia-Setup-x.x.x.exe
macOS	DMG-образ	Elftia-x.x.x.dmg / Elftia-x.x.x-arm64.dmg
Linux	AppImage	Elftia-x.x.x.AppImage

Шаги установки

Windows

1. Дважды щёлкните загруженный файл Elftia-Setup-x.x.x.exe.
2. Если появится предупреждение Windows SmartScreen, нажмите «Подробнее» и выберите «Всё равно выполнить».
3. Выберите путь установки (по умолчанию C:\Users\<имя пользователя>\AppData\Local\Elftia).
4. Дождитесь завершения установки. Установщик автоматически создаст ярлык на рабочем столе и пункт в меню «Пуск».
5. Нажмите «Готово», чтобы запустить Elftia.

подсказка

Elftia использует установщик NSIS с поддержкой автоматического обновления. Установленное приложение можно удалить стандартным способом через системные настройки.

macOS

1. Дважды щёлкните загруженный файл .dmg, чтобы смонтировать образ диска.
2. В открывшемся окне перетащите значок Elftia в папку «Applications».
3. При первом запуске macOS может показать предупреждение «Не удаётся проверить разработчика»:
   • Откройте «Системные настройки → Конфиденциальность и безопасность → Основные»
   • Нажмите кнопку «Всё равно открыть»
4. Elftia запустится и будет готова к использованию.

подсказка

Пользователям Apple Silicon (M1/M2/M3/M4) следует скачивать версию arm64 для оптимальной производительности. Пользователям Mac на Intel следует скачивать стандартную версию.

Linux

1. Скачайте файл .AppImage.
2. Выдайте разрешение на выполнение:

   chmod +x Elftia-x.x.x.AppImage

3. Дважды щёлкните для запуска или выполните в терминале:

   ./Elftia-x.x.x.AppImage

подсказка

Если AppImage не запускается, возможно, потребуется установить FUSE: sudo apt install libfuse2 (Ubuntu/Debian).

Первый запуск

При первом запуске Elftia вы увидите следующую последовательность:

1. Определение окружения

Elftia автоматически определит установленные инструменты в вашей системе (Node.js, Git, ripgrep, uv/uvx и др.). Результаты отобразятся в разделе «Окружение» на странице настроек — рядом с каждым инструментом будет индикатор: зелёный (установлен) или красный (не установлен).

Вы можете просматривать эти инструменты и управлять ими позднее в Настройки → Общие → Окружение. Некоторые отсутствующие инструменты можно установить прямо там, нажав кнопку «Установить».

2. Выбор языка

Elftia поддерживает три языка интерфейса:

• Упрощённый китайский
• English
• Японский

Язык по умолчанию выбирается автоматически на основе системного языка. Вы можете изменить его в любое время в Настройки → Общие → Язык.

3. Настройка LLM-провайдеров

Чтобы начать использовать AI-чат, необходимо настроить хотя бы одного LLM-провайдера. Подробности см. в Первый чат.

Отличия версии Steam

Если вы устанавливаете Elftia через Steam, обратите внимание на следующие отличия:

Параметр	Стандартное издание	Издание Steam
Способ обновления	Автоматическое обновление в приложении (electron-updater)	Обновление через клиент Steam
Путь установки	Определяется пользователем	Папка библиотеки Steam
Способ удаления	Системные настройки / Панель управления	Удаление через Steam
Функциональность	Идентична	Идентична

Версия Steam имеет идентичную функциональность со стандартным изданием; отличается только механизм обновления.

Распространённые проблемы при установке

Установщик не запускается

Windows: Проверьте, не заблокирован ли файл антивирусом. Некоторые антивирусы могут ошибочно помечать приложения на базе Electron. Добавьте Elftia в белый список вашего антивируса.

macOS: Если появляется сообщение «повреждён, не может быть открыт», выполните в терминале:

xattr -cr /Applications/Elftia.app

Linux: Убедитесь, что зависимости FUSE установлены и файл имеет права на выполнение.

Белый экран или крэш при запуске

• Убедитесь, что драйверы видеокарты обновлены до последней версии.
• Попробуйте запустить с правами администратора (Windows).
• Проверьте, не запущен ли уже другой экземпляр Elftia, и закройте его.
• Если используется старый GPU, попробуйте добавить параметр --disable-gpu при запуске.

Отсутствует .NET или Visual C++ Runtime (Windows)

В некоторых системах Windows могут отсутствовать необходимые библиотеки среды выполнения. Установите Visual C++ Redistributable и повторите попытку.

Брандмауэр блокирует интернет-соединение

Elftia требует доступа в интернет для вызова LLM API. Убедитесь, что ваш брандмауэр разрешает исходящие соединения Elftia. Для настройки прокси см. Использование прокси.

---

После завершения установки продолжите чтение Первый чат, чтобы начать ваше AI-путешествие.