Metadata-Version: 2.4
Name: pbl-lm
Version: 0.3.0
Summary: Projects by Laksh terminal for CircuitHeroesLM, boards, and local AI
Author: Lakshveer Rao
License-Expression: MIT
Project-URL: Homepage, https://www.circuitheroes.com/
Project-URL: Repository, https://github.com/lakshveerrao/circuitheroesLM
Project-URL: Documentation, https://github.com/lakshveerrao/circuitheroesLM/blob/main/docs/PBL.md
Keywords: esp32,tinyml,embedded-ai,electronics,circuitheroeslm
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Education
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: model
Requires-Dist: numpy>=1.26; extra == "model"
Requires-Dist: torch>=2.2; extra == "model"
Dynamic: license-file

# pbl-lm

**PBL means Projects by Laksh.**

Install the CircuitHeroesLM hardware and local-AI terminal:

```sh
pip install pbl-lm
pbl
```

PBL provides an arrow-key terminal for board detection, hardware profiles,
display/touch/microphone/speaker tests, firmware upload, serial monitoring and
the circuitheroesLM native ESP32-S3 pilot.

PBL 0.3 adds **Import Git test code**. Paste a public HTTPS Git link and PBL
shallow-clones it, verifies repository limits, paths, symbolic links, ESP-IDF
structure and risky build hooks, matches it to the chosen processor, board and
display, and registers the exact verified commit as a selectable third-party
test.

- no Git clone;
- no UV environment;
- no Arduino CLI;
- no manual file copying;
- macOS, Linux, Windows and Ubuntu Touch launcher support;
- dependency-free Python launcher;
- version-matched official payload on first use.

The first `pbl` launch transfers the immutable PBL release associated with the
installed package version. Later launches use the local cached copy.

Researchers who also want the Python model-development dependencies can use
`pip install "pbl-lm[model]"`. They are intentionally not required by the
lightweight PBL hardware terminal.

Project and measured model results:
[github.com/lakshveerrao/circuitheroesLM](https://github.com/lakshveerrao/circuitheroesLM)
