always on duty
WoowTech Sales Handbook

Add a conversational workspace to Home Assistant

Pi Agent runs as a Home Assistant add-on and connects to OpenRouter or another AI provider that you configure. It can help plan automations, examine available data, and draft household workflows. What it can do, what data leaves your home, and what it costs depend on the tools, permissions, provider, and model you choose.

Local host
Runs in your Home Assistant environment
Plain language
Describe goals and review proposed changes
BYOK
Start with OpenRouter or configure another provider

Why add Pi Agent to a smart home?

A conventional smart home follows rules that someone has already created: turn on a light at a set time or adjust cooling when occupancy is detected. When you need a new workflow—or an existing one fails—you still need someone to investigate and update the configuration.

Pi Agent adds a conversational workspace for describing goals, examining available Home Assistant data, and preparing changes. With approved tools and permissions, it can also run scheduled checks and report conditions that match criteria you define.

Concept: Devices provide controls; Pi Agent helps turn household requirements into plans and configurations. It is an assistant, not an independent operator: review its conclusions and require approval for material changes.

What Pi Agent is

Pi Agent is an add-on installed in a supported Home Assistant environment. It provides:

  • A conversational workspace: Describe goals, ask questions, and refine requirements in plain language.
  • Configuration assistance: Draft automations, dashboards, scripts, and local information workflows for review.
  • Repeatable checks: With the necessary access, inspect selected device states and history, then report results under rules you approve.
Tip: Pi Agent is added to an existing Home Assistant setup. Installing it does not by itself replace your devices or automations, but any later changes it proposes should still be reviewed and tested.

Core capabilities

These English examples illustrate possible workflows. Actual execution requires the relevant Home Assistant entities, integrations, tools, and permissions, plus any confirmation rules you establish.

you sayBlue = a request from you or another authorized user
Pi AgentGray = a report or suggestion from Pi Agent

Describe the workflow you want

State the outcome, scope, and exceptions in plain language. Pi Agent can draft an automation, scene, or dashboard, but you should inspect and test it before enabling it.

you say“Draft a welcome-home scene: turn on the entry light, set the living room to 26°C, and play quiet music. Wait for approval before enabling it.”
you say“Propose a household energy dashboard for the tablet near the kitchen. Show me the layout first.”
you say“If the child’s bedroom light is still on at 22:00, send a reminder to the approved recipient.”
you say“Notify me if the cat feeder has recorded no activity for more than 12 hours.”
you say“Draft a schedule for the plant light based on sunrise, and wait for my approval.”

Analyze the data you choose to provide

When configured with appropriate access, it can help analyze temperature, humidity, energy, and device-history data. Treat its findings as proposals to verify, not guaranteed savings or autonomous conclusions.

Pi Agent“Humidity has usually fallen during the afternoon in the period reviewed. Here are the measurements and a later start time to consider.”
Pi Agent“The living-room lights appear to remain on after the room is vacant. Here is the evidence and a sensor-based option to review.”
Pi Agent“Energy history differs between these two set points. Here are the observed values, assumptions, and factors that could affect the comparison.”
Pi Agent“The bedroom warms fastest near this window in the afternoon. Consider testing whether closing the shade 30 minutes earlier improves comfort.”

Build around local and public services

Where a documented data source is available, Pi Agent can help draft a local integration or dashboard. Confirm the source, license, reliability, and security implications before deployment.

An entryway display shows arrival times from your local transit feed and availability from your local bike-share service.
Pi Agent“Your configured weather source reports a 90% chance of rain tomorrow. Consider bringing in anything drying outside.”
Your configured notification service sends an alert before a scheduled local waste collection, when an authoritative feed is available.
A dashboard displays current air-quality data and the household actions you have chosen for defined thresholds.
A personal dashboard combines weather, fuel prices, or exchange rates from sources you approve.

Search household manuals and notes

Organize appliance manuals, warranty details, service contacts, renovation records, and recipes in an approved storage location. Pi Agent can help retrieve that information, subject to the access controls you configure.

you ask“According to the manual, how do I run the washing machine’s drum-cleaning program?”
you ask“When does the water-heater warranty expire, and which company installed it?”
you ask“What service contact did I record for the last plumbing repair?”
you ask“How does the manual say to enable sleep mode on the air-conditioner remote?”
you ask“Where did I save the ingredient ratios for that stew?”
Tip: If a request is vague—“I want softer light at night,” for example—ask Pi Agent to clarify the room, schedule, brightness, and exceptions before proposing a change.

