⬇️ 다운로드

HeliosGen은 데스크톱 앱입니다. 릴리스 페이지에서 사용 중인 OS의 최신 빌드를 받아가세요. 계정, 서버, 클라우드 설정이 필요 없습니다:

👉 릴리스 페이지에서 다운로드

실제로 첨부된 최신 릴리스의 빌드만 이용 가능합니다. macOS는 오늘 배포되었습니다. Tauri는 크로스 컴파일을 할 수 없으므로, Windows 및 Linux 빌드는 해당 플랫폼에 있는 분이 필요합니다. 만약 Windows 또는 Linux에서 npm run desktop:build를 실행할 수 있다면(아래의 소스 코드로 빌드 섹션 참조), PR을 열거나 이슈에 아티팩트를 첨부해 주시면 릴리스에 추가하겠습니다.

앱은 아직 코드 서명(code-signed) 되어 있지 않습니다:

• macOS — 앱을 마우스 오른쪽 버튼으로 클릭 → 열기(Open) (최초 한 번), 또는 xattr -cr /Applications/HeliosGen.app을 실행하세요.
• Windows — SmartScreen: 추가 정보(More info) → 그래도 실행(Run anyway).

🚀 첫 사용

1. HeliosGen을 실행합니다.
2. **설정(Settings) → API 키(API Keys)**를 열고 kie.ai API 키를 붙여넣습니다.
3. 생성을 시작합니다.

모든 것은 사용자의 기기에 남아 있습니다. 생성물, 업로드, 폴더, 워크플로우 및 설정은 로컬 데이터베이스에 저장되며, 미디어는 로컬 폴더에 저장됩니다:

📸 스크린샷

✨ 간단한 이미지 및 비디오 생성

🔄 워크플로우 생성

🧠 네이티브 JSON 프롬프트 미리보기

💬 AI 프롬프트 개선 도우미

✨ HeliosGen

HeliosGen은 이미지 및 비디오 생성을 위한 무료 오픈 소스 시각적 AI 워크플로우 빌더입니다.

다음 기능을 사용하여 재사용 가능한 AI 파이프라인을 구축하세요:

• 무한한 노드 기반 워크플로우,
• 다중 모델 생성(multi-model generation),
• 레퍼런스 이미지 지원,
• 자동화 체인(automation chains),
• 모든 기능이 사용자의 기기에서 100% 로컬로 실행됩니다.

구독료 없음.
사라지는 크레딧 없음.
벤더 종속성 없음.
클라우드나 계정 필요 없이 — 단지 로컬 앱과 사용자 본인의 kie.ai 키만 있으면 됩니다.

💳 크레딧

HeliosGen은 이제 <a href="https://kie.ai?ref=25abb3f2236cbff9780ab9c2f84479ec" target="_blank">kie.ai</a>와 연동됩니다.

모든 크레딧은 사용자 본인의 계정에서 직접 구매하며 만료되지 않습니다.

이는 다음을 의미합니다:

• 월별 초기화 없음,
• 손실되는 크레딧 없음,
• 구독 잠금(subscription lock-in) 없음,
• 사용량에 대한 완전한 소유권 확보.

생성하는 만큼만 비용을 지불합니다.

🚀 기능

• 무한 노드 기반 캔버스
• AI 이미지 및 비디오 생성
• 드래그 앤 커넥트 워크플로우 시스템
• 다중 모델 파이프라인
• 레퍼런스 이미지 지원
• 병렬 및 순차적 파이프라인 실행
• 실시간 생성 기록
• 100% 로컬 — 데이터가 기기를 벗어나지 않습니다
• 사용자 본인의 kie.ai 키 사용 가능
• 모던 반응형 UI

⚡ 지원 모델

이미지

• GPT Image 2 (OpenAI)
• Nano Banana / Nano Banana 2 / Nano Banana 2 Lite / Nano Banana Pro (Google)
• Seedream 5.0 Lite / Pro (Seedream)
• Z-Image (Z-AI)
• Grok Imagine (X)

비디오 (Videos)

• Veo 3.1 Lite / Fast / Quality, Gemini Omni Video (Google)
• Kling 3.0, Kling 3.0 Turbo, Motion Control 2.6 / 3.0 (Kling)
• Seedance 2.0 / Fast / Mini (Bytedance)
• Grok Imagine, Grok Imagine 1.5 preview (X)
• HappyHorse (Alibaba)

더 많은 모델이 곧 출시될 예정입니다.

