The Problem
People who build DIY Raspberry Pi projects often struggle to get the hardware and software stack in place quickly. Existing tutorials mix code, images and instructions, making it hard to identify the exact steps needed to set up a camera‑based prototype.
What This Does
curious-machines supplies a minimal, ready‑to‑run guide for Project 01 – a camera‑based Raspberry Pi prototype that demonstrates visual and audio processing ideas.
01‑camera/setup.shcontains the shell commands that install the required packages, configure the camera, and set up the Claude Code environment.01‑camera/prompts.mdlists the Claude prompts used to drive the camera logic.01‑camera/troubleshooting.mddocuments common issues and fixes.- The accompanying Markdown files (
README.md,01‑camera/README.md) and the large image set provide context and step‑by‑step visual guidance.
How It Is Wired
Execution starts at 01‑camera/setup.sh. The script runs as a Bash entry point on the target Pi.
- The first block updates the system (
apt‑get update && apt‑get upgrade -y). - Subsequent lines install the camera driver, the Claude Code runtime (
pip install claude-code), and any dependencies. - The script finally copies the prompt files to a working directory and sets permissions.
No additional modules or functions are invoked; the script directly manipulates the filesystem and package manager. The only external touch is the network for downloading packages and the local camera device. Because the script contains no loops or callbacks, changes to it affect only the installation phase.
How To Use It
- Setup – clone the repo and run the installation script on your Raspberry Pi. ``
bash git clone https://github.com/moses-y/curious-machines cd curious-machines/01-camera chmod +x setup.sh ./setup.sh`` - Configuration – no environment variables are required. The script uses the default configuration files created during the install.
- Running it – after installation, start the Claude Code process manually (or via a provided
run.shif added). The README explains how to launch the camera loop and interact with the prompts.
If the setup.sh fails, consult troubleshooting.md for common errors such as missing camera drivers or network timeouts.
Real-World Use
A small retail kiosk could use this setup to capture customer faces, apply real‑time pixelation, and log footfall data. The exact prompt and image processing logic would live in the prompts.md file, allowing quick swaps between different visual effects.
Code Health & Issues
- Medium – No tests detected; all paths are unverified.
- Medium – No CI/CD configuration; builds and deployments are manual.
- Medium – No license file; usage rights are unclear.
- Low – Only a single executable script; no modular code to refactor.
The Bottom Line
curious-machines offers a quick, image‑rich starting point for building camera‑based Pi prototypes. It lacks automated testing, CI, and licensing clarity, so it is best suited for hobbyists or rapid prototyping teams rather than production deployments.