HeliosGen README

The project's README from github.com/SegFault42/HeliosGen. As one markdown file: README.md.

HeliosGen

Build AI image & video pipelines visually.
Chain prompts, models, reference images, and automations on an infinite canvas.

⬇️ Download

HeliosGen is a desktop app. Grab the latest build for your OS from the releases page — no account, no server, no cloud setup:

👉 Download from the Releases page

OS File
macOS (Apple Silicon) HeliosGen_<version>_aarch64.dmg
Windows 🙋 looking for a contributor to build & submit — see below
Linux 🙋 looking for a contributor to build & submit — see below

Only the builds actually attached to the latest release are available. macOS is published today. Tauri can't cross-compile, so Windows and Linux builds need someone on those platforms — if you can run npm run desktop:build on Windows or Linux (see the Build from source section below), please open a PR or attach the artifacts to an issue and we'll add them to the release.

The app is not code-signed yet:

🚀 First run

  1. Launch HeliosGen.
  2. Open Settings → API Keys and paste your kie.ai API key.
  3. Start generating.

Everything stays on your machine. Generations, uploads, folders, workflows and settings live in a local database; media is saved to a local folder:

OS Data location
macOS ~/Library/Application Support/cash.sdd.helios.desktop/
Windows %APPDATA%\cash.sdd.helios.desktop\
Linux ~/.local/share/cash.sdd.helios.desktop/

Delete that folder to reset the app.

📸 Screenshots

✨ Simple Image & Video Generation

Image generation example

🔄 Workflow Generation

Workflow generation example

🧠 Native JSON Prompt Preview

JSON prompt preview

💬 AI Prompt Improvement Assistant

Prompt assistant interface

✨ HeliosGen

HeliosGen is a free & open source visual AI workflow builder for image and video generation.

Build reusable AI pipelines with:

No subscriptions.
No disappearing credits.
No vendor lock-in.
No cloud, no accounts — just a local app and your own kie.ai key.

💳 Credits

HeliosGen now works with kie.ai.

All credits are purchased directly on your own account and never expire.

That means:

You only pay for what you generate.

🚀 Features

⚡ Supported Models

Images

Videos

More models are coming.

🏗️ Tech Stack

Layer Technology
Desktop shell Tauri 2 (Rust)
App Next.js + React + TypeScript (bundled Node sidecar)
Database SQLite (local)
Storage Local disk
AI Backend kie.ai

🤖 Codex CLI (optional — alternate GPT Image 2 backend)

Instead of routing GPT Image 2 through kie.ai credits, HeliosGen can generate through your own ChatGPT Codex subscription via codex-imagegen-cli. The desktop app picks up codex from your PATH automatically; if it's missing, the feature just shows NOT CONFIGURED and everything else keeps working.

Requirements:

1. Install the Codex CLI

# macOS
brew install codex

# or, cross-platform
npm install -g @openai/codex

2. Install codex-imagegen-cli

git clone https://github.com/jdmnk/codex-imagegen-cli.git
cd codex-imagegen-cli
uv sync --dev
uv tool install -e .

This installs the codex-imagegen binary — make sure it's on your PATH.

3. Log in

Either:

⚠️ Starting a new login (either way) immediately invalidates any existing session on that machine — the CLI clears old credentials the moment a login attempt begins, whether or not it's ever completed. Only start one when the status badge below shows NOT CONFIGURED.

4. Enable it for GPT Image 2

In Settings → Image Models, set GPT Image 2's provider toggle to Codex CLI. The status badge in Settings → API Keys shows READY once both the CLI and login are in place.

🛠️ Build from source

Prefer to build it yourself, or need a platform that isn't on the releases page yet? The whole app builds from this repo.

Tauri does not cross-compile — build on the OS you want to target. Run npm run desktop:build on a Mac for the macOS build, on Windows for Windows, on Linux for Linux.

Want to help ship Windows / Linux builds? Build on that OS and send the artifacts (PR or issue attachment) — they'll be added to the next release, with credit.

Prerequisites (one-time, all platforms)

Tool Notes
Node 22+ The bundled server uses node:sqlite. nvm use 22.
Rust curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
Tauri system deps See https://v2.tauri.app/start/prerequisites/

Platform-specific system deps:

