От идеи до готового каркаса проекта за 5–10 минут. Вместо нескольких часов настройки окружения.
StackPilot — экосистема для начинающих и продвинутых разработчиков, ускоряющая создание проектов, настройку окружения и управление сервисами. Доступна как в виде интуитивного десктопного приложения (GUI), так и в виде молниеносной консольной утилиты (CLI stkpil) — для тех, кто ценит работу в терминале!
Вместо того чтобы тратить часы на установку инструментов, настройку Docker, создание конфигураций и ручной запуск команд — StackPilot делает всё это автоматически. Благодаря Tauri приложение очень лёгкое и компактное, а встроенный CLI даёт полный контроль над созданием и запуском проектов прямо из вашей любимой консоли.
Статус: активная open-source разработка, постепенный выпуск. Полностью бесплатно.
Warning
StackPilot выходит постепенно. На текущем этапе полностью поддерживается Windows; сборки для Linux и macOS публикуются в Releases, но версия для Windows самая стабильная.
Пока сборки не подписаны доверенным сертификатом, Windows SmartScreen может предупредить о «неизвестном издателе» — это ожидаемо, просто нажмите «Подробнее» → «Выполнить в любом случае». Подробнее — в разделе Установка и запуск.
Добавление StackPilot в winget сейчас в процессе — автор активно занимается этим. Пока удобнее установить приложение со страницы Releases.
- Полноценный CLI интерфейс (stkpil) — теперь всеми возможностями StackPilot можно пользоваться прямо из терминала!
- Интерактивный мастер создания проектов и быстрые однострочники (stkpil create) с поддержкой десятков языков и фреймворков.
- Системный доктор (stkpil doctor) — мгновенный аудит окружения и пакетная установка недостающих компиляторов и инструментов.
- Точечное управление программами (stkpil install, stkpil update, stkpil status) — установка ПО без браузера.
- Терминальный оркестратор запуска (stkpil launch / dev) — параллельный запуск всех сервисов проекта, цветные объединённые логи, проверка готовности портов и безопасная остановка по Ctrl+C.
- Анализатор репозиториев (stkpil analyze) — мгновенное распознавание стека, скриптов и портов в любой папке.
Полная история версий — на странице Releases.
StackPilot: создание проектов, проверка окружения и запуск всего стека одной кнопкой.
- Что нового в 1.3.0
- Установка и запуск
- 🚀 StackPilot CLI (stkpil) — Полная мощь в терминале
- Что такое CLI и как открыть терминал
- Быстрая проверка работы
- 1. Создание проектов (
stkpil create) - 2. Диагностика системы (
stkpil doctor) - 3. Установка и обновление ПО (
install/update/status) - 4. Запуск и оркестрация стека (
stkpil launch/dev) - 5. Анализ чужих или существующих проектов (
stkpil analyze) - Шпаргалка команд CLI
- Как это работает
- Основные возможности
- Пример использования
- Для кого StackPilot
- Быстрый старт
- Что дальше
- История проекта
- Возможности для разработчиков
- Поддерживаемые технологии
- Сборка из исходников
- Данные и приватность
- Безопасность
- Решение проблем
- FAQ
- Дополнительная документация
- Участие в разработке
- Лицензия
- Полезные ссылки
Перейдите на страницу Releases и скачайте последнюю версию. Доступны три формата:
| Формат | Что это | Когда выбирать |
|---|---|---|
.exe |
Инсталлятор (NSIS) | Стандартная установка для пользователя |
.msi |
Инсталлятор MSI | Корпоративное развёртывание, тихая установка, политики |
.zip |
Портативная сборка | Portable-режим: распаковал и запустил без установки |
Установка через winget пока в процессе. Скачивайте сборки только из раздела Releases этого репозитория и проверяйте имя файла и версию.
.exeили.msi— запустите установщик и следуйте шагам мастера..zip— распакуйте архив в удобную папку и запуститеStackPilot.exe.
Пока сборки не подписаны сертификатом, SmartScreen может показать окно «Windows защитил ваш компьютер». Это ожидаемо:
- Нажмите «Подробнее» (More info);
- Нажмите «Выполнить в любом случае» (Run anyway);
- Продолжите установку и запуск.
Автор проекта активно работает над подписью кода и получением одобрений Microsoft — когда сертификат будет получен, предупреждение исчезнет.
- Откройте приложение — StackPilot покажет короткий onboarding.
- Создайте проект в Project Creator или проанализируйте существующую папку в DevLauncher → Анализ.
- Проверьте окружение в Toolchain (Scan) и установите недостающие инструменты.
- Нажмите Run — весь стек запустится автоматически.
| Платформа | Архитектура | Статус | Форматы |
|---|---|---|---|
| Windows | x64 | Стабильно (флагманская) | .msi, setup .exe, .zip (portable) |
| macOS | Apple Silicon (M1–M4), Intel | Значительно улучшено (Homebrew, .pkg, .dmg, Docker socket) |
.dmg (arm64, x64), .app.tar.gz |
| Linux | x64, arm64 | Умеренно стабильно | .deb, .rpm, .AppImage, AUR/PKGBUILD |
Выход сборок для всех платформ осуществляется автоматически через GitHub Actions при каждом релизе.
Для Arch Linux и производных (Manjaro, EndeavourOS и т. п.) есть нативная установка через pacman — см. Arch Linux в разделе «Сборка из исходников».
Наряду с удобным графическим интерфейсом, StackPilot включает в себя stkpil — полноценный консольный инструмент (CLI), который доступен прямо из командной строки.
Зачем нужен CLI, если есть красивое окно?
Консольная утилита позволяет создавать проекты за 3 секунды одной короткой строкой, автоматизировать рутину в скриптах, управлять инструментами на серверах и запускать все сервисы проекта в одной аккуратной консоли с цветными логами без лишней траты ресурсов.
Если вы никогда в жизни не пользовались командной строкой — не переживайте, здесь нет ничего сложного!
CLI (Command Line Interface) — это способ управления компьютером не кликами мыши, а вводом понятных текстовых команд (например, stkpil create). Это похоже на диалог с умным помощником.
- Windows:
- Способ 1 (самый быстрый): Нажмите комбинацию клавиш
Win + Rна клавиатуре, введитеcmdилиwt(Windows Terminal) и нажмитеEnter. - Способ 2: Нажмите правой кнопкой мыши по меню «Пуск» (логотип Windows в левом нижнем углу) и выберите «Терминал» или «PowerShell».
- Способ 3 (прямо в нужной папке): Откройте любую папку в Проводнике Windows, кликните мышью в адресную строку папки вверху, сотрите путь, напишите
cmdи нажмитеEnter— терминал откроется прямо в этой папке!
- Способ 1 (самый быстрый): Нажмите комбинацию клавиш
- macOS:
- Нажмите
Cmd + Пробел(Spotlight), напишитеTerminalи нажмитеEnter.
- Нажмите
- Linux:
- Нажмите
Ctrl + Alt + Tили найдите приложение «Терминал» в списке программ.
- Нажмите
После установки StackPilot команда stkpil становится доступной глобально. Чтобы проверить готовность, просто напишите в открытом терминале:
stkpil --helpВы увидите красивое приветствие со списком всех доступных команд.
Tip
Что делать, если Windows пишет: «"stkpil" не является внутренней или внешней командой»?
- Если окно терминала было открыто до того, как вы установили StackPilot, просто закройте это окно терминала и откройте его заново (система должна обновить список путей
PATH). - Если вы скачали портативную версию (
.zip), скопируйте файлstkpil.exeв любую папку, которая уже есть в вашемPATH(например,C:\Windows\System32или в папку с установленным Cargo~/.cargo/bin), либо добавьте папку распакованного архива в переменные среды пользователя.
Модуль генерации проектов позволяет поднять готовый рабочий каркас приложения со всей инфраструктурой (Docker, БД, линтеры, Git).
Просто введите команду без параметров:
stkpil createВ консоли запустится пошаговый визуальный визард:
- Выберите тип проекта с помощью стрелочек
↑/↓на клавиатуре (Веб-сервис, Telegram-бот, Fullstack-приложение, Мобильное приложение и др.) и нажмитеEnter. - Выберите нужные технологии (бэкенд, фронтенд, базы данных, очереди, линтеры). Несовместимые комбинации система отфильтрует автоматически!
- Укажите название проекта и путь для сохранения.
- Нажмите Create — проект развернётся за считанные секунды.
? Выберите тип проекта:
Fullstack Web App (Frontend + Backend)
> Backend API Microservice
Telegram / Discord Bot
CLI Utility / Desktop App
Если вы точно знаете, что хотите получить, не обязательно проходить шаги мастера. Соберите проект одной командой:
# Создать проект: FastAPI + React + PostgreSQL + Redis + Docker и сразу открыть его в редакторе (-o)
stkpil create -b fastapi -f react -i postgresql redis docker -n "my-super-app" -oПолезные флаги команды stkpil create:
| Флаг | Полное имя | Описание | Пример |
|---|---|---|---|
-b |
--backend |
Технология бэкенда | -b fastapi, -b django, -b nestjs, -b axum, -b rails, -b fiber |
-f |
--frontend |
Технология фронтенда | -f react, -f vue, -f svelte, -f angular, -f next, -f vite |
-i |
--infra |
Инфраструктура, БД, линтеры (через пробел) | -i postgresql redis docker ruff pytest |
-n |
--name |
Название проекта | -n "awesome-project" |
-p |
--path |
Путь, где создать проект | -p "C:\Projects" или -p . (в текущей папке) |
-o |
--open |
Сразу открыть в редакторе кода | -o (или -o cursor, -o webstorm) |
--dry-run |
--dry-run |
Безопасный предпросмотр файлов без записи на диск | stkpil create --dry-run -b go -f react |
Хотите узнать все доступные ключевые слова для флагов? Введите:
stkpil listВам больше не нужно гадать, установлен ли на компьютере Python, свежая ли версия Node.js или запущен ли Docker.
stkpil doctorЧто делает stkpil doctor:
- Проводит полный аудит всех компиляторов, рантаймов, менеджеров пакетов, баз данных и devops-утилит.
- Выводит аккуратную сводную таблицу с галочками и номерами установленных версий.
- Открывает интерактивное меню: стрелочками и пробелом вы можете отметить недостающие или устаревшие программы, и StackPilot сам скачает и установит их в официальных версиях!
Автоматические режимы:
# Установить все недостающие программы без лишних вопросов:
stkpil doctor --install-missing -y
# Проверить только инструменты конкретной категории (languages, databases, devops, tools, package_managers):
stkpil doctor --category databaseВам срочно нужен компилятор языка Gleam, свежий Docker или СУБД PostgreSQL, но лень идти в браузер и искать сайты разработчиков?
Сделайте это прямо в терминале:
stkpil status docker
stkpil status pythonВыведет: статус готовности, текущую версию и путь к исполняемому файлу.
stkpil install python
stkpil install rust
stkpil install gleam
stkpil install postgresqlstkpil update nodejs
stkpil update bunОбычно для запуска современного проекта приходится открывать 4–5 вкладок терминала: в одной запускать Docker, во второй бэкенд, в третьей фронтенд, в четвёртой воркеры...
Команда stkpil launch (или её короткий синоним stkpil dev) заменяет всё это:
cd my-super-app
stkpil launch[StackPilot DevLauncher CLI]
Analyzing workspace: C:\Projects\my-super-app
✔ Discovered 3 runnable service(s):
1. backend (FastAPI Uvicorn) -> Port 8000
2. frontend (Vite React) -> Port 5173
3. db (Docker Compose) -> Port 5432
Waiting for port 5432... Ready!
Waiting for port 8000... Ready!
[backend] | INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
[frontend] | VITE v5.4.0 ready in 240 ms
[frontend] | ➜ Local: http://localhost:5173/
[backend] | INFO: 127.0.0.1:51234 - "GET /api/v1/health HTTP/1.1" 200 OK
Преимущества stkpil launch:
- Единый поток цветных логов: каждый сервис подсвечивается своим цветом (
[backend],[frontend],[db]), логи легко читать в одном окне. - Проверка готовности портов (TCP Readiness Check): фронтенд не начнёт ломиться к бэкенду, пока бэкенд реально не поднимет сокет и не начнёт принимать запросы.
- Чистое завершение по
Ctrl + C: при нажатииCtrl + Cутилита корректно завершает не только главный процесс, но и всё дерево дочерних процессов (node, python, uvicorn), предотвращая утечки памяти и «занятые» порты.
Полезные флаги запуска:
# Запустить сразу все сервисы без интерактивного выбора:
stkpil launch -a
# Посмотреть, какие сервисы и команды будут выполнены, без их фактического запуска:
stkpil launch --dry-runСкачали новый репозиторий с GitHub или открыли старый проект и хотите понять, из чего он состоит?
stkpil analyze(или stkpil scan)
Команда мгновенно проанализирует папку и выведет:
- Языки и основные фреймворки (Django, Next.js, Axum, Spring Boot и др.);
- Обнаруженные конфигурационные файлы (
package.json,Cargo.toml,pyproject.toml,docker-compose.yml); - Скрипты запуска и используемые порты (например,
3000,8000,5432); - Рекомендации по командам для запуска проекта.
| Команда | Что делает | Пример |
|---|---|---|
stkpil create |
Интерактивный мастер создания проекта | stkpil create |
stkpil create [флаги] |
Быстрое создание проекта одной строкой | stkpil create -b fastapi -f vue -i postgresql -n app -o |
stkpil list |
Список всех поддерживаемых технологий и шаблонов | stkpil list |
stkpil doctor |
Диагностика тулчейна и интерактивная установка ПО | stkpil doctor |
stkpil doctor -i -y |
Автоматическая установка всего недостающего ПО | stkpil doctor --install-missing -y |
stkpil status <tool> |
Проверка наличия и версии конкретного инструмента | stkpil status docker |
stkpil install <tool> |
Загрузка и установка программы в один клик | stkpil install python |
stkpil update <tool> |
Обновление программы до последней версии | stkpil update rust |
stkpil launch / dev |
Оркестрация и запуск сервисов проекта с логами | stkpil launch |
stkpil launch -a |
Запустить все сервисы проекта сразу | stkpil launch -a |
stkpil analyze |
Сканирование и детальный анализ существующего кода | stkpil analyze |
stkpil --help |
Полная справка по любой команде | stkpil create --help |
StackPilot объединяет в одном месте работу с проектами, программным окружением, генерацией каркасов, запуском и рабочим пространством.
Вместо:
- Поиска и установки нужных инструментов вручную
- Создания структуры проекта с нуля
- Настройки Docker, баз данных и конфигураций
- Ручного запуска множества команд в разных терминалах
Вы получаете:
- Автоматическую проверку и установку всего необходимого ПО
- Готовый каркас проекта с правильной структурой и настройками
- Запуск всего стека одной кнопкой
- Удобное рабочее пространство для управления проектом
StackPilot анализирует требования каждого проекта и проверяет, всё ли необходимое установлено в системе:
- Секционированный каталог инструментов: 6 логических разделов (Языки и среды, Менеджеры пакетов, Контейнеризация, Базы данных, CLI-утилиты, ИИ и Data Science) с индикаторами готовности и пакетной установкой
- Проверяет наличие необходимых инструментов (Python, Node.js, Docker, Git, Go, Rust, Java и др.)
- Устанавливает недостающее ПО автоматически, всегда в актуальной версии через winget, Homebrew, apt/pacman или нативные инсталляторы (
.msi,.exe,.pkg,.dmg, архивы) - Обновляет и удаляет инструменты
- Управляет тем, какие инструменты использовать локально, а какие — в Docker
- Проверяет готовность WSL2 перед запуском Docker на Windows и при необходимости помогает её установить
- Поддерживает нативную установку и запуск Docker Desktop в macOS
- Предоставляет маркет инструментов с быстрым поиском и тегами категорий
Загрузка и установка проходят автоматически — не нужно вручную искать установщики и разбираться с каждым инструментом отдельно.
Ключевая возможность StackPilot — создание готовой основы проекта через визуальный конструктор:
- Выберите технологии вручную или используйте готовые пресеты
- Конструктор использует гибкие ограничения — несовместимые комбинации не предлагаются
- Предпросмотр будущих шагов генерации, структуры проекта и источников
Например, можно выбрать:
Django + React + aiogram + PostgreSQL + Docker + Ruff + Pytest + Airflow + Kafka
StackPilot автоматически создаёт:
- Базовую структуру папок и необходимые файлы
- Dockerfile, docker-compose.yaml, .dockerignore
- Зависимости и .env с конфигурацией
- Git-репозиторий с первым коммитом
- Конфигурацию выбранных инструментов
- Подробный README с объяснением созданного стека
Результат — не пустой шаблон, а полноценная подготовленная основа, где уже настроена инфраструктура. Можно сразу переходить к написанию бизнес-логики.
После генерации проект автоматически добавляется в профиль быстрого запуска. StackPilot может анализировать любую существующую папку с проектом, даже если она создана не в StackPilot.
На основе анализа создаётся набор асинхронных действий, выполняемых одной кнопкой:
- Открыть VS Code с нужной папкой
- Запустить backend и frontend в отдельных терминалах
- Открыть DBeaver для работы с базой данных
- Запустить Docker и создать необходимые контейнеры
- Поднять инструменты внутри Docker
- Открыть проект в браузере на localhost
Вместо ручного выполнения множества команд весь процесс собирается в единый сценарий. Также можно добавлять свои действия в конструкторе и изменять созданные.
После запуска проект открывается в рабочем пространстве StackPilot:
- Управление запущенными процессами
- Просмотр логов и ошибок
- Отслеживание успешности выполнения отдельных действий
- Суммарное время работы над проектом
- Просмотр файлов
- Контроль состояния окружения и проекта
Единая точка управления проектом после его создания и запуска.
Представим Ваню — студента второго курса, который хочет создать свой первый серьёзный проект. Он знает, что хочет сделать, но не знает, как правильно собрать всё необходимое: какой стек выбрать, какие зависимости установить, как настроить Docker, базу данных, Git и остальные инструменты.
Вместо нескольких часов ручной настройки он использует StackPilot.
- Онбординг. Ваня проходит несколько коротких слайдов и знакомится с основными возможностями приложения.
- Конструктор. Он выбирает Django (Python) для backend, React (TypeScript) для frontend, aiogram для Telegram-бота, PostgreSQL, Docker, Ruff, Pytest, Airflow и Kafka. StackPilot показывает будущие шаги генерации, ожидаемую структуру проекта и источники компонентов.
- Проверка окружения. Приложение проверяет компьютер и определяет, установлены ли Python, Git, Docker и npm. Недостающее предлагается скачать и установить в один клик.
- Генерация. За несколько минут появляются структура проекта, конфигурационные файлы, зависимости, Git-репозиторий и Docker-экосистема. Docker Compose подготовлен для запуска выбранных инструментов, а README объясняет структуру проекта.
- Запуск. Проект добавляется в профиль быстрого запуска. Ваня нажимает одну кнопку — StackPilot открывает VS Code, запускает backend и frontend, открывает DBeaver, поднимает Docker-контейнеры и открывает приложение в браузере.
- Рабочее пространство. В Workspace он видит запущенные процессы и отчёт об успешности действий, а затем переходит в VS Code и сразу начинает писать бизнес-логику.
Результат: путь от пустого компьютера и идеи до готового каркаса проекта и запущенной среды разработки занимает около 5–10 минут вместо потенциальных нескольких часов самостоятельной настройки. Особенно много времени экономится на Docker-экосистеме и инфраструктурной части проекта.
- Начинающим разработчикам, которые создают свой первый серьёзный проект
- Опытным разработчикам с несколькими backend/frontend проектами
- Командам, которым нужен общий сценарий запуска без ручного открытия терминалов
- Maintainer'ам, которые проверяют чужие репозитории
- Авторам open-source проектов, которые хотят дать контрибьюторам понятный onboarding
- Пользователям Windows, macOS или Linux, которым нужен единый UI
StackPilot поддерживает неограниченное количество проектов и полностью бесплатен.
- С нуля: откройте Project Creator, выберите тип, языки и фреймворки (или готовый пресет), проверьте preview и нажмите Создать.
- Уже есть проект: откройте DevLauncher → Анализ, выберите папку — StackPilot определит технологии и создаст черновик профиля запуска.
В Toolchain запустите Scan. Это read-only операция: она ничего не устанавливает. StackPilot покажет, что уже есть, что отсутствует и что можно обновить, и предложит установить недостающее.
Если инструмент установлен, но не найден, перезапустите приложение или исправьте PATH.
На странице профиля проверьте шаги, зависимости и рабочие каталоги и нажмите Run. Все команды и процессы запустятся автоматически. Для long-running сервисов используйте Stop на уровне процесса или всего запуска.
Откройте Workspace, чтобы следить за процессами, логами и проблемами. Статус partial_success означает, что некритичный шаг завершился ошибкой, но остальные сервисы продолжили работу.
В ближайших обновлениях планируется:
- Контекстный AI-ассистент для помощи с подбором стека и анализом логов
- Разделение версий окружения для разных проектов
- Система плагинов
- Расширение списка поддерживаемых технологий
- Подпись сборок и одобрение Microsoft SmartScreen
- Добавление StackPilot в winget
Идея StackPilot появилась из собственного опыта разработки.
Когда начинаешь заниматься программированием и переходишь от небольших учебных проектов к чему-то более серьёзному, создание самого проекта часто оказывается далеко не самой сложной частью. Гораздо больше времени может уйти на настройку окружения: установку нужных программ, разбор Docker, настройку базы данных, зависимостей, Git, конфигурационных файлов и множества других вещей.
Со временем стало очевидно, что многие из этих действий можно автоматизировать и собрать в один понятный инструмент.
Так и появилась идея StackPilot — сделать приложение, которое снимает с разработчика большую часть рутинной инфраструктурной работы и позволяет быстрее перейти от идеи к непосредственно разработке.
StackPilot создавался не как абстрактный «универсальный генератор», а как решение реальной проблемы, с которой сталкиваются разработчики.
Технологии: StackPilot — кроссплатформенное десктопное приложение на базе Tauri 2:
- Rust — системная часть и взаимодействие с операционной системой
- Svelte + TypeScript — пользовательский интерфейс
Такой подход позволяет совместить возможности десктопного приложения с современным веб-интерфейсом и сохранить кроссплатформенность.
- DevLauncher — анализ проекта, профили запуска, управление процессами.
- Project Creator — конструктор стеков и генерация каркаса проекта.
- Toolchain — scan, установка, обновление и починка инструментов, WSL/Docker.
- Workspace — процессы, логи, проблемы и файлы проекта.
Подробное описание модулей: docs/architecture.md.
Открыть или создать проект
│
▼
Анализ / Project Creator
│ стек + проектный контекст
▼
Toolchain: scan → plan → install/repair
│
▼
DevLauncher: профиль (граф шагов)
│
▼
Run: процессы + readiness + логи
│
▼
Workspace: обзор, runtime, проблемы, файлы
Каждый запуск получает собственный run_id. Один профиль можно запускать повторно, а состояние и логи разных запусков не смешиваются. Профиль — это намерение («как поднять проект»), run — конкретная попытка («что произошло сейчас»).
Профиль хранится как JSON и описывает граф шагов: команды, сервисы, ожидание портов и URL, открытие IDE и браузера. Формат, типы шагов, политики завершения и окружения проекта описаны в docs/devlauncher-contract.md.
StackPilot поддерживает широкий спектр современных технологий:
Языки: Python, Rust, Go, TypeScript, JavaScript, Java, C#, C++, C, Ruby, Dart, Kotlin, PHP, Swift, Zig, Elixir, Gleam, HTML
Backend фреймворки: FastAPI, Django, Flask, Axum, Gin, Actix Web, Echo, Fiber, Ruby on Rails, NestJS, Express, Hono, AdonisJS, Spring Boot, ASP.NET Core, Blazor, Laravel, Symfony, Phoenix, Ktor, Fastify
Frontend фреймворки: React, Vue, Svelte, Angular, Next.js, Nuxt, SvelteKit, SolidStart, Vite, Astro, Remix
Мобильные и десктопные: Flutter, React Native, Expo, Tauri, Electron, Qt, Jetpack Compose, SwiftUI, MAUI
Базы данных и ORM: PostgreSQL, MongoDB, MySQL, SQLite, Redis/Memurai, ClickHouse, Prisma, Drizzle, SQLAlchemy, Alembic
Инструменты и сборка: Docker, Git, VS Code, Bun, GCC (MinGW-w64), Gradle, Maven, Kafka, Airflow, dbt, Grafana, Firebase, Terraform, Tailwind CSS, OpenTelemetry, Mailpit
Testing и quality: Pytest, Ruff, Vitest, Biome
Полный каталог находится в src-tauri/src/modules/project_creator/knowledge/wizard_tree.json и src-tauri/src/modules/toolchain/tools.json.
- Git;
- Node.js 18+ (рекомендуется 22 LTS) и npm;
- Rust stable и Cargo;
- системные зависимости Tauri 2 для вашей ОС;
- Windows: WebView2 и Visual Studio Build Tools/Windows SDK;
- Linux: GTK/WebKitGTK и пакеты, указанные в Tauri prerequisites;
- macOS: Xcode Command Line Tools;
- опционально Bun (есть
bun.lock, но npm поддерживается официальными scripts).
git clone https://github.com/cheburek4535/StackPilot.git
cd StackPilot
npm cinpm run tauri devTauri сам запустит npm run dev, frontend будет доступен через http://127.0.0.1:1420, а окно подключится к нему.
npm run tauri buildРезультаты появятся в src-tauri/target/release/bundle/ (.msi/.exe, .dmg, .deb, .AppImage и т. п. в зависимости от ОС). Перед публикацией проверьте подпись, installer и чистую установку на целевой ОС.
Важно: production-бинарник нужно собирать именно через
npm run tauri build(CLI), а не голымcargo build --manifest-path src-tauri/Cargo.toml. CLI добавляет cargo-флаг--features tauri/custom-protocol, который переключает вебвью со встроенных ассетов на dev-сервер (devUrl,http://127.0.0.1:1420). Без него релизный бинарник при запуске покажет окно с ошибкойCould not connect to 127.0.0.1: Connection refusedвместо интерфейса. Если такой бинарник уже успели собрать напрямую через cargo, удалитеsrc-tauri/targetперед пересборкой через CLI — иначе в кэше могут остаться вперемешку артефакты обоих вариантов сборки, и поведение станет непредсказуемым от запуска к запуску.
.deb/.rpm/.AppImage из Releases на Arch напрямую не ставятся. Вместо этого в репозитории есть PKGBUILD для нативной установки через pacman:
git clone https://github.com/cheburek4535/StackPilot.git
cd StackPilot
./packaging/archlinux/install.shСкрипт упаковывает текущий checkout и собирает/устанавливает пакет через makepkg -si (спросит sudo для зависимостей и установки) — после этого stackpilot доступен как обычная pacman-пакетная программа, а sudo pacman -R stackpilot удаляет её без следов. Зависимости уровня сборки — nodejs, npm, rust, cargo; во время выполнения нужны webkit2gtk-4.1 и gtk3, makepkg поставит их автоматически при необходимости.
На связке NVIDIA (проприетарный драйвер) + AMD iGPU вебвью WebKitGTK может падать при старте с Failed to create GBM buffer или Wayland Error 71 — DMA-BUF рендерер несовместим с драйвером NVIDIA. С версии, включающей этот фикс, StackPilot сам отключает DMA-BUF рендерер на Linux (WEBKIT_DISABLE_DMABUF_RENDERER=1), если переменная не задана явно, так что дополнительных действий обычно не требуется.
npm run dev
npm run build
npm run previewВ браузерном режиме включается tauriMock: команды эмулируются в памяти/localStorage. Это удобно для UI, но не проверяет реальные процессы и взаимодействие с ОС.
StackPilot — полностью локальное приложение:
- Все настройки хранятся на вашем компьютере
- Никакая информация не отправляется в интернет
- Установка ПО происходит через официальные источники (winget, Homebrew, apt и т.д.)
- Точный путь к данным приложения: Настройки → Система → Папка данных приложения
Фоновая телеметрия не используется. StackPilot выполняет только те команды, которые вы сами создали или подтвердили.
В StackPilot реализован комплексный аудит и усиление защитных механизмов:
- Защита от Path Traversal — строгая проверка канонических путей (
validate_workspace_path) исключает выход за пределы папки проекта через переходы../или манипуляции с относительными путями. - Защита от циклических симлинков — обход файловой системы ограничен по глубине и проверяет циклические ссылки, предотвращая зависания и DoS.
- Сокрытие конфиденциальных файлов — встроенный файловый менеджер скрывает и блокирует несанкционированный доступ к секретам окружения (
.env), приватным SSH-ключам (id_rsa,.pem), служебным директориям Git (.git/) и системным хранилищам учётных записей. - Контроль завершения процессов — модуль управления процессами проверяет права и сопоставляет идентификаторы только с процессами, запущенными внутри текущего рабочего пространства.
- Прозрачность сценариев — профили запуска хранятся в открытом JSON-формате; проверяйте команды перед первым запуском и не добавляйте секретные ключи в открытом виде.
- Запустите Toolchain Scan
- Проверьте найденные пути в карточке инструмента
- Перезапустите StackPilot после установки инструментов
Убедитесь, что docker version работает и daemon запущен. На Windows Docker использует backend WSL2 — StackPilot проверит готовность WSL и предложит установить её, если она отсутствует.
Проверьте рабочую директорию и переменные окружения. Откройте stderr в DevLauncher → Processes → Logs.
Измените порт в профиле или остановите старый процесс в DevLauncher → Processes.
Укажите полный путь в Настройки → Система или добавьте приложение в Предпочтительные приложения.
StackPilot отправляет мой код в интернет? Нет, всё работает локально. Установщики скачивают ПО из официальных источников.
Можно использовать только для запуска проектов? Да. Откройте существующую папку, проанализируйте её или создайте профиль вручную.
Обязателен ли Docker? Нет. Docker — опция; многие инструменты устанавливаются локально.
Где хранятся профили?
В <app_data>/profiles/*.json; точный путь виден в Настройках.
Что означает partial_success?
Некритичный шаг не удался, но остальные сервисы продолжили работу. Проверьте логи проблемного шага.
Для разработчиков и интеграторов:
- Архитектура и модули — внутреннее устройство DevLauncher, Project Creator, Toolchain и Workspace
- Профили запуска V2 — формат JSON, типы шагов, политики завершения, окружения
- Система совместимости инструментов
- Метаданные инструментов
Pull requests и issues приветствуются! Проект активно развивается, и вклад сообщества важен.
git checkout -b feature/my-feature
npm ci
npm run check
npm test
cd src-tauri
cargo fmt --check
cargo check
cargo test- Добавить поддержку новых языков и фреймворков
- Улучшить определение проектов в анализаторе
- Расширить каталог инструментов для разных ОС
- Улучшить UI/UX
- Написать документацию
- Исправить баги
- Перед большой задачей откройте issue с описанием
- В PR описывайте пользовательский эффект и затронутые ОС
- Добавляйте тесты для новой функциональности
- Не прикладывайте логи с токенами и персональными данными
Для изменений каталога инструментов указывайте detection, sources, platform availability и checksum. Для изменений DevLauncher сохраняйте совместимость профилей и обновляйте docs/devlauncher-contract.md.
StackPilot распространяется под GNU Affero General Public License v3.0 only (AGPL-3.0-only, как указано в package.json). Производные работы и изменения должны предоставляться на условиях AGPL-3.0, включая требования лицензии для сетевого взаимодействия с модифицированной версией. Перед коммерческим распространением прочитайте полный текст лицензии.
Автор и текущий maintainer: cheburek4535. Благодарности, предложения и контрибуции — через GitHub issues и pull requests.