1st place · Meta Wearable AI Challenge, ECCV 2026 Video in. Action out.

The video engine
for AI agents to
watch and act.

Agents watch footage of any length, gather evidence over time, and turn it into clips, data, reports, and real-world actions.

Watch it work Try a video
Just ask Ambient:
> score this robot run and explain the failures
studio.ambient — Any video, Any outcome
Any video, any outcome

Video in, structured data out

Hand Ambient a schema and it returns clean, typed JSON — tasks, subtasks and steps, detections, events, citations — frame-accurate and ready for your training pipeline.

Any video, any outcome

A long video in, a reel out

Ambient finds the moments, cuts and reframes to 9:16, and adds captions and a music bed — a share-ready social reel from a long video.

input · 16-min walkthrough
→
output · 30-sec social reel
Any video, any outcome

Turn a walkthrough into docs

Ambient writes polished deliverables from video — product documentation, reports, recipes, blog posts — pulling in the right screenshots and citing the source.

input · product walkthrough
→
Generated product documentation
output · HTML documentation
How it works

It watches the way we do

Ambient's agents follow a video through time—pausing, searching, and looking closer when something matters.

Input01

Any video in

  • File upload
  • YouTube URL
  • S3 / R2 object
  • Any local path
Agent loop02

Watches with intent

Moves through time, follows what matters, and looks closer before acting.

Follows the story Notices what changes Pauses Looks closer Checks the evidence
Output03

Any action out

  • Processed or annotated video
  • Structured outputs
  • Documents and artifacts
  • Training datasets
  • Reward signals
Use cases

One engine, any video, any outcome

Point Ambient at the footage you already have and ask for the output you actually need.

site-footage.mp4 → inspection-report.json

Safety and compliance review

Find unsafe actions, missing PPE, and procedure violations with timestamped evidence.

dashcam.mp4 → incident-report.pdf

Incident reconstruction

Reconstruct what happened, in what order, and where—with cited moments and annotated frames.

screen-recordings/ → trajectories.jsonl

UI agent training data

Turn demonstrations into actions, bounding boxes, click-points, and step-by-step trajectories.

robot-runs/ → rewards.jsonl

Robotics evaluation and reward signals

Identify successes and failures, score trajectories, and extract the moments that explain each result.

production-runs/ → qa-report.csv

Visual QA and defect detection

Review product or process footage against a checklist and surface anomalies with evidence.

raw-video/ → annotated-dataset/

Video dataset curation

Search, segment, label, and annotate large video collections for training and evaluation.

Any video in

Bring the footage. Ask what matters.

Whether it’s a ten-second clip or hours of footage, Ambient moves through it selectively—finding and examining the moments that matter.

01 · Built for long video

It knows when to look closer

Ambient searches across the full timeline, pauses around relevant moments, and examines them in detail—without flattening the video into a transcript.

source · 00:00 → 42:17
search_clip · 12:00–17:00 focus_clip · 14:20–14:55
UPLOAD
YOUTUBE
S3 / R2 RANGE-READ
LOCAL PATH
02 · Efficient by design

Reads only what it needs

Ambient doesn’t pull in hours of footage to examine a few seconds. It fetches only the moments it needs—often just 1–2% of the source.

Any action out

Answers you can build on

Not a paragraph you have to re-parse — a structured, verifiable output your code can consume directly.

Citation-backed answers

Every claim links to a timestamp or range in the source. Clip-local times are rewritten to the global timeline, so citations land on the right moment.

JSON-Schema output

Pass a schema; get typed data back. The final answer is steered to your shape, with validation and retry when it must be exact.

Boxes & click-points

Bounding boxes and click coordinates on a normalized 0–1000 grid — drawn and visually verified before they reach your answer.

Downloadable artifacts

The agent can run bash + ffmpeg to render clips, extract data, or build a report — then hand back a download link.

Streaming events

Reasoning, tool calls and results, per-request tokens and cost — streamed live over SSE. Full observability, not a black box.

An MCP tool

analyze_video plugs into Claude Code or any MCP client — streaming progress, a final answer, and a session id for follow-ups.

Built to scale

One engine, however you run it

Run Ambient locally or distribute it across a cluster. Use Studio interactively, run headless batch workloads, or integrate through the SDK and API. Isolate media execution in per-session sandboxes for safer, independently scalable workloads.

Laptop
Run locally
engine + Studio
Cluster
Distribute workers
shared durable state
Studio
Work interactively
explore, ask, inspect
Headless
SDK + API
batch or embed

Scale without session pinning

Postgres and Redis keep state outside the process, so any worker can continue any session.

Sandboxed media execution

Isolate each session’s media workload in its own sandbox while orchestration and model calls remain under your control.

Integrate it anywhere

Use Studio, run batch jobs through the SDK, or embed the API directly into your application.

Try it

From one command to your first answer

The installer starts Ambient, Studio, Postgres, and Redis in Docker. You’ll need Docker Compose and an API key for an OpenAI-compatible model.

install
# install Ambient + Studio — safe to re-run
curl -fsSL https://ambient-intelligence-hq.github.io/install.sh | bash

# when ready, the installer prints and opens Studio
# add a video or paste a YouTube link, then ask:
> Investigate the incident and share a report with evidence ?

Or let your coding agent set it up. Paste this into Claude Code, Codex, or Cursor:

paste into your coding agent
Set up Ambient, an open-source video engine for AI agents, on this machine.
Read the setup guide and follow it:
curl -fsSL https://ambient-intelligence-hq.github.io/agents/setup.md
Show me your plan before installing anything

Deploying for a team or cluster? Detailed self-hosting guidance is coming soon.

Video to action

Turn any video into
something you can act on.

Set up with your coding agent

Paste this into Claude Code, Codex, Cursor, or any agent that can run commands:

paste into your coding agent
Set up Ambient, an open-source video engine for AI agents, on this machine.
Read the setup guide and follow it:
curl -fsSL https://ambient-intelligence-hq.github.io/agents/setup.md
Show me your plan before installing anything

The agent follows the setup guide for agents. It checks Docker, asks how you want to provide your API key and settings, shows you its plan, and waits for your go-ahead before installing.