arifnd/buckpow repository overview

⁠BuckPow

Measure. Benchmark. Understand.

BuckPow is an open-source, self-hosted energy observability and benchmarking platform for low-power edge devices.

Unlike traditional IoT dashboards that focus only on live telemetry, BuckPow helps developers, makers, and researchers measure, record, and compare energy consumption across experiments. Whether you are benchmarking a Raspberry Pi, optimizing ESP32 firmware, evaluating a small solar panel, or profiling TinyML workloads, BuckPow turns measurements into actionable engineering insights.

⁠Features

• Real-time voltage, current, power, and energy monitoring
• Session-based experiment recording
• Energy benchmarking and comparison
• Automatic device registration
• Device API key authentication
• Configurable alerts
• Project organization
• CSV and Excel export
• REST API
• Self-hosted with Docker

⁠Typical Use Cases

• Raspberry Pi power benchmarking
• ESP32 and ESP8266 energy monitoring
• Battery discharge testing
• Solar-powered IoT evaluation
• TinyML and Edge AI energy profiling
• Firmware power optimization
• Engineering laboratory experiments
• Academic research

⁠Quick Start

The recommended deployment method is Docker Compose.

git clone https://github.com/arifnd/buckpow.git
cd buckpow
docker compose up -d

BuckPow will start together with PostgreSQL and Nginx.

To configure production settings, create a .env file:

APP_ENV=production
JWT_SECRET=your-strong-secret-key
DATABASE_URL=postgresql://buckpow:buckpow@db:5432/buckpow

[email protected]
ADMIN_PASSWORD=your-secure-password

DISABLE_API_DOCS=true

Restart the services after updating the configuration.

docker compose down
docker compose up -d

⁠Supported Hardware

Current support includes:

• ESP32
• ESP8266
• INA219

Planned support:

• Raspberry Pi Agent
• Linux Agent
• INA226
• MQTT devices
• Additional DC power sensors

⁠REST API

BuckPow exposes REST APIs for:

• Authentication
• Device management
• Measurement ingestion
• Session management
• Projects
• Alerts
• Benchmarking
• Dashboard statistics

Interactive API documentation is available through Swagger UI and ReDoc when enabled.

⁠Why BuckPow?

BuckPow was created to answer engineering questions such as:

• Which firmware version is more energy efficient?
• Which hardware consumes less power?
• Is a solar panel sufficient for my system?
• How long will the battery last?
• How much energy does an AI inference consume?

Instead of relying on assumptions, BuckPow helps you make decisions based on real measurements.

⁠Project Status

BuckPow is currently under active development and is not yet considered production-ready.

The Docker image is intended for evaluation, testing, and development while new features continue to be added.

⁠Documentation

Complete documentation, installation guides, API references, and examples are available in the GitHub repository.

https://github.com/arifnd/buckpow⁠

⁠License

Released under the MIT License.