FoloToy/ai-passport

What it solves

FoloToy AI Passport is an open-source wearable AI hardware project. It provides a development baseline—including hardware specifications, stable interfaces, and reference implementations—to allow developers to build custom AI-powered applications and assistants on a specific wearable device.

How it works

The project uses an ESP32-C3 microcontroller and a Board Support Package (BSP) to isolate low-level hardware details from application logic. It defines a strict "hardware capability contract" that exposes stable APIs for the device's display, audio (playback and microphone), buttons, battery monitoring, Wi-Fi, and Bluetooth LE. Developers create new applications by branching from a clean main baseline and implementing their logic in the main/ directory while utilizing the BSP for hardware interaction.

Who it’s for

It is designed for developers and AI agents who want to create wearable AI applications, such as habit trackers, Pomodoro timers, or AI hardware companions, without needing to rewrite low-level drivers.

Highlights

• Hardware Capability Contract: Clear boundaries and APIs for the display (ST7789P3), audio (ES8311), and input buttons.
• Reference Implementations: Includes diverse demo branches for a stopwatch, Tetris, a cat-themed Pomodoro timer, and a BLE-based AI companion.
• AI-Agent Ready: Provides specific guides (AGENTS.md) and prompts to help AI assistants develop and port applications to the hardware.
• Modular Architecture: Separates board-level details (BSP) from application logic to ensure stability and portability.