Support maintenance without surrendering control

Smart-home failures can go unnoticed until a routine stops working. With explicitly configured access, Pi Agent can run defined checks and report anomalies. Automatic repairs should be limited to preapproved, tested actions.

Run scheduled checks

Check selected battery levels, unavailable entities, and automation traces on a schedule. Notify an approved recipient when criteria are met; require confirmation before making unplanned repairs.

Pi Agent“The entry sensor has not reported for 3 days and its last battery reading was low. I have drafted a shopping-list entry for your approval.”
Pi Agent“The Good night automation did not turn off one light. Here is the trace, likely cause, and proposed fix; no change has been made.”

Test before changing production

Review dependencies, validate syntax, and test in a nonproduction environment where possible. A test cannot prove that every real-world condition is safe, so keep backups and a rollback plan.

Pi Agent“This proposal also affects the Good night automation. Here are the test results and rollback steps; I am waiting for approval.”

Document why each setting exists

Record the reason for thresholds and schedules alongside the configuration. That context helps you or a future operator understand why a setting exists.

you ask“Why is the bathroom light limited to 30% overnight?” The answer should cite the recorded decision, not invent one.

Use model judgment carefully

Conventional automations evaluate explicit conditions. An AI model can help classify less-structured input, but its output can be wrong. Use confidence thresholds, privacy controls, and a safe fallback.

Classify a situation with safeguards

If you intentionally provide camera or sensor data to a compatible model, it may classify a doorstep event. Do not treat identity or intent as certain; minimize transmitted data and choose a conservative notification fallback.

Observed eventPossible classificationConfigured response
A known household member arrivesLikely known personRecord locally; notification optional
A person leaves an item and departsPossible deliveryRoutine notification: “An item may have been left at the door.”
An unknown person remains for more than 5 minutesUnrecognized prolonged presencePriority notification with a user-opened camera view

Explore energy-use patterns

Provide your utility’s current tariff and the relevant sensor history. Pi Agent can help compare peak and off-peak operation, explain assumptions, and propose schedules for you to verify. It cannot guarantee a bill reduction.

Pi Agent“Based on the tariff and history you supplied, moving part of this load off-peak may reduce cost. Review the calculation and comfort trade-offs before changing the schedule.”
Pi Agent“Your tariff shows a lower-priced period after [time]. Should I draft a schedule for the dishwasher and dryer for you to review?”

Create a weekly household report

Send a scheduled summary through your configured notification service: energy trends, device status, automation failures, and approved changes. Define the recipients and exclude sensitive details they do not need.

“Energy use was 12% higher than the previous comparable week · 2 batteries are below the defined threshold · 1 automation failure needs review.”

Connect suitable local data sources

Fill a gap with a documented integration

Pi Agent can help draft an integration for transit, waste collection, emergency alerts, or local announcements when an authoritative, legally usable data source exists. Availability and reliability vary by location; unsupported services remain unsupported until verified.

you say“Find an authoritative waste-collection feed for my area and explain its coverage before proposing a dashboard.”
you say“Use my official emergency-management service to notify the household of severe-weather warnings for our area.”

Track consumables and warranties

Store operating hours, replacement dates, and warranty dates in a location you approve, then notify selected recipients at defined thresholds.

Pi Agent“The purifier reports 2,000 hours of filter use. Check the manufacturer’s replacement guidance; here is the product record you supplied.”
Pi Agent“The recorded air-conditioner warranty expires in 1 month. Verify the date and terms before requesting service.”
Pi Agent“The recorded water-filter replacement date is next month. Would you like a reminder? I will not place an order.”

Design conservative emergency routines

Emergency routines require careful design, testing, and a safe fallback. Use authoritative alerts and device capabilities; do not let an AI model improvise safety-critical actions.

Earthquake alert: a preapproved routine may turn on selected lights and play an announcement. Lock behavior requires a separate safety review.
Severe-weather alert: notify the household and display door and window sensor states.
Leak detected overnight: sound an alarm and, only if explicitly configured and tested, close a compatible shutoff valve.

Make access understandable and accountable

Use plain language

Household members can describe a problem in ordinary language, but each user should have appropriate permissions. Pi Agent should explain what it found and distinguish a suggestion from an executed action.

a household member says“The evening lights are too bright.” Pi Agent asks which room and proposes a change.
a household member asks“Why is there no hot water?” Pi Agent reports the available status in plain language without claiming certainty.
a household member asks“How do I connect the printer?” Pi Agent answers from the saved manual and cites the relevant page.

