Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/minusxai/smart-nbconvert

Create an automated report from a notebook
https://github.com/minusxai/smart-nbconvert

Last synced: about 1 month ago
JSON representation

Create an automated report from a notebook

Awesome Lists containing this project

README

        

# smart-nbconvert
smart-nbconvert is a tool for automatically generating detailed reports from Jupyter Notebooks with the help of LLMs. This python script processes the notebook, notebook, extracts key content, and converts it into a structured markdown report. It also handles inline images, etc.

## Installation
```bash
pip install -r requirements.txt
```

## Usage
```bash
# export your openai key if you haven't already
export OPENAI_API_KEY="your_openai_api_key"

# simple usage
python smart_nbconvert.py --notebook examples/anthropic_analysis.ipynb

# more controls
python smart_nbconvert.py \
--notebook examples/anthropic_analysis.ipynb \
--model gpt-4o \
--instructions "How to reduce latency" \
--output report.md
```

## Example input/output
![example](./examples/example.png)

## License
MIT License