conda 패키지 묶음을 위한 설치 프로그램을 빌드하고, 셸·macOS .pkg·Windows .exe/.msi 형식으로 생성하는 CLI 도구입니다.
AnswerDotAI/nbdev
Jupyter Notebook을 문서, 테스트, CI, PyPI/conda 릴리스를 갖춘 Python 패키지로 변환하는 노트북 기반 개발 플랫폼입니다.
- 스타
- 5,323
- 포크
- 514
- 열린 이슈
- 187
- 마지막 커밋
- 어제
어떤 프로젝트인가요?
nbdev를 사용하면 가벼운 마크업을 활용해 Jupyter Notebook에서 Python 코드와 테스트, 문서를 작성할 수 있습니다. 노트북에서 Python 모듈을 내보내고, Quarto와 GitHub Pages로 문서 사이트를 생성하며, 테스트를 병렬로 실행하고, 지속적 통합을 위한 GitHub Actions를 설정합니다.
프로젝트는 노트북과 일반 텍스트 소스 코드를 양방향으로 동기화하므로, IDE에서 편집한 변경 사항을 해당 코드가 비롯된 노트북 셀에 반영할 수 있습니다. Git hook은 불필요한 노트북 메타데이터를 제거하고 병합 충돌을 읽기 쉬운 형태로 표시합니다. 패키징 도구를 사용해 PyPI와 conda에 릴리스할 수 있습니다.
nbdev3에서는 프로젝트 설정을 settings.ini에서 pyproject.toml로 옮겼으며, 기존 nbdev2 프로젝트를 변환하는 nbdev-migrate-config 명령도 포함합니다.
핵심 기능
- 01노트북을 Python 모듈로 내보내고 소스 코드와 양방향으로 동기화합니다
- 02Quarto와 GitHub Pages를 사용해 검색 가능한 문서 사이트를 생성합니다
- 03명령 하나로 노트북 기반 테스트를 병렬 실행합니다
- 04CI와 문서 재빌드를 위한 GitHub Actions 워크플로를 제공합니다
- 05PyPI와 conda에 패키지를 배포합니다
- 06노트북을 정리하고 병합 충돌을 해결하는 Git hook을 포함합니다
활용 사례
- 코드와 테스트, 문서를 노트북에 함께 두는 Python 라이브러리 개발
- 자동화된 릴리스로 오픈소스 Python 패키지를 PyPI에 배포
- 프로젝트 문서를 소스 코드에서 생성하고 하이퍼링크로 연결해 유지
- 노트북 기반 코드를 IDE에서 편집하면서 노트북과 동기화
빠른 시작
- 1
pip으로 nbdev를 설치하세요
pip install nbdev - 2
nbdev-help를 실행해 사용 가능한 명령을 확인하세요
nbdev-help
사용 전 알아둘 점
- Windows에서는 WSL이 필요하며, cmd나 PowerShell에서는 실행되지 않습니다.
- Jupyter 및 프로젝트에서 사용하는 것과 동일한 Python 환경에 설치해야 합니다.
- 2026년 1월 nbdev3 릴리스에서 설정 파일이 pyproject.toml로 변경되었습니다. 이는 nbdev2 프로젝트와 호환되지 않는 변경입니다.
포함된 컬렉션
토픽
자주 묻는 질문
- nbdev은(는) 무엇인가요?
- Jupyter Notebook을 문서, 테스트, CI, PyPI/conda 릴리스를 갖춘 Python 패키지로 변환하는 노트북 기반 개발 플랫폼입니다. nbdev를 사용하면 가벼운 마크업을 활용해 Jupyter Notebook에서 Python 코드와 테스트, 문서를 작성할 수 있습니다. 노트북에서 Python 모듈을 내보내고, Quarto와 GitHub Pages로 문서 사이트를 생성하며, 테스트를 병렬로 실행하고, 지속적 통합을 위한 GitHub Actions를 설정합니다.
- nbdev은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- nbdev은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- nbdev은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. nbdev의 마지막 커밋은 2026년 11월 5일입니다.
- nbdev은(는) 어디에 사용할 수 있나요?
- 코드와 테스트, 문서를 노트북에 함께 두는 Python 라이브러리 개발 자동화된 릴리스로 오픈소스 Python 패키지를 PyPI에 배포 프로젝트 문서를 소스 코드에서 생성하고 하이퍼링크로 연결해 유지 노트북 기반 코드를 IDE에서 편집하면서 노트북과 동기화
- nbdev는 어떻게 설치하나요?
- pip으로 nbdev를 설치하세요: pip install nbdev nbdev-help를 실행해 사용 가능한 명령을 확인하세요: nbdev-help
- nbdev은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/AnswerDotAI/nbdev
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
OpenAPI, Swagger, AsyncAPI 또는 GraphQL 정의로 반응형 3단 API 레퍼런스 사이트를 생성하는 오픈소스 도구입니다.
빌드, 환경, 테스트, 린트, 버전 관리, 배포를 아우르는 현대적이고 확장 가능한 Python 프로젝트 관리자입니다.
의존성 기반 태스크와 플러그인 시스템으로 빌드 수명 주기를 정의하는 Python 프로젝트용 빌드 자동화 도구입니다.
여러 개발자 레퍼런스 문서를 검색 및 오프라인 사용이 가능한 하나의 웹 기반 API 문서 브라우저로 제공합니다.
Go 프로젝트의 바이너리를 빌드하고 패키징해 GitHub, 패키지 관리자, 컨테이너 레지스트리에 배포하는 릴리스 자동화 도구입니다.