Repolode
Enviar
AnswerDotAI

AnswerDotAI/nbdev

Plataforma de desarrollo basado en notebooks que convierte Jupyter Notebooks en paquetes de Python con documentación, pruebas, CI y publicaciones en PyPI y conda.

Ver en GitHubSitio web
Estrellas
5,323
Forks
514
Issues abiertos
187
Último commit
ayer

¿Qué es?

nbdev permite escribir código Python, pruebas y documentación en Jupyter Notebooks mediante marcado ligero. A partir de esos notebooks, exporta módulos de Python, genera un sitio web de documentación con Quarto y GitHub Pages, ejecuta pruebas en paralelo y configura GitHub Actions para la integración continua.

El proyecto mantiene los notebooks y el código fuente en texto plano sincronizados en ambos sentidos, de modo que puedes editar en un IDE y devolver los cambios a las celdas del notebook de las que proceden. Los hooks de Git eliminan metadatos innecesarios de los notebooks y presentan los conflictos de fusión en un formato legible. Las herramientas de empaquetado gestionan las publicaciones en PyPI y conda.

nbdev3 trasladó la configuración del proyecto de settings.ini a pyproject.toml e incluye el comando nbdev-migrate-config para convertir proyectos existentes de nbdev2.

Funciones clave

  • 01Exporta notebooks a módulos de Python y los mantiene sincronizados en ambos sentidos con el código fuente
  • 02Genera sitios de documentación con búsqueda mediante Quarto y GitHub Pages
  • 03Ejecuta en paralelo pruebas basadas en notebooks con un solo comando
  • 04Proporciona workflows de GitHub Actions para CI y para volver a generar la documentación
  • 05Publica paquetes en PyPI y conda
  • 06Incluye hooks de Git que limpian los notebooks y resuelven conflictos de fusión

Casos de uso

  • Crear una biblioteca de Python cuyo código, pruebas y documentación estén juntos en notebooks
  • Publicar un paquete de Python de código abierto en PyPI con publicaciones automatizadas
  • Mantener la documentación del proyecto generada y enlazada desde el código fuente
  • Editar en un IDE código basado en notebooks y mantenerlos sincronizados

Inicio rápido

  1. 1

    Instala nbdev con pip

    pip install nbdev
  2. 2

    Ejecuta nbdev-help para ver los comandos disponibles

    nbdev-help

Antes de usarlo

  • En Windows requiere WSL; no funciona en cmd ni en PowerShell.
  • Debe instalarse en el mismo entorno de Python que usan Jupyter y tu proyecto.
  • La versión nbdev3 de enero de 2026 trasladó la configuración a pyproject.toml, un cambio incompatible con los proyectos nbdev2.

En colecciones

Frameworks de pruebas y herramientas de automatización

Temas

#jupyter#python#documentation-generator#literate-programming#testing#packaging#ci-cd#conda#developer-tools#documentation-tool

Preguntas frecuentes

¿Qué es nbdev?
Plataforma de desarrollo basado en notebooks que convierte Jupyter Notebooks en paquetes de Python con documentación, pruebas, CI y publicaciones en PyPI y conda. nbdev permite escribir código Python, pruebas y documentación en Jupyter Notebooks mediante marcado ligero. A partir de esos notebooks, exporta módulos de Python, genera un sitio web de documentación con Quarto y GitHub Pages, ejecuta pruebas en paralelo y configura GitHub Actions para la integración continua.
¿nbdev es gratuito? ¿Qué licencia tiene?
nbdev es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿nbdev sigue mantenido?
Mantenimiento activo. El último commit de nbdev fue el 5 nov 2026.
¿Para qué puedo usar nbdev?
Crear una biblioteca de Python cuyo código, pruebas y documentación estén juntos en notebooks Publicar un paquete de Python de código abierto en PyPI con publicaciones automatizadas Mantener la documentación del proyecto generada y enlazada desde el código fuente Editar en un IDE código basado en notebooks y mantenerlos sincronizados
¿Cómo se instala nbdev?
Instala nbdev con pip: pip install nbdev Ejecuta nbdev-help para ver los comandos disponibles: nbdev-help
¿Dónde consigo nbdev?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/AnswerDotAI/nbdev

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados