gitwtfhub

wtf is openwebui-notes-backup?

parsalotfy/openwebui-notes-backup — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · vibe coderComplexity · 2/5LicenseSetup · easy

TL;DR

A one-file plugin for OpenWebUI that automatically backs up your Notes to a private GitHub repo, giving each note its own version history.

Mindmap

mindmap
  root((notes backup))
    What it does
      Backs up Notes
      Saves as Markdown files
      Per note history
    Tech stack
      Python
      Pydantic
      SQLite
    Use cases
      Scheduled backup
      Restore old version
      Sync across devices
    Audience
      OpenWebUI users
      Vibe coders
    Setup
      GitHub PAT
      Private repo
      Schedule times

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Automatically back up all your OpenWebUI Notes to a private GitHub repository on a schedule.

REASON 2

Recover an older version of a note using GitHub's commit history.

REASON 3

Sync notes across devices by pulling the Markdown files from your GitHub repo.

REASON 4

Detect and clean up backups for notes you renamed or deleted in OpenWebUI.

What's in the stack?

PythonPydanticSQLiteGitHub API

How it stacks up

parsalotfy/openwebui-notes-backup0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultyeasyhardhard
Complexity2/54/54/5
Audiencevibe coderdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 30min

Requires creating a private GitHub repo and a fine-grained personal access token.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

openwebui-notes-backup is a small tool built for people who use OpenWebUI, an open source chat interface for AI models, and want their Notes feature backed up automatically. It works as a Function you paste directly into OpenWebUI's admin panel, so there is no separate server to run, no SSH keys to manage, and no need to install the git command line tool. Once installed, each user configures their own settings: a GitHub personal access token, the name of a private GitHub repository they created, a timezone, and a schedule of times during the day when backups should run. Every note in OpenWebUI gets saved as its own Markdown file in that GitHub repository. Because GitHub tracks file history, this gives each note its own version history: you can see how a note changed over time, restore an older version, or copy text back into OpenWebUI. The backup process runs quietly in the background after a scheduled time passes and the user sends their next chat message, so it never delays the chat response itself. Behind the scenes, the tool checks which notes have changed since the last backup using a hash comparison, then uploads only the new or changed files to GitHub. If a note is renamed, the old file is removed and a new one is created. If a note is deleted and the option is enabled, its file is removed from GitHub too. The tool also corrects itself if someone manually deletes files from the GitHub repo, since it notices the files are missing and re-uploads them on the next run. This project is aimed at OpenWebUI users who want a simple, self-service way to protect their notes without relying on a shared backup system controlled by a server admin. It requires a private GitHub repository and a GitHub access token with write permission, but nothing else outside of what OpenWebUI already provides. It is released under the MIT license, meaning it can be freely reused, including commercially, as long as the copyright notice stays intact.

Yoink these prompts

Prompt 1
Walk me through setting up a fine-grained GitHub PAT with Contents read and write access for this repo.
Prompt 2
Help me configure the SCHEDULE field so backups run right after I finish writing notes each day.
Prompt 3
Explain how the hash-based change detection in this Function decides what to upload.
Prompt 4
Show me how to restore an older version of one of my notes from the GitHub commit history.

Frequently asked questions

wtf is openwebui-notes-backup?

A one-file plugin for OpenWebUI that automatically backs up your Notes to a private GitHub repo, giving each note its own version history.

What language is openwebui-notes-backup written in?

Mainly Python. The stack also includes Python, Pydantic, SQLite.

What license does openwebui-notes-backup use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is openwebui-notes-backup to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is openwebui-notes-backup for?

Mainly vibe coder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.