https://github.com/awesomedev43/python-notebook-local-agent

A Tauri based desktop application which allows a user to run Python notebooks on their local machine in the background with user's already available python setup.
https://github.com/awesomedev43/python-notebook-local-agent

List: python-notebook-local-agent

desktop-app jupyter jupyter-notebooks rust tauri

Last synced: about 16 hours ago
JSON representation

A Tauri based desktop application which allows a user to run Python notebooks on their local machine in the background with user's already available python setup.

• Host: GitHub
• URL: https://github.com/awesomedev43/python-notebook-local-agent
• Owner: awesomedev43
• Created: 2025-01-03T03:03:14.000Z (about 1 month ago)
• Default Branch: main
• Last Pushed: 2025-02-07T15:51:38.000Z (1 day ago)
• Last Synced: 2025-02-07T16:35:40.010Z (1 day ago)
• Topics: desktop-app, jupyter, jupyter-notebooks, rust, tauri
• Language: TypeScript
• Homepage:
• Size: 1.31 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Python Notebook Local Agent



  

  



A [Tauri](https://tauri.app) based desktop application which allows a user to run Python notebook on their local machine in the background with user's already available python setup.

## Features:

- Choose either **One-off** or **Scheduled** mode

  - **One-Off**: Run a notebook in the background job

  - **Scheduled**: Run a notebook in the background job using a schedule specified by cron string

- View and cancel **Scheduled** notebook jobs

- View pervious runs in the **Completed** tab

## Setup

Follow the below steps to get started:



    
Install a Jupyter python environment. Anaconda or Miniconda is recommended

    
Install papermill and nbconvert package through pip install



    
Install any additional packages that might be used by your own notebook

    
Launch the `pynb-worker` application

    
Configure the Python Executable



    
Set the Data Directory



    
Click Save



    
Click on Run tab to begin executing your notebook 



## Screenshots

### Landing Page

![landing](./screenshots/landing.png)

### One-Off Run

![one off](./screenshots/one_off.png)

### Scheduled 

![scheduled one](./screenshots/scheduled_1.png)

![scheduled two](./screenshots/scheduled_2.png)

### Completed

![report 1](./screenshots/report_1.png)

![report 2](./screenshots/report_2.png)

## Feature Wishlist

- Custom labels for both run types

- Allow YAML based execution parameters for notebook

- Allow setting environment variable for notebook directly through the UI

## Known Limitation and Issues

- Only tested on Windows Platform

- All scheduled jobs become inactive on exit and not restarted when application restart

## License

Custom License. By using the software you agree to the following:

1) Software is strictly intended for personal use.

2) Software should only be used on on a personal machine and for non commercial activity.

3) User assumes all risk(s) and liability associated with use of software.

4) Any use beyond simple personal evaluation will require permission of the author

5) Author(s) are not responsible for any issues that arise from usage of this software.

6) The software is free to evaluate currently but that might change in the future

7) License agreement and terms may change in the future. Additional terms that eliminate liability or dictate use maybe be added.