Skip to content

Getting Started

Tom Grounds - Personal edited this page Jun 19, 2026 · 9 revisions

Getting Started

This guide will help you configure Asset Intelligence correctly from the start.


Prerequisites

  • Home Assistant installed and running
  • Areas configured (rooms)
  • Sensors available (temperature, humidity, etc.)

Step 1: Understand the System (Required)

Before configuring, review:

Concepts → Assets, Labels, and Device Model

Key ideas:

  • Assets are devices
  • Rooms are Home Assistant Areas
  • Labels are managed globally in Home Assistant

Step 2: Configure Default Labels

Asset Intelligence allows you to define default labels used when creating assets.

These may include:

  • Asset types (e.g., tv, artwork, wine)
  • Categories (e.g., sensitive, high_value)

Why This Matters

  • Ensures consistency across assets
  • Improves filtering and organization
  • Enables future automation and advisory scenarios

Where to Configure

Settings → Integrations → Asset Intelligence → Options

Set:

  • Default labels for new assets
  • Preferred label suggestions

Step 3: Configure Document Storage (Required for Documents)

Asset Intelligence supports attaching documents to assets
(e.g., manuals, receipts, photos)


Requirement

You must configure a connected storage location, such as:

  • NAS (recommended)
  • Network share (SMB)
  • Mounted storage path

Why External Storage?

  • Documents can be large
  • Keeps Home Assistant lightweight
  • Ensures long-term persistence

What You Configure

In integration options:

  • Storage path
  • Access permissions
  • Folder structure (if applicable)

Important

If storage is not configured:

  • Document upload features will not function
  • No fallback storage is used

Step 4: Verify Areas

Ensure your rooms exist:

Settings → Areas

Asset Intelligence will automatically use them.


Step 5: Add Your First Asset

Go to Asset Intelligence → Add Asset

Provide:

  • Name
  • Area
  • Labels (defaults will appear)

Step 6: Configure a Room Environment

Select a room and assign:

  • Temperature sensor
  • Humidity sensor
  • (Optional) additional sensors

Then define acceptable ranges.


Step 7: Save and Begin Monitoring

Once configured:

  • Assets are created as devices
  • Rooms begin evaluating conditions
  • System starts building awareness

What Happens Behind the Scenes

  • Assets are created as Home Assistant devices
  • Area and label assignments are written directly to HA
  • Asset Intelligence stores only:
    • Environment configuration
    • Advisory data
    • Document references

You're now ready to build an intelligent understanding of your home.

Clone this wiki locally