Merge multiple jupyter notebooks

#python #jupyter #notebook #automation

SUNNY BHAVEEN CHANDRA Sept 18 2020 · 1 min read
Share this
Image - Designed by fullvector / Freepik

Recently I faced a need to merge multiple jupyter notebooks into one. And I realized that it's hard to copy and paste it from one notebook to another if you have more than two notebooks.
Hence I thought of writing a python script that can merge them all into one notebook. And I was quite successful.  

This code here is intended to merge multiple jupyter notebooks into one notebook. The final notebook will also contain the parent file names along with cells from different notebooks.

Kindly follow the below instructions -

STEP 1. Download or mergeJupyterFiles.ipynb 

STEP 2. Now place this file or ipynb file into a folder containing other jupyer notebooks 

STEP 3. Now if you have copied the .py file then use the following command in terminal python

Message of success

[NOTE: make sure you are in the same location as this py file exists]

And in case you are using the notebook file from the repository then you can directly run it in your jupyter notebook

STEP 4. After completing step 4 you’ll see a message of success and a baseFile.ipynb file will be created which is the merged file of all the files present inside a result folder

Result (Sample)

Common advise for the best results -

1. In the case of the non-existence of a notebook you’ll get the following error. Hence one should make sure that your target notebooks are present at the same location.

Error message

2. Make sure your notebooks contain ordered prefixes like file 01, file 02, etc in their names such that they can be arranged. This will help you to merge them serially. Some examples of the file name are like — “Session 1.01 topicName”, “Session 1.02 another topic Name”

Full python code implementation-

# Author: Sunny Bhaveen Chandra
# Contact: [email protected]

# import required files
import json
import os

def create_baseFile():
	'''This creates a base file in which we merge all the files'''
	baseData = '''{
	"cells": [{"cell_type": "markdown", "metadata": {},
	"source": ["# *Merged Jupyter Notebook*"]}],
	"metadata": {
	"kernelspec": {
	"display_name": "Python 3",
	"language": "python",
	"name": "python3"},
	"language_info": {
	"codemirror_mode": {"name": "ipython","version": 3},
	"file_extension": ".py",
	"mimetype": "text/x-python",
	"name": "python",
	"nbconvert_exporter": "python",
	"pygments_lexer": "ipython3",
	"version": "3.7.4"}
	"nbformat": 4,
	"nbformat_minor": 2}'''

	Filename = 'baseFile.ipynb'
	with open(Filename,'w+') as f:

def read_file_as_json(Filename):
    with open(Filename,'r') as f:
        whole_file =
    data = json.loads(whole_file)
    return data
def mergeAllJupyterFile(file=None):
    if not os.path.exists('baseFile.ipynb'):

    # read files
    base_file = read_file_as_json('baseFile.ipynb')
    next_files = read_file_as_json(file)

    '''Create a header with each file to make a clear boundry among files'''
    FileBoundry =   {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Merged Jupyter Notebook"
    FileBoundry['source'] = f'<hr><font color="green"><h1>from file: {file[:-6]}</h1></font>'

    # merge cells of second file into base_file one with Name of file as a header
    base_file['cells'] = base_file['cells'] + [FileBoundry] + next_files['cells']

    # dump data in baseFile
    Filename = 'baseFile.ipynb'
    with open(Filename,'w+') as f:
def create_base_for_results():
    '''This moves the merged file to log folder created for it'''
    # path to root log directory 
    root_logDir = os.path.join(os.curdir, "results_folder")

    def move_file_sub_log_dir():
        '''This moves the baseFile to sub log directory'''
        # generate run id based on current time
        import time
        run_id = time.strftime("mergedFile_%Y_%m_%d-%H_%M_%S")
        # path to move baseFile
        move_to_path = os.path.join(root_logDir, run_id)
        if not os.path.isdir(move_to_path):
        base_file = 'baseFile.ipynb'
        # finally move baseFile
        import shutil
        shutil.move(base_file, move_to_path)
        print(f"\n## Access merged file at \
the following location ##\n{move_to_path}")

class CleanExit(Exception):
    '''Protects program from stopping abruptly'''
    def __init__(self):
        print("\n## No jupyter notebooks found to merge ##")
        print("\nexiting program....")

def safelyExit():
    '''safely exit when target notebooks are not present'''
    import sys
        raise CleanExit

def is_target_notebooks_exists(listOfFiles):
    for file in listOfFiles:
        if ".ipynb" in file:
            return True
    return False

def main():
	# get the list of all the files
    listOfFiles = os.listdir()

    # remove unwanted files from list of files
    if '.ipynb_checkpoints' in listOfFiles:
    if "mergeJupyterFiles.ipynb" in listOfFiles:
    # check the existence of taget notebook files
    if not is_target_notebooks_exists(listOfFiles):
	# iterate over the list of files to merge them
    for file in listOfFiles:
        if ".ipynb" in file:
if __name__=="__main__":
        print("\n## Attempt Successfull!! ##")
    except Exception as e:
        print("## For any feedbacks mail-to: <[email protected]> ##\n")
* * *

Originally published at

Read next