podman/README.md

# 🛰️ PodMan — Jarvis for engineering teams

Ambient AI teammate for the **2026 AI Engineer World's Fair Hackathon** (track: **Continual Learning**).

Engineers join a **pod** and share their screen + mic. PodMan watches every screen in
**realtime**, understands what each person is working on, fuses that with the team's
GitHub state, and **proactively prevents collisions before code is even pushed** —
speaking up like Jarvis: _"Karti and Yahya are both editing `auth.ts`, Yahya has unpushed
changes — here's the diff, want a sync PR?"_

> **The moat:** unpushed local code is invisible to the GitHub API. The realtime
> screen-vision layer is the _only_ way to catch a collision before the push. That is the
> whole product — and the reason this is an ambient agent, not a dashboard.

## Monorepo layout

| Folder      | What                                                                                               |
| ----------- | -------------------------------------------------------------------------------------------------- |
| `frontend/` | React + Vite PWA — join pod, screen/mic/cam capture, PodMan voice + intervention cards             |
| `backend/`  | PodMan agent: LiveKit room subscriber, Gemini vision, GitHub fusion, collision detector, voice out |
| `infra/`    | DigitalOcean deploy (App Platform / Droplet), IaC, Dockerfiles                                     |
| `database/` | MongoDB Atlas schema + Voyage vector memory for continual learning                                 |
| `shared/`   | Shared TypeScript types (pod, engineer context, intervention)                                      |
| `docs/`     | `PLAN.md` (the north star), demo script                                                            |

## Prizes we're stacking

- 🏆 **Best Gemini 3.5** — $5,000 cash (realtime vision + Live API voice)
- 🏆 **Best LiveKit** — Keychron keyboards (realtime transport is the core)
- 🏆 **Best DigitalOcean** — credits (deploy target)

👉 **Read [`docs/PLAN.md`](docs/PLAN.md) first.**