stackblitz-labs/bolt.diy

bolt.diy

bolt.diy: AI 기반 풀스택 웹 개발을 브라우저에서

bolt.diy에 오신 것을 환영합니다. Bolt.new의 공식 오픈 소스 버전으로, 각 프롬프트에 사용할 LLM을 직접 선택할 수 있습니다! 현재 OpenAI, Anthropic, Ollama, OpenRouter, Gemini, LMStudio, Mistral, xAI, HuggingFace, DeepSeek, Groq, Cohere, Together, Perplexity, Moonshot (Kimi), Hyperbolic, GitHub Models, Amazon Bedrock 및 OpenAI 호환 제공자를 사용할 수 있으며, Vercel AI SDK에서 지원하는 다른 모델로 쉽게 확장할 수 있습니다! 로컬에서 실행하고 더 많은 모델을 포함하도록 확장하는 방법은 아래 지침을 참조하세요.

---

공식 설치 지침 및 추가 정보는 bolt.diy 문서를 확인하세요.

---

또한 커뮤니티의 고정 게시물에는 bolt.diy를 직접 실행하고 배포하기 위한 많은 리소스가 있습니다!

또한 bolt.diy에 대한 일반적인 질문에 답변할 수 있는 실험적 에이전트인 "bolt.diy Expert"를 출시했습니다. oTTomator Live Agent Studio에서 찾을 수 있습니다.

bolt.diy는 원래 Cole Medin이 시작했지만, 최고의 오픈 소스 AI 코딩 어시스턴트를 구축하기 위한 대규모 커뮤니티 노력으로 빠르게 성장했습니다!

목차

• 커뮤니티 참여
• 최근 주요 추가 사항
• 기능
• 설정
• 빠른 설치
• 수동 설치
• API 키 및 제공자 구성
• Git을 사용한 설정 (개발자 전용)
• 사용 가능한 스크립트
• 기여
• 로드맵
• FAQ

커뮤니티 참여

oTTomator Think Tank에서 bolt.diy 커뮤니티에 참여하세요!

프로젝트 관리

Bolt.diy는 커뮤니티 노력입니다! 그럼에도 불구하고 핵심 기여자 팀은 현재 집중 영역을 이해할 수 있도록 프로젝트를 구성하는 것을 목표로 합니다.

현재 작업 중인 내용, 작업 계획, 또는 프로젝트에 기여하려면 프로젝트 관리 가이드를 확인하여 쉽게 시작하세요.

최근 주요 추가 사항

✅ 완료된 기능

• 19개 이상의 AI 제공자 통합 - OpenAI, Anthropic, Google, Groq, xAI, DeepSeek, Mistral, Cohere, Together, Perplexity, HuggingFace, Ollama, LM Studio, OpenRouter, Moonshot, Hyperbolic, GitHub Models, Amazon Bedrock, OpenAI 호환
• Electron 데스크톱 앱 - 완전한 기능을 갖춘 네이티브 데스크톱 경험
• 고급 배포 옵션 - Netlify, Vercel 및 GitHub Pages 배포
• Supabase 통합 - 데이터베이스 관리 및 쿼리 기능
• 데이터 시각화 및 분석 - 차트, 그래프 및 데이터 분석 도구
• MCP (Model Context Protocol) - 향상된 AI 도구 통합
• 검색 기능 - 코드베이스 검색 및 탐색
• 파일 잠금 시스템 - AI 코드 생성 중 충돌 방지
• Diff 뷰 - AI 변경 사항의 시각적 표현
• Git 통합 - 복제, 가져오기 및 배포 기능
• Expo 앱 생성 - React Native 개발 지원
• 음성 프롬프트 - 프롬프트를 위한 오디오 입력
• 대량 채팅 작업 - 여러 채팅을 한 번에 삭제
• 프로젝트 스냅샷 복원 - 다시 로드 시 스냅샷에서 프로젝트 복원

🔄 진행 중 / 계획됨

• 파일 잠금 및 Diff 개선 - 향상된 충돌 방지
• 백엔드 에이전트 아키텍처 - 단일 모델 호출에서 에이전트 기반 시스템으로 전환
• LLM 프롬프트 최적화 - 소형 모델에 대한 더 나은 성능
• 프로젝트 계획 문서화 - LLM이 생성한 마크다운 프로젝트 계획
• VSCode 통합 - Git과 유사한 확인 및 워크플로우
• 지식 문서 업로드 - 참고 자료 및 코딩 스타일 가이드
• 추가 제공자 통합 - Azure OpenAI, Vertex AI, Granite

기능

