Firmware v6.1.6 · one file · ~41,395 lines

The whole source,
yours to read and to vibe-code.

Atlas is one big C++ file, and all of it is here to read, change, and build on. It is also built for vibe coding: hand the primer and the part you care about to a coding model and it writes with the hardware in mind instead of guessing. Some models swallow all ~262,000 tokens in one upload; some can't, so here it is both ways, the whole file to download and the same code sliced into 45 labelled chunks, each with a token estimate, so a person or a model can grab exactly the part it needs.

The vibe-coding workflow
  1. Read the dev primer, or hand it to your coding model first. Always.
  2. If your model can take the whole file: download atlas_v6_1_6_pioneer.ino below and upload it.
  3. If it can't: browse the chunks, find the section you're changing (e.g. Trivia Bingo, Virtual Pet, Stack), and copy just that chunk in.
  4. Describe the mode, animation, or tweak you want. With the primer, the model already knows the hardware, so it builds instead of guesses.
01

Download the source

The complete firmware, the primer, and the build guide. Right-click → Save, or just click, raw text, no archive.

// FIRMWARE

atlas_v6_1_6_pioneer.ino

~1.9 MB · 41,395 lines

The entire Atlas firmware in one file. Everything, all 37 modes, the face, the games, the text generator, lives here.

↓ Download .ino
// PRIMER

ATLAS_AI_DEV_PRIMER.md

~20 KB · read it, or hand it to a coding model first

Hardware spec, pin map, firmware layout, and the non-negotiable rules for writing code that compiles, whether you write it or a model does.

↓ Download .md
// BUILD GUIDE

ATLAS_BUILD_GUIDE.md

~12 KB · wiring + Arduino IDE setup

Bill of materials, the full pin-wiring table, Arduino IDE board settings, smoke test, and troubleshooting.

↓ Download .md
02

Browse it in bite-sized chunks

The file split along its own section banners. Pick a chunk, read it or copy it, and paste it into your editor or a coding model alongside the primer. Each chunk shows its line range and a rough token count so you know what'll fit.

Loading chunks…
Reading the firmware source…
pick a chunk
Select a section from the list
Pick a section on the left to view its source.

“Copy + preamble” prepends a short instruction line telling the model this is one slice of the Atlas firmware and to follow the primer's rules, handy when you're pasting into a fresh chat.

03

Read it here

The primer and build guide, rendered for reading. The primer is the spec: read it to learn Atlas, or hand it to a coding model. The build guide is for your hands and a soldering iron.

ATLAS_AI_DEV_PRIMER.md Print and Play Creative Manufacturing · v6.1.6
Loading document…
04

Command-line flashers

If you'd rather not flash from the browser, or you're flashing a whole batch of boards, these wrap esptool with sane defaults and good error messages. They flash a pre-compiled binary, so you Export Compiled Binary once in the Arduino IDE, then reuse it.

// CROSS-PLATFORM

flash_atlas.py

Windows / macOS / Linux · Python 3.7+

Auto-detects serial ports. Has a --batch mode that loops: plug a board in, it flashes, you swap the next one. Needs esptool and pyserial.

↓ flash_atlas.py
// WINDOWS

flash_atlas.bat

Windows · double-click to run

No Python needed, calls the esptool.exe bundled with the Arduino ESP32 core. Lists COM ports, asks which one, flashes.

↓ flash_atlas.bat
// FIRMWARE BINARY

The .bin files

you generate these once, in Arduino IDE

Both scripts, and the browser flasher, need the three compiled .bin parts. In Arduino IDE: Sketch → Export Compiled Binary.

↓ See build guide