SlideForge는 로컬에서 실행하는 오픈 소스 AI 프레젠테이션 제작 도구입니다. 주제나 원문을 입력해 슬라이드 초안을 만들고, 브라우저에서 내용을 편집한 뒤 PPTX 또는 PDF로 내보낼 수 있습니다.
텍스트 생성에는 별도의 OpenAI API 키를 사용하지 않습니다. 사용자가 공식 Codex CLI 또는 Claude Code에 직접 로그인하면 SlideForge가 해당 로컬 CLI를 호출합니다. 계정 아이디, 비밀번호, 세션 토큰은 SlideForge 화면에 입력하거나 프로젝트에 저장하지 않습니다.
- 주제 기반 초안 생성 또는 원문 기반 슬라이드 구성
- 슬라이드 순서 변경, 복제, 삭제와 텍스트 편집
- 발표자용 PPTX 및 PDF 내보내기
- 브랜드 프리셋과 PPTX 기반 브랜드 설정
- Codex CLI와 Claude Code 중 생성 공급자 선택
- 브라우저를 통한 공식 계정 로그인 상태 확인
- 로컬 전용 실행(
127.0.0.1)과 API 키 없는 기본 구성
아래 이미지는 README 설명을 위한 예시 프로젝트 화면입니다.
주제, 대상·목적, 분량, 출력 방식, AI 공급자를 정합니다. Codex CLI 또는 Claude Code 로그인 상태를 확인한 뒤 다음 단계로 이동합니다.
발표 키워드, 원문, YouTube·웹페이지·자료 파일, 디자인 시스템과 스타일 지시를 추가합니다.
생성된 슬라이드를 선택해 제목, 본문, 차트, KPI, 발표자 노트를 직접 수정하고 품질 체크 결과를 보면서 보강합니다.
파일명, 형식, 슬라이드 크기, 발표자 노트 포함 여부를 정한 뒤 PowerPoint 또는 PDF로 내려받습니다.
브라우저(127.0.0.1)
│
▼
SlideForge의 로컬 Next.js 서버
│
├── Codex CLI ─────── ChatGPT 구독 계정
└── Claude Code ───── Claude 구독 계정
로그인 버튼은 설치된 공식 CLI의 로그인 절차를 시작할 뿐입니다. 로그인 화면은 공급자의 공식 브라우저 페이지에서 열립니다. SlideForge는 Codex에 운영체제 자격 증명 저장소 사용을 강제하며, Claude 자격 증명은 Claude Code가 자체 보안 정책에 따라 관리합니다.
- Node.js 20 이상
- npm
- 아래 중 하나 이상
- Codex CLI와 사용 가능한 ChatGPT 구독
- Claude Code와 사용 가능한 Claude 구독
구독 종류, 조직 정책, 사용량 제한에 따라 CLI 사용 가능 여부와 한도가 달라질 수 있습니다. ChatGPT 또는 Claude 웹 구독이 모든 계정에서 동일한 권한을 보장하지는 않습니다.
git clone https://github.com/koul777/slideforge.git
cd slideforge
npm installCodex CLI가 없다면 먼저 설치합니다.
npm install -g @openai/codex
codex login브라우저에서 본인의 ChatGPT 계정으로 로그인합니다. 로그인 상태는 다음 명령으로 확인할 수 있습니다.
codex login status공용 PC에서는 사용 후 로그아웃하세요.
codex logoutcopy .env.example .env.local
npm run devmacOS 또는 Linux에서는 다음 명령을 사용합니다.
cp .env.example .env.local
npm run dev브라우저에서 http://127.0.0.1:3000을 엽니다. Windows 사용자는 Run-SlideForge.bat을 실행해도 됩니다.
앱에서 Codex를 선택하고 로그인 상태를 확인한 뒤 슬라이드를 생성합니다. 이미 터미널에서 로그인했다면 같은 사용자 계정으로 실행한 SlideForge가 그 상태를 사용합니다.
Claude Code는 선택 사항입니다. 공식 설치 안내에 따라 CLI를 설치한 뒤 로그인합니다.
claude auth login
claude auth status그다음 SlideForge의 AI 공급자에서 Claude Code를 선택합니다. API 키나 별도 결제용 환경 변수를 설정하지 마세요. 조직이 관리하는 계정이라면 관리자의 Claude Code 사용 정책이 우선합니다.
별도의 환경 변수는 필요하지 않습니다. OPENAI_API_KEY, ANTHROPIC_API_KEY 또는 유사한 API 키를 .env 파일에 넣지 마세요. SlideForge는 CLI를 실행할 때 API 키 관련 환경 변수를 전달하지 않고, 공식 구독 로그인만 허용하도록 설계되었습니다.
SlideForge는 개인 컴퓨터에서 한 명이 사용하는 로컬 도구입니다.
- 서버는
127.0.0.1에만 바인딩됩니다. - SlideForge는 계정 아이디, 비밀번호 또는 OAuth 토큰을 직접 수집하지 않습니다.
- 로그인은 공식 CLI가 연 공급자 웹페이지에서만 진행하세요.
- 프롬프트와 문서 내용은 선택한 AI 공급자에게 CLI를 통해 전송될 수 있습니다.
- 회사 기밀, 개인정보 또는 규제 대상 자료를 입력하기 전에 조직 정책을 확인하세요.
- 계정에는 다중 인증을 설정하고 운영체제 사용자 계정을 공유하지 마세요.
이 프로젝트는 인터넷에 공개된 서버나 여러 사용자가 함께 쓰는 SaaS로 운영하도록 설계되지 않았습니다. 외부 호스트에 배포하려면 별도의 사용자 인증, 세션 격리, CSRF 방어, 요청 제한, 감사 로그, 비밀 관리와 공급자별 이용 약관 검토가 필요합니다. 자세한 내용은 SECURITY.md를 확인하세요.
기본 모드는 HTML/도형 기반의 편집 가능한 슬라이드를 생성합니다. 완성한 자료는 다음 형식으로 내보낼 수 있습니다.
.pptx: PowerPoint에서 추가 편집 가능.pdf: 공유 및 인쇄용.slideforge.json: 작업 백업 및 다시 열기
공개 버전에는 유료 이미지 API 연동이 포함되지 않습니다. 도형·카드·차트·타이포그래피로 구성된 편집형 슬라이드를 생성하므로 별도의 이미지 API 비용이 발생하지 않습니다.
| 명령 | 설명 |
|---|---|
npm run dev |
로컬 개발 서버 실행 |
npm run build |
프로덕션 빌드 |
npm run start |
빌드된 서버를 로컬에서 실행 |
npm run typecheck |
TypeScript 검사 |
npm run lint |
Next.js 린트 |
npm run smoke |
실행 중인 서버의 기본 API 점검 |
npm run integration:subscription |
로그인된 구독 CLI로 슬라이드와 PPTX 통합 점검 |
npm run e2e:ui |
Playwright UI 테스트 |
터미널에서 codex --version을 실행하세요. 명령을 찾지 못하면 Codex CLI를 설치하고 터미널과 SlideForge를 모두 다시 시작합니다.
터미널에서 codex login status를 확인하고 필요하면 codex login을 다시 실행합니다. 브라우저 팝업 차단, 회사 프록시 또는 조직의 Codex 정책도 확인하세요.
ANTHROPIC_API_KEY 등 API용 환경 변수가 설정되어 있지 않은지 확인하고 claude auth status에서 Claude 계정 로그인을 확인합니다. 구독에 포함된 사용량을 모두 사용하면 다음 한도 갱신까지 기다려야 할 수 있습니다.
정상 동작입니다. 보안을 위해 기본 서버는 로컬 루프백 주소만 사용합니다. 0.0.0.0 바인딩이나 포트 포워딩은 지원 범위를 벗어납니다.
이슈나 Pull Request를 보내기 전에 다음을 실행해 주세요.
npm run typecheck
npm run lint
npm run build보안 취약점은 공개 이슈로 올리지 말고 보안 정책에 따라 제보해 주세요.