PaperPiAI  by dylski

E-ink picture frame using Stable Diffusion on Raspberry Pi Zero

created 7 months ago
274 stars

Top 95.2% on sourcepulse

GitHubView on GitHub
Project Summary

This project provides a self-sufficient, offline e-ink picture frame powered by a Raspberry Pi Zero 2, capable of generating an infinite array of AI art using Stable Diffusion. It's designed for hobbyists and makers interested in creating unique, generative art displays with minimal maintenance.

How It Works

The system leverages OnnxStream for running Stable Diffusion models optimized for the Raspberry Pi Zero 2. It generates images based on customizable prompts, with options for intelligent cropping to focus on salient image features if custom resolutions aren't directly supported. The generated images are then displayed on a 7.3" 7-color e-ink screen.

Quick Start & Requirements

  • Install: Clone the repository and run scripts/install.sh.
  • Prerequisites: Raspberry Pi Zero 2, Inky Impressions 7.3" 7-color e-ink display (or compatible Waveshare), Raspbian Bullseye Lite, SPI and I2C interfaces enabled.
  • Setup: Requires increasing swapfile size to 1024MB for compilation and enabling SPI/I2C via raspi-config. The installation process, including model downloads, can take several hours.
  • Documentation: https://github.com/dylski/PaperPiAI

Highlighted Details

  • Generates unique images offline, with each image taking approximately 30 minutes to create and 30 seconds to refresh.
  • Supports custom resolutions for Stable Diffusion XL Turbo 1.0 and intelligent cropping for other models.
  • Prompts are configurable via JSON files, allowing for easy customization of subjects and styles.
  • Automation is supported via cron jobs for daily image generation and display.

Maintenance & Community

The project acknowledges contributions from Vito Plantamura, Delph, and Roger. Further community engagement details are not explicitly provided in the README.

Licensing & Compatibility

The project's licensing is not explicitly stated in the README. Compatibility for commercial use or closed-source linking is not specified.

Limitations & Caveats

The installation process is described as manual and time-consuming, with potential issues on older Raspbian versions. E-ink display performance can be affected by temperature, potentially causing discoloration. The project currently lacks a local LLM for prompt generation on the RPi Zero 2.

Health Check
Last commit

3 months ago

Responsiveness

1 day

Pull Requests (30d)
0
Issues (30d)
0
Star History
12 stars in the last 90 days

Explore Similar Projects

Feedback? Help us improve.