NestQuest helps households coordinate daily life, chore tracking, custody schedules, and shared tasks directly within Home Assistant. Version 0.1.0 is the integration foundation: a configuration scaffold providing the package and manifest, shared constants, a single-instance config flow, setup/unload lifecycle handling with an options-reload listener, an options flow (horizon days, day rollover time, panel idle timeout), SQLite storage-path resolution, and HACS metadata. Sensors, calendar events, and service calls are forthcoming in later releases and are not yet part of the integration.

Installation

HACS Installation (Recommended)

Ensure HACS (Home Assistant Community Store) is installed.
In Home Assistant, open HACS > Integrations.
Select the three-dots menu in the top right and click Custom repositories.
Enter the repository URL: https://github.com/talon2king/NestQuest
Select category Integration and click Add.
Search for NestQuest and click Download.
Restart Home Assistant.

Note: Development happens in the private Gitea repository (https://code.cubecraftlabs.com/Maniacs_Mansion/NestQuest). The GitHub repository is a public mirror maintained for HACS distribution.

Manual Installation

Download the latest release from the repository.
Copy the custom_components/nestquest directory into your Home Assistant installation's config/custom_components/ folder:
```
cp -R custom_components/nestquest <config_dir>/custom_components/
```
Restart Home Assistant.

Configuration

After installation and restart:

Navigate to Settings > Devices & Services in Home Assistant.
Click Add Integration and search for NestQuest.
Follow the on-screen configuration flow.

Developer Setup and Testing

This project uses uv for fast Python package and dependency management.

Prerequisites

Python 3.11 or newer
uv installed on your machine

Setup Environment

To set up the development environment and install dependencies:

uv sync

Running Tests

Run the test suite with pytest:

uv run pytest

License

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