Repolode
AnswerDotAI

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. 1

    pip으로 nbdev를 설치하세요

    pip install nbdev
  2. 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 통계는 매일 갱신됩니다.

관련 프로젝트