friday

README excerpt

# Percepta

[![CI](https://github.com/Perceptax/percepta/actions/workflows/ci.yml/badge.svg)](https://github.com/Perceptax/percepta/actions/workflows/ci.yml)
[![Go Report Card](https://goreportcard.com/badge/github.com/perceptax/percepta)](https://goreportcard.com/report/github.com/perceptax/percepta)
[![License: MIT](https://img.shields.io/badge/License-MPL2-yellow.svg)](https://opensource.org/license/mpl-2-0)

**AI firmware development with hardware validation.** Generate code. Flash hardware. Validate behavior. All automated.

Percepta uses Claude Vision to observe, validate, and compare physical hardware behavior (LEDs, displays, boot timing) without modifying firmware or hardware. Generate BARR-C compliant firmware with AI, automatically validated on real hardware. Close the feedback loop in embedded development — the only AI tool that knows if your code actually works.

## What is Percepta?

Percepta is the perception kernel for embedded development. Point a webcam at your ESP32/STM32/FPGA, and Percepta tells you exactly what it's doing:

```bash
$ percepta observe fpga

Signals (3):
LED1: blue blinking ~2.0Hz
LED2: purple blinking ~0.8Hz
LED3: red solid

Observation complete (748ms)
```

Then validate it with assertions:

```bash
$ percepta assert fpga "led('LED1').blinks() && led('LED1').color_rgb(0,0,255)"
✓ All assertions passed
```

And track regressions across firmware versions:

```bash
$ percepta diff fpga --from v1 --to v2
~ LED1: blue blinking 2.0Hz → 2.5Hz (M