MiniBrew Home Assistant Integration

A Home Assistant custom component for integrating MiniBrew Craft and Keg devices into your smart home.

DISCLAIMER: This is an unofficial, community-developed integration. It is not affiliated with, endorsed by, officially maintained by, or in any way officially connected to MiniBrew B.V. or any of its subsidiaries or affiliates. The official MiniBrew website can be found at https://minibrew.io. The names "MiniBrew" and related names, marks, emblems and images are registered trademarks of their respective owners.

Overview

This integration allows you to monitor and control your MiniBrew brewing devices through Home Assistant. It supports both MiniBrew Craft (brewing devices) and MiniBrew Keg (dispensing devices), providing real-time monitoring of temperatures, process phases, and device status.

IMPORTANT: A MiniBrew Pro subscription is required for this integration to function. The integration uses the MiniBrew API which requires an active Pro subscription to access device data and control features.

Features

Craft Device Sensors

• Current Temperature - Real-time temperature monitoring
• Target Temperature - Configured target temperature
• Time in Stage - Duration in current brewing stage
• Current Stage - Active stage information
• Process Phase - Current phase details from runtime telemetry
• Online Status - Device connectivity status
• Last Time Online - Timestamp of the last known online heartbeat (diagnostic)
• Is Updating - Firmware update status
• Needs Cleaning - Cleaning reminder indicator
• User Action Required - Notifications for required user actions
• Next Action - Timestamp for the next required user action
• Session ID - Active brew session identifier (diagnostic)
• Brew Session Started - Session start timestamp from MiniBrew session metadata (diagnostic)
• ESP Core Temperature (real-time MQTT) - Internal controller temperature

Keg Device Sensors

• Current Temperature - Real-time keg temperature
• Target Temperature - Configured serving temperature
• Beer Name - Currently loaded beer name (shows Custom Fermentation in custom fermentation mode, including inferred fermenting/primary sessions with unknown beer metadata)
• Beer Style - Currently loaded beer style (N/A in custom fermentation mode)
• Online Status - Device connectivity status
• Last Time Online - Timestamp of the last known online heartbeat (diagnostic)
• Is Updating - Firmware update status
• Needs Cleaning - Cleaning reminder indicator
• Action Required - Notifications for required user actions
• Next Action - Timestamp for the next required user action
• Session ID - Active brew session identifier (diagnostic)
• Brew Session Started - Session start timestamp from MiniBrew session metadata (diagnostic)
• Temp Control Power (real-time MQTT) - Peltier heating/cooling power (%)
• Fan Duty (real-time MQTT) - Peltier fan output (%)
• ESP Core Temperature (real-time MQTT) - Internal controller temperature

Installation

HACS (Recommended)

1. Open HACS in your Home Assistant instance
2. Click on "Integrations"
3. Click the three dots in the top right corner
4. Select "Custom repositories"
5. Add this repository URL: https://github.com/stuartp44/hambrewclient
6. Select category: "Integration"
7. Click "Add"
8. Find "MiniBrew" in the integration list and click "Download"
9. Restart Home Assistant

Manual Installation

1. Copy the custom_components/minibrew directory to your Home Assistant's custom_components directory
2. If the custom_components directory doesn't exist, create it in the same directory as your configuration.yaml
3. Restart Home Assistant

Configuration

1. Go to Settings → Devices & Services
2. Click + Add Integration
3. Search for "MiniBrew"
4. Enter your MiniBrew account credentials:
   • Username: Your MiniBrew account username
   • Password: Your MiniBrew account password
5. Click Submit

Options

After adding the integration, you can configure additional options:

• Real-time discovery interval: How often to refresh discovery and fallback data from REST while MQTT drives live telemetry (default: 300 seconds)

To access options:

1. Go to Settings → Devices & Services
2. Find the MiniBrew integration
3. Click Configure

Requirements

• Home Assistant 2023.1 or newer
• MiniBrew account with registered devices
• MiniBrew Pro subscription (required for API access)
• pymbrewclient>=1.11.0 (automatically installed)

Dependencies

This integration uses the pymbrewclient library to communicate with the MiniBrew API.

Usage

Once configured, your MiniBrew devices will appear as separate devices in Home Assistant with all associated sensors. You can:

• View all sensors in the Devices page
• Add sensors to your dashboards
• Create automations based on sensor states
• Monitor brewing progress in real-time

Troubleshooting

No devices found

• Verify your MiniBrew account credentials
• Ensure your devices are properly registered in the MiniBrew app
• Check your internet connection

Connection errors

• Verify Home Assistant can reach the internet
• Check if the MiniBrew service is online
• Review Home Assistant logs for detailed error messages

Enable debug logging

Add the following to your configuration.yaml:

logger:
  default: info
  logs:
    custom_components.minibrew: debug
    pymbrewclient: debug

Contributing

Contributions are welcome! This project uses Conventional Commits and automated semantic versioning.

Commit Message Format

All commits MUST follow the Conventional Commits specification:

<type>(<scope>): <subject>

Types:

• feat: New feature (triggers minor version bump)
• fix: Bug fix (triggers patch version bump)
• docs: Documentation changes
• style: Code style changes
• refactor: Code refactoring
• perf: Performance improvements (triggers patch version bump)
• test: Test changes
• build: Build system changes (triggers patch version bump)
• ci: CI/CD changes (triggers patch version bump)
• chore: Other changes (triggers patch version bump)

Examples:

feat(sensor): add battery level sensor
fix(config-flow): correct validation error
docs: update installation instructions

Automated Releases

• Versions are automatically generated from commit messages
• Releases are created automatically on merge to main
• Changelog is auto-generated from commits
• Tags follow semantic versioning (v1.0.0, v1.1.0, etc.)
• Patch releases are triggered by fix, perf, ci, build, and chore commits

Please read CONTRIBUTING.md for detailed guidelines.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

For issues, questions, or feature requests, please open an issue on GitHub.

Disclaimer

This integration is an independent, community-driven project developed and maintained by volunteers. It is not affiliated with, endorsed by, officially maintained by, or in any way officially connected to MiniBrew B.V. or any of its subsidiaries or affiliates.

• This software is provided "as is" without warranty of any kind
• Use at your own risk
• The developers are not responsible for any damage to your MiniBrew devices
• MiniBrew® is a registered trademark of MiniBrew B.V.
• For official MiniBrew support, please visit https://minibrew.io

Credits

• Developed by @stuartp44
• Built for the Home Assistant community
• Development infrastructure and automation assisted by GitHub Copilot