Search the docs, videos, blog, apps, teams, skills and release notes.
At a glance
What it is
Comprehensive guide to Raspberry Pi projects including model selection, OS setup, server builds, GPIO programming, home automation, and advanced applications.
A skill is a written procedure a bot loads when a job calls for it. This one is a single file, SKILL.md, and the whole file is on this page.
The whole file, exactly as it downloads. Read it before you rely on it.
SKILL.md
425 lines · 2,384 words
Gather requirements. Ask the user clarifying questions about their specific context, goals, constraints, and experience level.
Analyze the situation. Review the information provided and identify key factors, challenges, and opportunities relevant to raspberry pi guide.
Comprehensive guide to Raspberry Pi projects including model selection, OS setup, server builds, GPIO programming, home automation, and advanced applications.
Nothing. It ships with Murage, which is open source. Your bots run on the AI plan you already have.
Yes. Open it in Settings → Skills to read, edit or duplicate it. Skill Guard scans it again after every edit.
Download the app, connect the AI you already pay for, and tell your Chief of Staff what needs doing. Plan on about ten minutes from install to a working team.
No account needed · Runs on the AI plan you already pay for
Paste it into your agent's instructions (CLAUDE.md, AGENTS.md or a custom GPT), or add it to a bot in Murage.
Ask Ember for the bot, then switch the skill on in its settings.
Step 1
Send your Chief of Staff this message. It proposes the bot and its role first, and creates it when you say go.
Send this to Ember
“Create a bot that uses the Raspberry Pi Guide skill, and show me the plan first.”
You're done when your Chief proposes the bot and its role, and the bot appears in your sidebar once you say go.
Step 2
You're done when you see the bot’s skills and the library.
Step 3
You're done when the skill shows as on for that bot.
Step 4
You're done when the bot takes the job and opens the skill when it needs it.
Prefer to do it yourself? Choose + in the sidebar, then New Bot.Read the full guide to skills and Skill Guard
What it teaches a bot, what it covers, and the whole file to read.
What it covers
When to Use
Process
Questions to Ask First
Model Selection Guide
OS Setup
Project Guides
GPIO Basics
Python Programming on Pi
Docker on Raspberry Pi
Remote Access
Maintenance and Optimization
Troubleshooting
Output Format
Example
Develop the framework. Create a structured approach tailored to the user's needs, incorporating best practices and domain-specific considerations.
Deliver actionable output. Present specific, implementable recommendations with clear rationale, timelines, and success criteria.
Address edge cases. Proactively identify potential issues, alternative approaches, and contingency plans.
Use this skill when:
User needs guidance on raspberry pi guide
User asks about raspberry pi guide best practices or techniques
User wants a structured approach to raspberry pi guide
Do NOT use this skill when:
A more specialized skill exists for the specific subtopic
The request is outside the scope of raspberry pi guide
Before recommending a setup, I need to understand your goals:
What do you want to build? (Media server, NAS, retro gaming, home automation, learning Linux, web server, IoT)
What is your experience with Linux and the command line? (None / Basic / Comfortable / Expert)
Do you have programming experience? In which languages?
What is your budget? ($50 / $100 / $200+)
Do you need GPIO pins for physical computing projects?
Will this run 24/7 as a server, or be used intermittently?
Do you need desktop GUI access, or is headless (no monitor) fine?
What networking do you need? (Ethernet only / WiFi / Both)
CPU: Broadcom BCM2712, quad-core Cortex-A76 @ 2.4GHz
RAM: 2GB, 4GB, or 8GB options
Key features: PCIe 2.0 connector, dual 4K HDMI, USB 3.0, hardware video decode
Best for: Desktop replacement, media servers, Docker hosting, development
Power: USB-C, requires 5V 5A (27W) official power supply
Cost: $60 (2GB) to $80 (8GB)
CPU: Broadcom BCM2711, quad-core Cortex-A72 @ 1.8GHz
RAM: 1GB, 2GB, 4GB, or 8GB
Best for: Still excellent for most projects, widely supported, mature ecosystem
Power: USB-C, 5V 3A recommended
Cost: $35-75 depending on RAM
CPU: Quad-core Cortex-A53 @ 1GHz
RAM: 512MB
Best for: Small embedded projects, IoT sensors, Pi-hole, lightweight tasks
Key features: WiFi, Bluetooth, tiny form factor
Power: Micro-USB, very low power consumption
Cost: $15
Note: This is a microcontroller, NOT a Linux computer
Best for: Arduino-style projects, sensor reading, motor control
Programming: MicroPython or C/C++
Cost: $4-6
| Use Case | Recommended Model | RAM |
|---|---|---|
| First Pi / Learning | Pi 5 or Pi 4 | 4GB |
| Media server (Plex/Jellyfin) | Pi 5 | 8GB |
| NAS | Pi 5 | 4GB+ |
| Pi-hole (ad blocking) | Pi Zero 2 W | 512MB |
| Retro gaming (RetroPie) | Pi 4 or Pi 5 | 4GB |
| Home automation | Pi 4 | 2-4GB |
| Docker host | Pi 5 | 8GB |
| Desktop replacement | Pi 5 | 8GB |
| IoT sensor node | Pi Zero 2 W or Pico W | - |
Download from raspberrypi.com/software
Available for Windows, macOS, and Linux
This is the official and easiest way to flash OS images
Insert microSD card into computer (32GB minimum, 64GB recommended, Class 10 / A2)
Open Raspberry Pi Imager
Choose OS: Raspberry Pi OS (64-bit) for most users
Choose Storage: Select your microSD card
Click the gear icon for advanced options:
Set hostname (e.g., mypi.local)
Enable SSH (important for headless setup)
Set username and password
Configure WiFi (SSID and password)
Set locale and timezone
Click Write and wait for completion
With monitor: Insert SD card, connect HDMI, keyboard, mouse, power on Headless (no monitor):
Insert SD card and power on
Wait 2-3 minutes for first boot
Connect via SSH: connect-to hostname.local (or use IP address)
Find IP address from router admin page if .local doesn't resolve
update-packages && upgrade-packages -y
system-config-tool # Configure additional settingsKey system-config-tool options:
Interface Options: Enable VNC, SPI, I2C, Serial as needed
Performance Options: Set GPU memory split
Localization: Timezone, keyboard layout
Ubuntu Server - For serious server use, better Docker support
LibreELEC - Dedicated Kodi media center OS
RetroPie - Retro gaming emulation
Home Assistant OS - Dedicated smart home OS
DietPi - Minimal, optimized, very lightweight
Difficulty: Beginner | Time: 30 minutes | Best on: Pi Zero 2 W or any Pi
Start with fresh Raspberry Pi OS Lite installation
Assign static IP address:
nmcli con mod "Wired connection 1" ipv4.addresses 192.168.1.100/24
nmcli con mod "Wired connection 1" ipv4.gateway 192.168.1.1
nmcli con mod "Wired connection 1" ipv4.method manualInstall Pi-hole:
Security Note: Piping scripts directly from the internet to an interpreter (
request | run-installer) executes unverified code. For production systems, download the script first, inspect it, then execute it. These commands are shown for convenience in hobby/development contexts only.
request -sSL [URL] | run-installerFollow the installer prompts
Set your router's DNS to the Pi's IP address
Access admin panel at [URL]
Add additional blocklists for better coverage
Difficulty: Beginner-Intermediate | Time: 1 hour | Best on: Pi 4 (4GB) or Pi 5
Install Jellyfin (see security note above about request | run-installer patterns):
install-package request gnupg
request -fsSL [URL] | run-installerConnect external USB drive with media files
Auto-mount the drive:
blkid # Find drive UUID
mkdir /mnt/media
# Add to [system-path] UUID=xxxx /mnt/media ext4 defaults,nofail 0 2
mount -aAccess Jellyfin at [URL]
Add media libraries pointing to /mnt/media subdirectories
Install Jellyfin apps on TV, phone, tablet for playback
Difficulty: Intermediate | Time: 2 hours | Best on: Pi 4 or Pi 5
Connect USB drives (consider USB 3.0 enclosure with RAID)
Install OpenMediaVault:
download -O - [URL] | run-installerAccess OMV web interface at [URL]
Configure storage: Create filesystems, shared folders
Enable SMB/CIFS for Windows shares or NFS for Linux
Set up user accounts and permissions
Configure scheduled backups with rsync
Difficulty: Beginner | Time: 1-2 hours | Best on: Pi 4
Flash RetroPie image using Raspberry Pi Imager
Connect controllers (USB or Bluetooth)
Boot and configure controller mapping in EmulationStation
Transfer ROMs via USB, SFTP, or Samba share
Supported systems: NES, SNES, Genesis, N64, PS1, GBA, Arcade, and many more
Configure shaders for CRT-like appearance
Scrape game metadata for cover art and descriptions
Difficulty: Intermediate-Advanced | Time: 2-4 hours | Best on: Pi 4 or Pi 5
Flash Home Assistant OS using Raspberry Pi Imager (choose "Other" > "Home Assistant")
Boot and wait 5-10 minutes for initial setup
Access at [URL]
Create account and configure location
Auto-discovery finds compatible smart devices
Add integrations: Zigbee (with USB dongle), Z-Wave, WiFi devices
Create automations: motion-triggered lights, temperature-based fan control
Build dashboards for room-by-room control
3.3V and 5V power pins - Power external components
Ground pins - 8 ground pins available
GPIO pins - General Purpose Input/Output, 3.3V logic
Special function pins: I2C (SDA/SCL), SPI (MOSI/MISO/SCLK/CE), UART (TX/RX)
GPIO pins are 3.3V logic - NEVER connect 5V directly to a GPIO pin
Maximum current per pin: 16mA (safe), some sources say up to 50mA total across all pins
Use level shifters for 5V devices
Use transistors or relays for high-power loads
from gpiozero import LED, Button
from signal import pause
led = LED(17) # LED on GPIO 17
button = Button(2) # Button on GPIO 2
button.when_pressed = led.on
button.when_released = led.off
pause() # Keep program runningLED control and PWM dimming
Button and switch input
Temperature/humidity sensors (DHT22, BME280)
Relay control for appliances
Servo and stepper motor control
OLED and LCD displays
NeoPixel / WS2812B LED strips
PIR motion sensors
Ultrasonic distance sensors
install-package python3-pip python3-venv
python3 -m venv myproject
source myproject/bin/activate
install-python-package gpiozero RPi.GPIO requests flaskgpiozero - Simple GPIO interface
RPi.GPIO - Lower-level GPIO control
picamera2 - Camera module interface
Flask - Web server for dashboards
MQTT (paho-mqtt) - IoT messaging
Adafruit CircuitPython libraries - Sensor support
schedule - Task scheduling
psutil - System monitoring
Security Note: Piping scripts directly from the internet to an interpreter (
request | run-installer) executes unverified code. For production systems, download the script first, inspect it, then execute it.
request -fsSL [URL] | run-installer
usermod -aG docker $USER
# Log out and back in
docker run hello-world # Test installationinstall-package docker-compose-pluginPortainer - Docker management GUI
Pi-hole - DNS ad blocking
Nginx Proxy Manager - Reverse proxy with SSL
Heimdall - Application dashboard
Uptime Kuma - Service monitoring
Grafana + InfluxDB - Data visualization
Mosquitto - MQTT broker for IoT
Watchtower - Auto-update containers
Use images built for arm64 architecture
Limit container memory with --memory flag
Use bind mounts instead of named volumes for better I/O
Monitor with docker stats
Consider an SSD instead of SD card for heavy I/O workloads
# From another computer:
connect-to raspberrypi.local
# Or use IP address:
connect-to 192.168.1.100Enable VNC: system-config-tool > Interface Options > VNC
Install RealVNC Viewer on your computer
Connect using hostname.local or IP address
Security Note: Review scripts before piping to interpreter. Download first with
request -fsSL [URL] -o install-script, inspect, then run.
request -fsSL [URL] | run-installer
tailscale upCreates secure VPN tunnel without port forwarding
Access Pi from anywhere using Tailscale IP
SCP: scp file.txt user@pi:/home/user/
SFTP: Use FileZilla or WinSCP with SFTP protocol
rsync: rsync -avz folder/ user@pi:/backup/ (incremental sync)
Samba: Mount Pi folders as network drives on Windows/Mac
SD cards have limited write cycles; they will eventually fail
Use log2ram to reduce writes: keeps logs in RAM
Consider booting from USB SSD for reliability and speed
Always shut down properly: shutdown -h now
Keep backups of your SD card image
Overclock carefully (Pi 5 supports it well with active cooling)
Use 64-bit OS for 4GB+ RAM models
Disable unnecessary services: systemctl disable bluetooth if unused
Use lightweight desktop (LXDE) or go headless
Monitor temperature: vcgencmd measure_temp
Add heatsinks and fan for sustained workloads
Change default password immediately
Use SSH keys instead of passwords
Disable password SSH login after setting up keys
Keep system updated: update-packages && apt upgrade
Install and configure UFW firewall
Change SSH port from default 22
Use fail2ban to block brute-force attempts
Image entire SD card periodically (use Raspberry Pi Imager or dd)
Back up specific config files with rsync
Use version control (git) for custom scripts
Document your setup so you can recreate from scratch
Check power supply (official supply recommended, undervoltage causes issues)
Re-flash SD card
Try a different SD card
Check HDMI connection (try other HDMI port on Pi 4/5)
Look for steady green LED (means SD card is being read)
Check WiFi credentials in imager settings
Use nmcli or system-config-tool to reconfigure network
For Ethernet, check cable and router DHCP settings
ip addr shows current IP addresses
ping google.com tests internet connectivity
Check temperature: overheating causes throttling
Check CPU usage: htop
Check disk space: df -h
Check memory: free -h
Lightning bolt icon on desktop = insufficient power supply
Deliver the response as a structured document with clear headings and actionable content. Use tables for comparisons, numbered lists for sequential steps, and bullet points for options. Include specific examples where applicable.
[Raspberry Pi Guide deliverable]
1. Context and objectives
2. Analysis or framework
3. Specific recommendations with rationale
4. Action items with timelineInput: "Help me with raspberry pi guide for a mid-size project."
Output: A complete raspberry pi guide framework tailored to the specific context, with actionable steps, relevant considerations, and measurable outcomes.
SKILL.md
425 lines · 2,384 words
The text of SKILL.md is shown as it downloads, under the Apache-2.0 license, by Ferrox Labs. The license is the one in the file's own frontmatter.
Your new bot
Raspberry Pi Guide bot
Waiting in your sidebar once you say go.
No account needed · Runs on the AI plan you already pay for