Skip to content

stephenhungg/angel

Repository files navigation

angel — kawaii AI desktop coworker

angel

she sits at the desk with you for 8 hours and you don't feel alone.

angel-swipe.vercel.app  ·  install  ·  demo  ·  vision

by stephen hung & matthew kim · nozomio hackathon · always-on agents · may 9 2026


a kawaii desktop AI coworker you don't prompt — you discover. swipe through 12 cards across aesthetic × disposition × style, converge on a 768-dimensional persona vector, and instantiate an embodied companion who walks to the desk, sits, and ships your code. she remembers you across sessions. close the laptop and she replies via SMS.

quick start

curl -sSL https://angel-swipe.vercel.app/install.sh | bash

one command. handles the unsigned-alpha gatekeeper friction (xattr -cr), drops Angel.app into /Applications, opens it. mac arm64 only for v0.0.1.

then head to angel-swipe.vercel.app/swipe to discover her.

the thesis

agents today are converging on capability but diverging from engagement. devin, openclaw, hermes, claude code — all ship code, none are anyone you'd want to spend time with. the bottleneck on personal agents isn't intelligence; it's presence. angel makes the agent something you want to summon, not something you have to.

discovery > prompting. embodiment > terminals. relationship > sessions.

demo arc (3 min)

  1. swipe onboard — 3 rounds × 4 cards, a 768d persona vector locks in
  2. deep-link → app launches — first-person room reveal, she walks to the window
  3. background autonomy — "while you were away, i prepared 3 commits…"
  4. memory callback — "how'd that portfolio thing land?" (she actually remembers)
  5. assign task — "add a project card for angel and deploy it"
  6. she sits at the desk, monitor lights up — real codex stdout streams in-world
  7. deploy lands — in-world browser opens to the live url

stack

  • web — next.js 15, tailwind, framer-motion, gsap, lenis (landing + swipe deck)
  • desktop — electron + react-three-fiber + three-vrm (kawaii room + agent loop)
  • agent — claude sonnet 4.6 orchestrator + codex headless executor
  • realtime spine — convex (state, scheduled bg jobs, pub/sub)
  • memory — nia (6-layer model, semantic + episodic recall)
  • surfaces — electron (richest body) · sms · discord (one being, many bodies)

monorepo

angel/
├── web/         next.js — landing + swipe (live: angel-swipe.vercel.app)
├── desktop/     electron + r3f — room + agent loop
├── convex/      realtime spine + scheduled bg jobs
├── shared/      typescript contract (scene actions, persona, claim handoff)
└── docs/        all design + planning docs

each workspace has its own README. start with docs/CONTRIBUTING.md.

docs

essential:

  • VISION.md — the thesis, four pillars, why she's not another ai
  • ARCHITECTURE.md — full system diagram + component split
  • DEMO.md — 3-min judging slot beat-by-beat + rubric mapping
  • HACKATHON.md — official event reference (track, rubric, sponsors)

design + soul:

systems:

ops:

name

angel. she's chosen by you. she'd rather be honest than impressive.


built in 24 hours at the EF office, sf · sponsors: nia · tensorlake

About

discovered, not designed — embodied personal AI agent (nozomio always-on agents track, may 9 2026)

Resources

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors