Free tools Windows power users keep installed
One-click scans. No signup required.
ThatPainter is reader-supported. When you buy through links on our site, we may earn an affiliate commission. Learn More
Portrayt is not a finished product you can order. It is an open-source, Raspberry Pi-based DIY project that turns AI-generated images into slowly changing artwork on a small color e-paper display mounted on a wooden easel.
That combination is the point: AI makes the image quickly, while e-paper presents it more like a small print than a glowing screen. The result is best understood as slow, ambient décor for makers—not a digital photo frame, monitor, or smooth animation display.
What Portrayt actually is
Portrayt was created by Alex Thiele as a compact desktop art project. A Raspberry Pi runs the software, a Pimoroni Inky Impression provides the image surface, and an ordinary small wooden easel supplies the presentation.
#1 Best Overall
- Enjoy a paper-like viewing experience with the 2.13-inch e-paper display. The screen can retain the last displayed image even after power is removed, making it ideal for applications requiring long-term information display without continuous power supply.
- Designed for low-power projects, this e-ink module only consumes energy during screen updates and remains in standby mode most of the time. Perfect for battery-powered devices, smart labels, IoT projects, and long-running applications.
- Featuring a 250x122 pixel black-and-white display, this e-paper HAT delivers clear text and image rendering. Partial refresh support helps reduce update time and power consumption for smoother display operation.
- Equipped with a standard Raspberry Pi 40-pin GPIO header and SPI communication interface, this display module works with Raspberry Pi series boards, Arduino, ESP32 and other compatible development platforms. Built-in voltage conversion supports both 3.3V and 5V MCUs.
- Comes with connection accessories and supports online resources including driver board diagrams and example programs for Raspberry Pi, Arduino, and ESP32, helping developers quickly start their projects.
The project accepts a text prompt, obtains an image through the Stable Diffusion API, converts that image for e-paper, and sends it to the display. The artwork then remains visible until the next update. According to the project’s description on Hackster, prompts can be entered manually or used in an automatic, timed sequence.
Portrayt’s software is published as the portrayt package on PyPI under the MIT license. Its listed release history reaches version 1.0.0 on January 8, 2023. That makes it an early-2020s maker project, not evidence of a currently maintained commercial appliance.
Can you buy a Portrayt?
There is no verified official Portrayt storefront, finished retail unit, or current consumer price in the available project material. The memorable easel is a build assembled from separate parts.
That distinction matters because coverage can make Portrayt sound like a product launch. You may be able to buy compatible components, but purchasing them does not amount to ordering a supported Portrayt kit. You should expect to configure Linux, install Python and Docker dependencies, provide an image-generation API token, and adapt the software if you choose newer display hardware.
The original display
The original Portrayt used Pimoroni’s 5.7-inch Inky Impression. Its key specifications were:
- Resolution: 600 × 448 pixels
- Native colors: seven—black, white, red, green, blue, yellow, and orange
- Technology: ACeP / E Ink Gallery Palette 4000 color e-paper
- Approximate refresh time: 30 seconds
- Usable display area: approximately 114.9 × 85.8 mm
- Board dimensions: approximately 125.4 × 99.5 × 9 mm
- Viewing angle: greater than 170 degrees
“Color e-paper” does not mean tablet-like full-color reproduction. The panel has seven discrete colors. Software dithering places colored pixels in patterns to suggest additional shades, but gradients, shadows, skin tones, and subtle transitions remain highly stylized compared with an LCD or OLED.
Rank #2
- Built-in ESP32-S3 Controller & SPI Interface - Comes with ESP32-S3 as the main MCU (up to 240 MHz) and standard 3-/4-wire SPI (default 4-wire) for easy integration. Supports the classic e-ink reader feel and responsive development flow
- Ultra-Low Power & Power-Off Retention - This epaper display only consumes power during refresh. Static content stays visible without a continuous power supply, ideal for battery-powered devices, smart labels and always-on displays
- Reflective, Sunlight-Readable - The pure reflection mode means no backlight required; the content remains clearly readable even under strong sunlight. Hard-coated anti-glare surface ensures excellent visibility and durability
- Rich Interfaces & Ready for Development - Includes BAT interface (2.2 V-3.7 V), UART0, GPIO header, back/menu/reset/boot buttons, hard-coated anti-glare surface. Compatible with Arduino IDE, and suitable for DIY makers alike
- High-Resolution e-ink Display - This 2.13″ e-paper display with 122x250 resolution delivers sharp black/white contrast and a wide viewing angle. Provides crisp clarity and a paper-like reading experience for smart tags and DIY devices
The limited palette is not merely a defect. It gives generated images a poster-like, graphic quality. Bold silhouettes, flat color areas, strong outlines, and deliberately simplified compositions are more suitable than prompts asking for delicate photorealistic shading. That is an inference from the panel’s palette and conversion process rather than a reported hands-on test.
How the image pipeline works
Portrayt’s workflow can be summarized as:
- The user enters a prompt, or the software updates prompts on a schedule.
- The program sends the request through the Stable Diffusion API.
- The generated image returns to the Raspberry Pi.
- OpenCV downsizes and converts it to the display’s limited palette.
- The Raspberry Pi writes the converted image to the Inky display.
- The display holds the artwork until another refresh.
The project documentation describes support for a single prompt, combining two prompts, and selecting an animation frame. “Animation” needs careful interpretation: this means displaying individual frames one at a time. It is not smooth motion. With each refresh taking roughly half a minute, Portrayt is designed for occasional changes rather than interactive experimentation.
Why e-paper suits an art object
E-paper reflects ambient light instead of illuminating the image like a conventional screen. It is readable in bright surroundings, has a matte paper-like appearance, and consumes display power mainly during refresh. Most importantly, the image persists after power is removed from the display or Raspberry Pi, as described in Pimoroni’s Inky Impression guide.
The Raspberry Pi and network connection still need power while the system is running, so this is not automatically a battery-powered artwork. But the display itself does not need to remain continuously lit to show the last image.
Portrayt therefore treats AI art as ambient décor: generate an image, wait for the panel to refresh, and leave it on a desk. It is a very different experience from opening an image generator and rapidly cycling through alternatives on a monitor.
What an original-style build requires
A typical recreation would need:
- A Raspberry Pi with a compatible 40-pin header
- The original 5.7-inch Inky Impression, if found used or in remaining stock
- A power supply and microSD card
- A network connection for cloud image generation
- A small wooden easel or frame
- A Stable Diffusion service account and API token
Pimoroni says its Inky displays are intended for Raspberry Pi computers with a 40-pin header, including Zero variants. A bare Raspberry Pi Zero may need a header fitted before the display can be installed.
Rank #3
- ✅ This is a e-Paper display, with driver board. Compatible with Raspberry Pi and Jetson Nano
- ✅ Adopts E_Ink Spectra 6(E6) technology, supports 6-Color display. No backlight, keeps displaying last content for a long time even when power down
- ✅Ultra low power consumption, basically power is only required for refreshing. Onboard voltage translator, compatible with 3.3V / 5V MCUs
- ✅With standard Raspberry Pi 40PIN GPIO extension header, supports Raspberry Pi series boards/Jetson Nano.Adapting SPI interface for connecting with controller boards like Raspberry Pi/Jetson Nano/Arduino/STM32, etc.
- ❤️Rich WiKi Resources❤️ We provide official Wiki resources, please contact us for more information.
The physical mounting is simple, but the display is glass. Pimoroni warns that it can crack if dropped or pressed. Support the board without putting pressure on the panel, prevent the Pi or its cable from pulling the display backward, leave ventilation around the computer, and avoid screws or standoffs that could touch the glass.
The documented software setup
The published PyPI instructions describe an older Docker- and Poetry-based setup. The project lists this initial command:
poetry installIt also expects a .env file containing values such as:
REPLICATE_API_TOKEN=<your token here>
RENDERER=inkyThe documented launch command is:
docker compose up --build -dFor Raspberry Pi use, the project says to enable SPI through raspi-config. SPI is the hardware interface used to communicate with the display. If the screen is not detected or refuses to update, checking SPI should be one of the first troubleshooting steps.
For desktop development, the project documents an OpenCV renderer:
REPLICATE_API_TOKEN=<your token here>
RENDERER=opencv
POETRY_EXTRAS=--extras opencvIt also lists:
xhost +for granting Docker access to the local X display. These are the project’s published instructions, not a guarantee that the unmodified package will install or run on every current Raspberry Pi OS release. The package’s latest listed release is from January 2023, while Pimoroni’s current Inky library documentation recommends Raspberry Pi OS Bookworm or later for its current software.
Rank #4
- Provide online user manual (examples for Raspberry Pi/Jetson Nano/Arduino/STM32), please check the manual carefully before using!
- This is an E-Ink raw display, 7.5inch, 800×480 resolution, with embedded controller, communicating via SPI interface.
- Due to the advantages like ultra low power consumption, wide viewing angle, clear display without electricity, it is an ideal choice for applications such as shelf label, industrial instrument, and so on.
- No backlight, keeps displaying last content for a long time even when power down
- Ultra low power consumption, basically power is only required for refreshing
The main limitations
Refresh speed
The original panel takes approximately 30 seconds to refresh. That rules out video, smooth animation, rapid prompt iteration, and real-time visual effects. A scheduled image every few minutes or hours is a natural use; a constantly interactive art generator is not.
Palette and resolution
At 600 × 448 pixels and seven native colors, the screen is suited to small illustrations and graphic compositions. It cannot reproduce the color depth or fine detail of a monitor. Dithering can make images appear richer, but it cannot create genuinely continuous color.
Free tools Windows power users keep installed
One-click scans. No signup required.
Cloud generation
The original package documents a REPLICATE_API_TOKEN, indicating dependence on a cloud image-generation service. A current recreation may require an API account, internet access, authentication, and payment or usage limits. Provider pricing, models, endpoints, and terms can change, so do not assume that the original API workflow remains unchanged. See Replicate for the service itself.
Generation failures can result from an invalid token, network outage, rate limit, insufficient account credit, or a changed model endpoint. Test image generation independently before trying to diagnose the e-paper hardware; otherwise, an API problem can look like a display problem.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Can you recreate Portrayt in 2026?
A similar project is still possible, but an exact recreation is harder. Pimoroni has retired the original 5.7-inch Inky Impression. Its current Inky Impression range uses newer Spectra 6 panels in different sizes and a six-color palette: red, green, blue, yellow, black, and white.
Prices observed in Pimoroni’s UK shop on August 16, 2026 were:
Quick wins for a faster PC:
Repair Windows errors before they cause bigger problemsFix Now →Fix the driver behind crashes, sound loss and screen glitchesFind Drivers →Best Value
- Provide online user manual (examples for Raspberry Pi/Jetson Nano/Arduino/STM32), please check the manual carefully before using!
- This is an E-Ink display module, 1.54inch, 200x200 resolution, with embedded controller, communicating via SPI interface, supports partial refresh.
- Due to the advantages like ultra low power consumption, wide viewing angle, clear display without electricity, it is an ideal choice for applications such as shelf label, industrial instrument, and so on.
- No backlight, keeps displaying last content for a long time even when power down. Ultra low power consumption, basically power is only required for refreshing
- SPI interface, for connecting with controller boards like Raspberry Pi/Arduino/Nucleo, etc. Onboard voltage translator, compatible with 3.3V/5V MCUs
| Model | Resolution | Listed price |
|---|---|---|
| 4-inch Spectra 6 | 600 × 400 | £41.25 |
| 7.3-inch Spectra 6 | 800 × 480 | £66.25 |
| 13.3-inch Spectra 6 | 1600 × 1200 | £191.25 |
The same page listed a Raspberry Pi 5 add-on at £36.00. These are component prices in pounds from that shop at that time; shipping, taxes, regional availability, and the remaining parts are extra.
A current Inky Impression is not automatically a drop-in replacement for the old 5.7-inch unit. The size, resolution, color technology, and likely software path differ. Pimoroni’s library supports older seven-color panels and newer Spectra 6 variants, but the Portrayt application may need adaptation. Do not assume that its old Docker configuration will work unchanged.
Another possibility is Pimoroni’s Inky Frame 5.7-inch. It retains the 5.7-inch, 600 × 448, seven-color format but includes an onboard Raspberry Pi Pico W. That makes it a plausible alternative for someone who wants the same general physical format, not a guaranteed Portrayt replacement. Its microcontroller workflow is different from the original Raspberry Pi/Linux environment, so the published Docker and Python setup should not be expected to run unchanged.
Who should build one?
Portrayt is a good fit if you want a Raspberry Pi project, a non-glowing art object, a low-refresh ambient display, or the deliberately lo-fi look of AI imagery reduced to a handful of e-paper colors.
It is a poor fit if you want instant previews, smooth animation, photorealistic color, a plug-and-play appliance, fully offline generation, or a large wall-sized frame. A conventional LCD or OLED frame will be faster and more colorful, but it will lose the paper-like appearance, sunlight readability, and persistence of e-paper.
Before starting, decide whether you are building a maker project or trying to buy an AI art frame. Then confirm that a roughly 30-second refresh is acceptable, that six- or seven-color artwork appeals to you, that you are comfortable maintaining a Raspberry Pi, and that cloud image generation is acceptable. If the original 5.7-inch format is essential, locating retired hardware may be more difficult than adapting the software to a current panel.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
