trio-vision

# Trio Vision — Turn Any Camera Into a Smart Camera

Stop getting dumb motion alerts for every shadow. Describe what actually matters in plain English — get notified only when it happens, right in your chat. Powered by [Trio by MachineFi](https://machinefi.com).

## When to Use

- User asks what's happening on a camera, stream, or video feed ("is anyone at my front door?")
- User wants smart alerts for specific events ("tell me when a package is delivered", "alert me if my dog gets on the couch")
- User wants to monitor something they can't watch themselves (construction site, parking spot, warehouse)
- User wants periodic summaries of a live feed ("summarize this stream every 10 minutes")
- User provides any live stream URL: YouTube Live, Twitch, RTSP/RTSPS cameras, HLS streams

## Prerequisites

- A Trio API key. Get one free (100 credits) at https://console.machinefi.com
- Set the key: `export TRIO_API_KEY=your_key_here`
- Base URL: `https://trio.machinefi.com/api`

## Available Actions

### 1. Check Once (Quick Snapshot)

Ask a yes/no question about what's currently visible on a stream. Costs 1 credit ($0.01).

```bash
curl -s -X POST "https://trio.machinefi.com/api/check-once" \
  -H "Authorization: Bearer $TRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "stream_url": "STREAM_URL_HERE",
    "condition": "NATURAL_LANGUAGE_CONDITION_HERE"
  }' | python3 -m json.tool
```

**Optional parameters:**
- `"include_frame": true` — returns the analyzed frame as base64 image
- `"input_mode": "clip"` — analyze a short video clip instead of a single frame (better for motion detection)
- `"clip_duration_seconds": 5` — clip length (1-10 seconds, only with clip/hybrid mode)

**Response fields:**
- `triggered` (boolean) — whether the condition matched
- `explanation` (string) — VLM's reasoning about what it sees
- `latency_ms` — processing time in milliseconds

**Input mode guidance:**
- Use `"frames"` (default) for static objects: "Is there a car in the driv...

# trio-vision — Turn Any Camera Into a Smart Camera

Stop getting dumb motion alerts for every shadow. **Describe what actually matters in plain English** — get notified only when it happens, right in your chat.

Powered by [Trio by MachineFi](https://machinefi.com).

## The Problem

You have cameras everywhere — doorbell, baby monitor, security, warehouse — but nobody watches them. Motion detection alerts on every shadow and breeze. Enterprise video AI costs $50K+/year.

## The Solution

Ask your cameras questions in plain English. Get answers in WhatsApp, Telegram, or Slack — wherever you already use OpenClaw.

| What You Say | What Happens | Cost |
|-------------|-------------|------|
| "Is anyone at my front door?" | Instant answer with explanation | $0.01 |
| "Alert me when a package is delivered" | Continuous watch, notifies on match | $0.02/min |
| "Summarize this stream every 10 minutes" | Periodic narrative digests | $0.02/min |
| "How many people are in this photo?" | Single image analysis | $0.01 |

Works with YouTube Live, Twitch, RTSP/RTSPS cameras, and HLS streams.

## Install

```bash
# From ClawHub
openclaw skills install machinefi/trio-vision

# Or clone directly
git clone https://github.com/machinefi/trio-openclaw-skill.git ~/.openclaw/skills/trio-vision
```

## Setup

1. Get a free API key (100 credits / $1.00) at https://console.machinefi.com
2. Set your key:
   ```bash
   export TRIO_API_KEY="your_key_here"
   ```
3. That's it. No ML setup, no model downloads, no GPU required.

## Real-World Use Cases

**Home & Security**
> "Watch my front door camera and tell me when a person (not a cat) approaches"
> "Is the garage door open or closed right now?"
> "Is the baby sleeping or awake?"

**Business & Warehouse**
> "Monitor the loading dock — alert me when a delivery truck arrives"
> "Are there more than 10 packages on the sorting table?"
> "Summarize foot traffic at the store entrance every 30 minutes"

**Streaming & Content**
> "What's happening on...