• AI 기반 풀스택 웹 개발 - NodeJS 기반 애플리케이션을 브라우저에서 직접 개발
• 19개 이상의 LLM 지원 - 추가 모델을 통합할 수 있는 확장 가능한 아키텍처
• 프롬프트에 이미지 첨부 - 더 나은 컨텍스트 이해
• 통합 터미널 - LLM이 실행한 명령의 출력 확인
• 이전 버전으로 코드 되돌리기 - 더 쉬운 디버깅 및 빠른 변경
• 프로젝트를 ZIP으로 다운로드 - 쉬운 이식성 및 호스트 폴더와 동기화
• 통합 준비된 Docker 지원 - 번거로움 없는 설정
• Netlify, Vercel 또는 GitHub Pages에 직접 배포
• Electron 데스크톱 앱 - 네이티브 데스크톱 경험
• 데이터 시각화 및 분석 - 통합 차트 및 그래프
• Git 통합 - 복제, 가져오기 및 배포 기능
• MCP (Model Context Protocol) 지원 - 향상된 AI 도구 통합
• 검색 기능 - 코드베이스 검색
• 파일 잠금 시스템 - AI 코드 생성 중 충돌 방지
• Diff 뷰 - AI 변경 사항 확인
• Supabase 통합 - 데이터베이스 관리 및 쿼리
• Expo 앱 생성 - React Native 개발

설정

GitHub에서 소프트웨어를 설치하는 것이 처음이라면 걱정하지 마세요! 문제가 발생하면 제공된 링크를 사용하여 "이슈"를 제출하거나, 저장소를 포크하고 지침을 편집한 후 풀 리퀘스트를 제출하여 이 문서를 개선할 수 있습니다. 다음 지침은 안정적인 브랜치를 로컬 머신에서 빠르게 실행하는 데 도움이 됩니다.

Bolt.DIY의 안정적인 버전을 실행해 보겠습니다!

빠른 설치

← 최신 릴리스 버전으로 이동하려면 여기를 클릭하세요!

• 플랫폼에 맞는 바이너리 다운로드 (Windows, macOS, Linux 지원)
• 참고: macOS에서 "This app is damaged" 오류가 발생하면 다음을 실행하세요:

  xattr -cr /path/to/Bolt.app

수동 설치

옵션 1: Node.js

애플리케이션을 실행하려면 Node.js가 필요합니다.

1. Node.js 다운로드 페이지 방문
2. 운영 체제에 맞는 "LTS" (장기 지원) 버전 다운로드
3. 기본 설정을 수락하고 설치 프로그램 실행
4. Node.js가 제대로 설치되었는지 확인:

• Windows 사용자:

1. Windows + R 누르기
2. "sysdm.cpl" 입력 후 Enter
3. "고급" 탭 → "환경 변수"
4. "Path" 변수에 Node.js가 있는지 확인

• Mac/Linux 사용자:

1. 터미널 열기
2. 다음 명령 입력:

        echo $PATH

1. 출력에서 /usr/local/bin 찾기

애플리케이션 실행

Bolt.DIY를 실행하는 두 가지 옵션이 있습니다: 직접 실행 또는 Docker 사용.

옵션 1: 직접 설치 (초보자 권장)

1. 패키지 관리자 설치 (pnpm):

   npm install -g pnpm

1. 프로젝트 종속성 설치:

   pnpm install

1. 애플리케이션 시작:

   pnpm run dev

옵션 2: Docker 사용

이 옵션은 Docker가 필요하며, 격리된 환경을 원하거나 프로덕션 이미지를 미러링하려는 경우에 좋습니다.

추가 전제 조건

• Docker 설치: Docker 다운로드

단계

1. 환경 변수 준비

제공된 예제를 복사하고 제공자 키를 추가하세요:

   cp.env.example.env
   cp.env.example.env.local

컨테이너 내부의 런타임 스크립트는 .env 및 .env.local을 소스로 사용하므로 필요한 API 키를 해당 파일 중 하나에 보관하세요.

1. 이미지 빌드

   # 개발 이미지 (실행 시 로컬 소스를 바인드 마운트)
   pnpm run dockerbuild
   # ≈ docker build -t bolt-ai:development -t bolt-ai:latest --target development.

   # 프로덕션 이미지 (자체 포함 빌드 아티팩트)
   pnpm run dockerbuild:prod
   # ≈ docker build -t bolt-ai:production -t bolt-ai:latest --target bolt-ai-production.

1. 컨테이너 실행

   # 핫 리로드가 있는 개발 워크플로우
   docker compose --profile development up

   # 구성된 서비스를 사용하는 프로덕션 스타일 컨테이너
   docker compose --profile production up

   # 일회성 프로덕션 컨테이너 (포트 5173에서 앱 노출)
   docker run --rm -p 5173:5173 --env-file.env.local bolt-ai:latest

컨테이너가 시작되면 pnpm run dockerstart를 실행하며, 이는 bindings.sh를 실행하여 Wrangler를 통해 Cloudflare 바인딩을 전달합니다. 다른 시작 루틴이 필요한 경우 docker-compose.yaml에서 이 명령을 재정의할 수 있습니다.

옵션 3: 데스크톱 애플리케이션 (Electron)