🏗️ 기술 스택 (Tech Stack)

🤖 Codex CLI (선택 사항 — 대체 GPT Image 2 백엔드)

HeliosGen은 kie.ai 크레딧을 통해 GPT Image 2를 라우팅하는 대신, 사용자의 ChatGPT Codex 구독을 통해 자체적으로 이미지를 생성할 수 있습니다. 이를 위해 codex-imagegen-cli를 사용할 수 있습니다. 데스크톱 앱은 PATH에서 codex를 자동으로 인식합니다. 만약 해당 명령어가 없으면, 기능이 **설정되지 않음 (NOT CONFIGURED)**으로 표시될 뿐 다른 모든 기능은 정상적으로 작동합니다.

필수 조건:

• Codex 접근 권한이 있는 ChatGPT Plus/Pro/Team/Enterprise 계정
• 장치에 codex CLI 설치
• uv (Python 패키지 관리자)

1. Codex CLI 설치

# macOS
brew install codex

...

2. codex-imagegen-cli 설치

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

이 과정은 codex-imagegen 바이너리를 설치합니다. 반드시 이 경로가 PATH에 포함되어 있는지 확인하세요.

3. 로그인

다음 중 하나를 수행하세요:

• 터미널에서 codex login 실행 (로그인을 위해 브라우저 열림), 또는
• 앱을 열기 → **설정(Settings) → API 키(API Keys) → Codex CLI → Codex 연결(Connect Codex)**을 통해 장치 코드 로그인 절차를 따릅니다. 이 경우, 출력된 URL로 이동하여 코드를 입력하면 터미널이 필요 없습니다.

⚠️ 새로운 로그인을 시작하는 행위(어떤 방법을 사용하든)는 해당 장치의 기존 세션을 즉시 무효화합니다. CLI는 로그인 시도가 시작되는 순간, 완료 여부와 관계없이 이전 자격 증명을 지웁니다. 상태 배지에 **설정되지 않음 (NOT CONFIGURED)**이 표시될 때만 하나를 시작하세요.

4. GPT Image 2 활성화

설정(Settings) → 이미지 모델(Image Models)에서 GPT Image 2의 제공업체 토글을 Codex CLI로 설정하세요. 설정(Settings) → API 키(API Keys)에 있는 상태 배지(status badge)는 CLI와 로그인 모두가 완료되면 READY를 표시합니다.

🛠️ 소스에서 빌드하기 (Build from source)

직접 구축하는 것을 선호하거나 아직 릴리스 페이지에 없는 플랫폼이 필요한가요? 전체 앱은 이 리포지토리(repo)에서 빌드됩니다.

Tauri는 크로스 컴파일(cross-compile)을 지원하지 않습니다. 목표로 하는 OS에서 직접 빌드해야 합니다. Mac에서는 npm run desktop:build를, Windows에서는 Windows용으로, Linux에서는 Linux용으로 실행하세요.

Windows/Linux 빌드를 배포하는 데 도움을 주고 싶으신가요? 해당 OS에서 빌드하여 아티팩트(PR 또는 이슈 첨부)를 보내주세요. 다음 릴리스에 크레딧과 함께 추가될 것입니다.

필수 조건 (Prerequisites) (일회성, 모든 플랫폼)

• macOS — Xcode Command Line Tools: xcode-select --install
• Windows — Microsoft C++ Build Tools (C++를 사용한 데스크톱 개발) 및 WebView2 (Windows 11에 사전 설치됨)
• Linux — webkit2gtk-4.1, librsvg2, build-essential, curl, wget, file, libssl-dev, libayatana-appindicator3-dev (Debian/Ubuntu 패키지 이름; 다른 배포판의 경우 Tauri 필수 조건 페이지 참조)

빌드 (Build)

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

아티팩트는 src-tauri/target/release/bundle/에 저장됩니다:

아키텍처, 데이터 위치 및 서명(signing)과 공증(notarization)에 대해서는 DESKTOP.md를 참고하세요.

🤝 기여 (Contributions)

기여는 언제나 환영합니다.

HeliosGen을 개선할 아이디어가 있거나, 버그를 발견했거나, 혹은 도움이 필요하다면:

• 이슈(issue)를 열어주세요
• 풀 리퀘스트(pull request)를 제출해주세요
• 피드백이나 기능 요청을 공유해주세요

모든 기여에 감사드립니다.

📄 라이선스 (License)

MIT License