Start Here

The goal of this page is one thing: get a program running on a Pico and see it work. About ten minutes. You need a Pico 2 W, a USB cable, and a computer with Chrome or Edge.

New to the words? A Pico is the little computer. MicroPython is the language you'll write in. A program is just a list of instructions you give it. Every term is explained in the Glossary, peek anytime.
Any step below not working? Don't wrestle with it, jump to Fix a Board. It has a step-by-step recovery that clears stuck connections and pinpoints exactly what's wrong.
1

Put MicroPython on the Pico (once per board, ever)

A brand-new Pico is empty. You give it its "operating system," called MicroPython, one time.

Hold down the little BOOTSEL button on the Pico, and while holding it, plug the Pico into your computer with the USB cable. It pops up like a USB flash drive.

Now drag this one file onto that drive. The drive disappears on its own, that means it worked. Done forever.

2

Open the code editor in your browser

Go to viper-ide.org in Chrome or Edge. That's it, nothing to install. This is where you write and run code. It's called Viper IDE (an "IDE" is just a place to write code).

3

Connect to your Pico

Click the connect button (top right), choose USB, and pick your Pico from the list. When it connects, you can see the Pico's files on the left and a place to type commands at the bottom.

Nothing shows up? Your USB cable might be a charge-only cable (they look identical to data cables but can't carry data). Try a different cable.
4

Run your first program

Load the "hello world" example with this one-click link (it drops the file onto the Pico), then open main.py and press Run. You'll see it print messages in the terminal at the bottom.

Change the words in the file, press Run again, and watch your change happen. That's the whole loop: edit, run, see. You're programming.

🎉 That's the milestone. If you saw your words print and change, everything else in this guide is just more of the same loop, with sensors, screens, and worm bins added. A file saved as main.py even runs by itself every time the Pico gets power, with no computer attached. That's how a finished project "ships."

Where to next?


The Sessions →

The full workshop, four steps in order.

Use Sensors →

Add a real sensor and see it read the world.

Fix a Board →

When something's stuck: a guided recovery.