whatisgithub

What is pycoclaw?

jetpax/pycoclaw — explained in plain English

Analysis updated 2026-05-18

134AstroAudience · developerComplexity · 4/5LicenseSetup · moderate

In one sentence

A MicroPython based AI agent that runs entirely on a five dollar ESP32 chip, no cloud required.

Mindmap

mindmap
  root((pycoclaw))
    What it does
      Runs on ESP32 chip
      Plans and remembers
      Controls hardware
    Capabilities
      Hybrid memory
      Chat channels
      Scheduled tasks
      Subagents
    Extensibility
      Runtime skills
      ScriptoHub marketplace
    Hardware
      ESP32-S3
      ESP32-P4
      ESP32-C6
    Audience
      Hardware hackers
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Build a tiny AI agent that reads sensors and controls hardware directly on a microcontroller.

USE CASE 2

Chat with a physical device over Telegram to trigger real world actions.

USE CASE 3

Add new skills to a deployed device at runtime without reflashing firmware.

USE CASE 4

Run scheduled or event triggered tasks entirely on-device with no cloud dependency.

What is it built with?

MicroPythonESP32C

How does it compare?

jetpax/pycoclawfrectonz/electionwatch.etandreicristi88/vexyn
Stars134159
LanguageAstroAstroAstro
Setup difficultymoderateeasyeasy
Complexity4/52/51/5
Audiencedevelopergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a specific ESP32 board with at least 8MB flash and 4MB PSRAM.

You can use, modify, and share this freely, including commercially, as long as you keep the copyright notice.

So what is it?

PycoClaw turns a cheap microcontroller chip, the ESP32, into a small AI agent that can plan, remember things, and act on the physical world, all running directly on the chip itself rather than in the cloud. The hardware costs around five dollars and uses tiny amounts of power, measured in milliwatts instead of watts. The agent runs on a MicroPython based core called PFC, which aims to match the features of a project called OpenClaw but built to run on a microcontroller instead of a full computer. It gives the device a hybrid memory system that combines simple keyword search with vector based search, both running on the device itself. You can chat with it through Telegram or a companion app called Scripto Studio, with Discord support planned. It can also read and write files, run commands, browse the web, read sensors, generate images, run scheduled tasks, connect to other tools through MCP, and control real world hardware over CAN, I2C, SPI, GPIO, USB, or a small display. Skills, meaning extra abilities the agent can learn, are loaded at runtime from an online marketplace called ScriptoHub, so the device does not need to be reflashed every time you want to add a new capability. The device can also spawn smaller helper agents to handle delegated tasks, wake itself up on a schedule, and save its state to flash memory if the battery is about to die. To get started, you need a supported ESP32 board with enough flash storage and memory, then flash the firmware through a one click browser tool, and manage the device afterward through the Scripto Studio web app. It currently runs in production on the ESP32-S3, ESP32-P4, and ESP32-C6 chips, with support for another chip family still in progress. The project is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me flash PycoClaw onto an ESP32-S3 board using the browser installer.
Prompt 2
Explain how the hybrid memory system combining keyword and vector search works on-device.
Prompt 3
Walk me through adding a new skill to my PycoClaw device from ScriptoHub.
Prompt 4
Show me how to wire up GPIO or I2C hardware control through PycoClaw.

Frequently asked questions

What is pycoclaw?

A MicroPython based AI agent that runs entirely on a five dollar ESP32 chip, no cloud required.

What language is pycoclaw written in?

Mainly Astro. The stack also includes MicroPython, ESP32, C.

What license does pycoclaw use?

You can use, modify, and share this freely, including commercially, as long as you keep the copyright notice.

How hard is pycoclaw to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is pycoclaw for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.