README.md

metadata

title: Gradio User History
sdk: gradio
sdk_version: 4.27.0
app_file: app.py
emoji: 🖼️
colorFrom: gray
colorTo: indigo
pinned: false
hf_oauth: true
space_ci:
  trusted_authors: []
  secrets: []
  hardware: cpu-basic

Bring User History to your Spaces 🚀

Gradio User History is a plugin (and package) that caches generated images for your Space users.

Key features:

• 🤗 Sign in with Hugging Face
• Save generated images with their metadata: prompts, timestamp, hyper-parameters, etc.
• Export your history as zip.
• Delete your history to respect privacy.
• Compatible with Persistent Storage for long-term storage.
• Admin panel to check configuration and disk usage .

Want more? Please open an issue in the Community Tab! This is meant to be a community-driven implementation, enhanced by user feedback and contributions!

Integration

Integrate Gradio User History in just a few steps:

1. Enable OAuth to your Space

Simply edit your Space metadata in your README.md file:

# README.md
hf_oauth: true

2. Update your requirements.txt

# requirements.txt
git+https://huggingface.co/spaces/Wauplin/gradio-user-history

3. Integrate into your Gradio app

# app.py
import gradio as gr
import gradio_user_history as gr_user_history
(...)

# => Inject gr.OAuthProfile
def generate(prompt: str, profile: gr.OAuthProfile | None):
    image = ...

    # => Save generated image(s)
    gr_user_history.save_image(label=prompt, image=image, profile=profile)
    return image


# => Render user history
with gr.Blocks() as demo:
    (...)

    with gr.Accordion("Past generations", open=False):
        gr_user_history.render()

4. (optional) Add Persistent Storage in your Space settings. Persistent Storage is suggested but not mandatory. If not enabled, the history is lost each time the Space restarts.

And you're done!

Useful links

• Demo: https://huggingface.co/spaces/Wauplin/gradio-user-history
• README: https://huggingface.co/spaces/Wauplin/gradio-user-history/blob/main/README.md
• Source file: https://huggingface.co/spaces/Wauplin/gradio-user-history/blob/main/src/gradio_user_history/_user_history.py
• Questions and feedback: https://huggingface.co/spaces/Wauplin/gradio-user-history/discussions

Preview