네이티브 데스크톱 경험을 선호하는 사용자를 위해 bolt.diy는 Electron 데스크톱 애플리케이션으로도 제공됩니다:

1. 데스크톱 앱 다운로드:

• 최신 릴리스 방문
• 운영 체제에 맞는 바이너리 다운로드
• macOS: .dmg 파일 추출 및 실행
• Windows: .exe 설치 프로그램 실행
• Linux: AppImage 추출 및 실행 또는 .deb 패키지 설치

1. 대안: 소스에서 빌드:

   # 종속성 설치
   pnpm install

   # Electron 앱 빌드
   pnpm electron:build:dist  # 모든 플랫폼
   # 또는 플랫폼별:
   pnpm electron:build:mac   # macOS
   pnpm electron:build:win   # Windows
   pnpm electron:build:linux # Linux

데스크톱 앱은 웹 버전과 동일한 전체 기능을 제공하며 추가 네이티브 기능을 제공합니다.

API 키 및 제공자 구성

Bolt.diy는 AI 제공자 및 API 키 관리를 위한 현대적이고 직관적인 설정 인터페이스를 제공합니다. 설정은 쉬운 탐색 및 구성을 위해 전용 패널로 구성됩니다.

제공자 설정 액세스

1. 설정 열기: 사이드바에서 설정 아이콘(⚙️)을 클릭하여 설정 패널에 액세스
2. 제공자로 이동: 설정 메뉴에서 "Providers" 탭 선택
3. 제공자 유형 선택: "Cloud Providers"와 "Local Providers" 탭 간 전환

클라우드 제공자 구성

Cloud Providers 탭은 모든 클라우드 기반 AI 서비스를 체계적인 카드 레이아웃으로 표시합니다:

API 키 추가

1. 제공자 선택: 사용 가능한 클라우드 제공자(OpenAI, Anthropic, Google 등) 그리드 탐색
2. 제공자 전환: 스위치를 사용하여 각 제공자 활성화/비활성화
3. API 키 설정:

• 제공자 카드를 클릭하여 구성 확장
• "API Key" 필드를 클릭하여 편집 모드로 전환
• API 키를 붙여넣고 Enter를 눌러 저장
• 인터페이스는 유효한 키에 대해 녹색 체크 표시로 실시간 유효성 검사 표시

고급 기능

• 일괄 전환: "Enable All Cloud"를 사용하여 모든 클라우드 제공자를 한 번에 전환
• 시각적 상태: 녹색 체크 표시는 올바르게 구성된 제공자를 나타냄
• 제공자 아이콘: 각 제공자는 쉽게 식별할 수 있는 고유 아이콘 보유
• 설명: 각 제공자의 기능을 설명하는 유용한 설명

로컬 제공자 구성

Local Providers 탭은 로컬 AI 설치 및 사용자 정의 엔드포인트를 관리합니다:

Ollama 구성

1. Ollama 활성화: Ollama 제공자 스위치 전환
2. 엔드포인트 구성: API 엔드포인트 설정 (기본값: http://127.0.0.1:11434)
3. 모델 관리:

• 설치된 모든 모델을 크기 및 매개변수 정보와 함께 보기
• 한 번의 클릭으로 모델을 최신 버전으로 업데이트
• 사용하지 않는 모델 삭제
• 모델 이름을 입력하여 새 모델 설치

기타 로컬 제공자

• LM Studio: LM Studio 엔드포인트에 대한 사용자 정의 기본 URL 구성
• OpenAI 호환: 모든 OpenAI 호환 API 엔드포인트에 연결
• 자동 감지: 시스템이 기본 URL에 대한 환경 변수를 자동으로 감지

환경 변수 대 UI 구성

Bolt.diy는 환경 변수와 UI 기반 구성을 모두 지원합니다. UI 설정은 자동으로 환경 변수를 업데이트하지만, 기존 환경 변수 설정을 재정의할 수 있습니다. 일관된 동작을 위해 UI 또는 환경 변수 중 하나를 사용하는 것이 좋습니다.

Git을 사용한 설정 (개발자 전용)

개발자이고 최신 변경 사항에 액세스하려면 저장소를 복제하세요:

git clone https://github.com/stackblitz-labs/bolt.diy.git
cd bolt.diy
pnpm install
pnpm run dev

사용 가능한 스크립트

• pnpm run dev: 개발 서버 시작
• pnpm run build: 프로덕션용 빌드
• pnpm run start: 프로덕션 서버 시작
• pnpm run typecheck: TypeScript 타입 검사 실행
• pnpm run lint: 린트 실행
• pnpm run preview: 프로덕션 빌드 미리보기

기여

기여를 환영합니다! 자세한 내용은 기여 가이드를 참조하세요.

로드맵

향후 계획에 대한 자세한 내용은 로드맵을 참조하세요.

FAQ

자주 묻는 질문은 FAQ를 참조하세요.