Support supervised learning projects

A learner can use Pi Agent to plan a small sensor or lighting project. An adult should supervise electrical work, credentials, purchases, and any change to the live home.

a learner says“Help me plan a supervised project that plays a sound when a test sensor opens.”
Data handling: Pi Agent stores its own persistent files on the Home Assistant host. Content included in an AI request is sent to the provider you configure and is then subject to that provider’s terms, retention settings, and policies. Review those terms and avoid sending unnecessary sensitive data.

A day with Pi Agent

Here is one possible day after the household has configured the required integrations, permissions, and notification rules.

  1. 07:10 · Before leaving

    Entryway display: transit arrival in 3 minutes; rain is forecast this afternoon

    The display combines your approved local transit and weather sources.

  2. 10:30 · No one is home

    “An item may have been left at the door.”

    A privacy-reviewed workflow sends a qualified notification instead of asserting the visitor’s identity or intent.

  3. 14:00 · Afternoon

    Review the dehumidifier schedule

    Recent humidity history and the supplied tariff suggest a later schedule to review; comfort and cost results are not guaranteed.

  4. 17:40 · Evening

    “Local waste collection is expected in 10 minutes.”

    Your configured notification service uses an authoritative local feed, where one is available.

  5. 19:30 · After dinner

    “How do I connect the printer for this worksheet?”

    Pi Agent retrieves the saved manual and explains the documented steps under the user’s access level.

  6. 22:00 · Before going to bed

    “Tomorrow’s chance of rain is 90%. Bring in anything drying outside.”

    The reminder cites your configured weather source and forecast time.

  7. 23:30 · The whole family falls asleep

    Night check: 2 batteries below threshold; monitored doors and windows report closed

    The check reports configured states; it does not replace physical verification or a security system.

  8. Monday 08:00

    The weekly household report arrives

    The report summarizes measured energy use, device status, failures, and approved changes through your configured notification service.

Compare three approaches

Cloud smart speaker Conventional smart home Pi Agent
Adding a workflow Limited to features provided by the vendor Configure it yourself or engage an integrator Describe the goal; review and test the proposed implementation
Finding failures Depends on vendor diagnostics Depends on configured monitoring Can summarize defined checks; repairs require approved guardrails
Decision model Interprets supported commands Evaluates explicit rules Can analyze and suggest, but model output requires verification
Data handling Vendor cloud under its terms Varies by deployment and integration Local Pi Agent files; request content goes to the configured AI provider
User experience Use supported commands Learn dashboards and controls Use plain language, within each user’s permissions

FAQ

Can I use Pi Agent without programming experience?
Yes. You can describe the result you want in ordinary language while Pi Agent handles the underlying workflow. Review its proposed actions and confirm any change that affects your home.
Can I add Pi Agent to an existing smart home?
Yes, if your Home Assistant installation supports the add-on. Installing Pi Agent does not by itself replace existing devices or automations. Back up the system and review any later configuration changes.
What happens when the internet connection is unavailable?
Local Home Assistant automations may continue if their devices and integrations do not require cloud access. Requests to OpenRouter or another remote AI provider will not work until connectivity returns. Whether a failed task resumes automatically depends on the workflow you configured.
Does household data leave my home?
Pi Agent stores its local data on your Home Assistant host. Content included in an AI request is sent to the provider you configure, and handling or retention then depends on that provider's terms and settings. Review the provider policy before sending sensitive household data.
What does each delivery option include and cost?
Option A (self-hosted): the customer operates the Home Assistant and Pi Agent environment; operating owner: [customer-designated owner]. Option B (managed by WoowTech): WoowTech operates only the documented, agreed service scope; service owner: [WoowTech-designated owner]. Approved pricing, currency, regions, contact channel, support scope, and commercial terms are pending and are not stated here.
Can Pi Agent change my Home Assistant settings on its own?
It should not make unrestricted changes. Use least-privilege access, review proposed actions, require confirmation for material changes, and keep tested backups. Actual audit and rollback behavior depends on the tools and Home Assistant configuration you enable.

Choose a delivery path

plan the next step

Option A (self-hosted) / Option B (managed by WoowTech)

Option A (self-hosted) means the customer operates the system; operating owner: [customer-designated owner]. Option B (managed by WoowTech) means WoowTech operates the documented, agreed service scope; service owner: [WoowTech-designated owner]. Approved availability, pricing, currency, regions, support terms, and contact route are pending.

Approved contact channel pending