Build

git clone https://github.com/SegFault42/HeliosGen
cd HeliosGen
npm install
npm run desktop:build

Artifacts land in src-tauri/target/release/bundle/:

OS Output
macOS macos/HeliosGen.app, dmg/HeliosGen_<ver>_<arch>.dmg
Windows msi/HeliosGen_<ver>_x64_en-US.msi, nsis/HeliosGen_<ver>_x64-setup.exe
Linux deb/, rpm/, appimage/HeliosGen_<ver>_amd64.AppImage

The macOS build is unsigned — on first launch Gatekeeper blocks it. Right-click → Open, or xattr -cr "src-tauri/target/release/bundle/macos/HeliosGen.app".

Develop (hot reload)

npm run desktop:dev

Runs next dev and tauri dev together. The first run compiles the Rust shell (~1–2 min).

See DESKTOP.md for architecture, data locations, and signing & notarization.

🤝 Contributions

Contributions are welcome.

If you find a bug, have an idea, or want to improve HeliosGen:

All contributions are appreciated.

📄 License

MIT License

Built for creators building the future of AI workflows.

HeliosGen (SegFault42/HeliosGen)

Searching Database…

3.2K ·GitHub
HeliosGen
Что это такое?HeliosGen — это бесплатное десктопное приложение для самостоятельного размещения, в котором можно собирать конвейеры генерации изображений и видео с помощью ИИ на бесконечном холсте с узлами. Позиционируется как бесплатная альтернатива Higgsfield, OpenArt и Freepik.
Это облачный сервис или всё работает целиком на моём компьютере?Это нативное десктопное приложение (оболочка Tauri с интерфейсом на Next.js/React), которое работает на 100% локально — сценарии, медиафайлы, загрузки и настройки хранятся в локальной базе SQLite и в локальной папке, а не в облаке.
Как его запустить?Скачайте .dmg для macOS (Apple Silicon) со страницы Releases, откройте его (через правый клик → Open или командой `xattr -cr`, так как приложение не подписано), затем зайдите в Settings → API Keys и вставьте свой ключ kie.ai, чтобы начать генерацию. Регистрация или настройка сервера не нужны.
Нужен ли мне аккаунт kie.ai, чтобы что-то генерировать?Да — в HeliosGen нет встроенного ИИ-бэкенда; вы используете свой API-ключ kie.ai и покупаете кредиты прямо на kie.ai, при этом они не сгорают и не обнуляются в конце месяца.
Приложение уже готово к работе на Windows или Linux?Пока нет — на странице Releases сейчас выложена только сборка для macOS, потому что Tauri не умеет кросс-компиляцию; сборки для Windows и Linux ждут, пока кто-то из контрибьюторов их соберёт и пришлёт, либо вы можете собрать проект из исходников сами.
Какие ИИ-модели поддерживает HeliosGen?Для изображений: GPT Image 2, Nano Banana / Nano Banana 2 / Pro, Seedream 5.0, Z-Image и Grok Imagine. Для видео: Veo 3.1, Gemini Omni Video, Kling 3.0, Seedance 2.0, Grok Imagine и HappyHorse — список постоянно пополняется.
Можно ли не платить за кредиты kie.ai при генерации изображений?Конкретно для GPT Image 2 — да: генерацию можно направить через свою подписку ChatGPT Plus/Pro/Team Codex с помощью codex-imagegen-cli вместо кредитов kie.ai; если Codex не установлен, приложение просто пометит этот вариант как NOT CONFIGURED, а всё остальное продолжит работать.
Что будет с моими данными, если я перестану пользоваться приложением?Просто удалите локальную папку приложения (например, ~/Library/Application Support/cash.sdd.helios.desktop/ на macOS) — в ней находятся вся база данных, медиафайлы и настройки, так что её удаление полностью сбрасывает приложение.
What are similar projects?artcraft-services, spacedrive, os, laya, ohmygame, open-design, openless, NextChat
Which topics is it in?byok, tauri, video-generation, image-generation, nextjs, sqlite, generative-ai, local-first, desktop, rust, react, free
Creator
SegFault42
Size
9.5 MB
Stars
3.2K
Updated
CommitSep 17Release1.2.1Sep 09
Age
6mo
Commits · 90 Days