This project provides instructions for building a "Poetry Camera" using a Raspberry Pi Zero 2 W, a Raspberry Pi Camera Module 3, and a TTL serial thermal printer. It targets hobbyists and beginners in electronics, enabling them to create a device that captures an image, generates a poem from it using OpenAI's GPT-4 Vision, and prints the poem on a receipt.

How It Works

The system captures an image via the Raspberry Pi camera. This image is then sent to GPT-4 Vision for captioning. The generated caption is subsequently processed by GPT-4 to create a poem. Finally, the poem is printed using a connected thermal receipt printer. The core advantage is the integration of AI-powered text generation with a physical, tangible output device, creating a novel interactive experience.

Quick Start & Requirements

• Install: Clone the repository and install dependencies via apt-get and make. Run the main script with python main.py.
• Prerequisites: Raspberry Pi Zero 2 W (or compatible), Raspberry Pi Camera Module 3, TTL serial thermal printer (e.g., Adafruit Mini Thermal Printer), MicroSD card, 5V MicroUSB power supply, MiniHDMI to HDMI adapter, keyboard, mouse. For portability: 6xAA battery holder, DC plug, wire cutters, wire stripper, soldering iron, step-down converter. OpenAI API key required.
• Setup: Requires hardware assembly, OS setup on Raspberry Pi, and software installation. Detailed wiring and configuration steps are provided.
• Links: OpenAI API, rpilocator.com for Raspberry Pi stock.

Highlighted Details

• Leverages OpenAI's GPT-4 Vision for image-to-text and text-to-poem generation.
• Designed for beginners with simplified assembly and detailed instructions.
• Supports portable operation with battery power and a step-down converter.
• Includes instructions for auto-running the script on boot via cron jobs.

Maintenance & Community

The project is maintained by bokito-studio. The README indicates that instructions are still in progress and encourages user feedback. No specific community channels (Discord/Slack) or roadmap links are provided in the README.

Licensing & Compatibility

The repository itself is not explicitly licensed in the README. The software dependencies include Adafruit's thermal printer library, which is typically under an open-source license. OpenAI API usage is subject to OpenAI's terms of service and pricing. Commercial use of the generated poems would depend on OpenAI's API terms.

Limitations & Caveats

The instructions are explicitly stated as "still in progress" with several "TODO" markers for missing details like wiring diagrams and test scripts. The hardware is described as delicate, with multiple instances of camera and Pi damage noted during development. Powering the device reliably, especially for portable use, requires careful component selection and potentially soldering.