Начать · 0.8.1

Установка Admingen

Установите готовый генератор, настройте команды в терминале и переходите к первому проекту.

На этой странице

Admingen распространяется готовыми сборками. Вам не нужно собирать генератор из исходников.

Есть два варианта запуска:

Поставка Как работает
Бинарники admingen и admingen-cli Admingen открывает UI в браузере; CLI работает с тем же проектом из терминала
Desktop-пакеты Отдельное приложение для Linux или macOS; их версии публикуются своими релизными каналами

Скрипт ниже устанавливает бинарники, а не Desktop-приложение. Для генерации им не нужны Go, Node.js или Docker. Эти инструменты понадобятся для сборки и запуска созданного проекта; список есть в локальной разработке.

Для начала работы через интерфейс установите Desktop-пакет: после запуска доступны создание проекта и выбор существующей папки. Браузерные бинарники и CLI ниже — альтернативный способ запуска той же модели.

Desktop-поставка

Linux Desktop публикуется в .deb, macOS — в .dmg и .zip, отдельно для Intel/AMD и ARM64. Их публикация не связана с обновлением бинарного install.sh: новая версия одного канала не означает, что все остальные уже выпущены. Выбирайте фактически опубликованный пакет своего канала и архитектуры. Для Ubuntu/Debian скачанный .deb устанавливается командой sudo apt install ./ИМЯ_СКАЧАННОГО_ФАЙЛА.deb; это локальный пакет, не настроенный APT-репозиторий.

На macOS откройте .dmg и установите приложение стандартным способом. Если система блокирует файл, проверьте источник загрузки и используйте настройки Privacy & Security; системную защиту целиком не отключают. Десктопный интерфейс и браузерный бинарник работают с теми же проектами, но устанавливаются разными способами.

Установить бинарники через curl

Откройте терминал в любой удобной папке:

curl -fsSL https://downloads.admingen.dev/install.sh -o install-admingen.sh
bash install-admingen.sh

Первый вызов сохраняет официальный установщик на компьютер, второй запускает его. Скрипт выбирает ОС/процессор, скачивает опубликованную версию, проверяет checksum и устанавливает обе программы в ~/.local/bin. Sudo не нужен. Файл можно оставить для следующих обновлений.

Установщик предложит добавить каталог в PATH и покажет, какие shell-файлы изменит. По умолчанию ответ — No; изменение выполняется с вашего согласия. После согласия откройте новый терминал:

admingen --help
admingen-cli --help

При отказе добавьте каталог вручную в свою конфигурацию оболочки:

export PATH="$HOME/.local/bin:$PATH"

Обычно это ~/.zshrc для zsh или ~/.bashrc для Bash. Для текущего терминала выполните эту строку отдельно.

Другие параметры установщика:

Параметр Назначение
--version VERSION Установить конкретную опубликованную версию; замените VERSION, например на 0.8.5, если она доступна в выбранном источнике
--install-dir "$HOME/bin" Выбрать другой каталог
--configure-path Явно разрешить настройку PATH без вопроса
--no-modify-path Не менять shell-файлы
--base-url HTTPS_MIRROR Указать другой HTTPS-источник сборок

Скачать архив вручную

Выберите платформу:

Компьютер PLATFORM
macOS Apple Silicon darwin_arm64
macOS Intel darwin_amd64
Linux Intel/AMD 64-bit linux_amd64
Linux ARM64 linux_arm64

Ниже пример для Linux Intel/AMD. Замените PLATFORM своим значением из таблицы. VERSION получает номер текущего опубликованного бинарного выпуска из текстового файла latest.txt:

DOWNLOADS=https://downloads.admingen.dev
PLATFORM=linux_amd64
VERSION=$(curl -fsSL "$DOWNLOADS/latest.txt")
ARCHIVE="admingen_${VERSION}_${PLATFORM}.tar.gz"
curl -fL "$DOWNLOADS/releases/v$VERSION/$ARCHIVE" -o "$ARCHIVE"
mkdir admingen-unpacked
tar -xzf "$ARCHIVE" -C admingen-unpacked
cd admingen-unpacked
chmod +x admingen admingen-cli
./admingen --help

Контрольные суммы выпуска находятся по адресу $DOWNLOADS/releases/v$VERSION/checksums.txt. Скрипт быстрой установки проверяет их автоматически. Если скачивание завершилось ошибкой, не продолжайте распаковку старого файла с тем же именем.

Для запуска из любой папки скопируйте оба файла в выбранный каталог PATH:

mkdir -p "$HOME/.local/bin"
cp admingen admingen-cli "$HOME/.local/bin/"

Первый проект и обновление

Перейдите к первому проекту: создайте каталог, откройте UI и настройте модель. При браузерном запуске оставляйте терминал с admingen открытым; Ctrl+C останавливает его.

Для обновления бинарников закройте редактор и снова запустите bash install-admingen.sh. Если скрипт удалён, скачайте его заново командой выше. При ручной установке замените оба бинарника из нового архива. Desktop обновляйте пакетом своего канала.

Замена генератора не меняет ваши проекты или БД автоматически. Generate, миграции и deploy выполняются отдельно.

Если установка не запускается

  • command not found — проверьте PATH или запускайте ./admingen из каталога бинарника.
  • Permission denied — проверьте исполняемый флаг chmod +x.
  • Exec format error / Bad CPU type — выбран архив другой ОС или архитектуры.
  • 404 — проверьте адрес источника и опубликованную версию. Не заменяйте номер случайным и не продолжайте установку из неполного скачивания.

Homebrew и отдельный APT-репозиторий — самостоятельные способы распространения; эта инструкция не требует их настройки.

Аккаунт и оформление

Desktop-приложение открывает выбор или создание проекта независимо от папки, из которой вы его запустили. В меню приложения Appearance → System / Light / Dark выберите оформление по настройке ОС, светлую или тёмную тему.

Обычная работа с моделью доступна без аккаунта в пределах лимита сущностей. Вход в Account нужен для AI Model, Admin editor и увеличения модели сверх лимита. Аккаунт Admingen не заменяет пользователей приложения, которое вы создаёте. См. вход по email.