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.sh contains the shell commands that install the required packages, configure the camera, and set up the Claude Code environment.
  • 01‑camera/prompts.md lists the Claude prompts used to drive the camera logic.
  • 01‑camera/troubleshooting.md documents 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

  1. 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 ``
  2. Configuration – no environment variables are required. The script uses the default configuration files created during the install.
  3. Running it – after installation, start the Claude Code process manually (or via a provided run.sh if 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.