ENKO
작업 목록으로
Agent Operating System

JARVIS - Personal AI Operating System

1인 개발로 진행한 개인용 AI 운영체제(JARVIS)입니다. Fastify 오케스트레이션 백엔드와 Next.js HUD 인터페이스를 결합해 provider routing, missions/councils/executions, approvals, workspaces, memory, watchers를 하나의 제품 표면으로 묶었습니다.

JARVIS - Personal AI Operating System

기술 스택

TypeScriptNext.jsFastifyPostgreSQLZodPlaywrightReact Three FiberSSE

기간

2026.02 - Present

요약

도전 과제

애매한 사용자 요청을 리서치, 코드 실행, 승인, 자동화 흐름으로 라우팅하면서도, 역할 권한, 스트리밍 상태, provider fallback, workspace execution이 운영자 관점에서 이해 가능해야 했습니다.

해결 방식

Fastify 백엔드에 typed route 모듈, auth/role enforcement, rate limit, SSE stream, provider registry/policy, missions/councils/executions, workspace PTY 엔드포인트를 구성했습니다. 프론트는 visual core와 widget routing을 갖춘 Next.js HUD로 만들고, OpenAPI 동기화 타입과 Playwright dogfood 검증을 붙였습니다.

검증된 결과

A public source repository is available, including backend/frontend code, route contracts, and end-to-end test artifacts.

증빙 자료

기술 문서

구현 방식

개요

  • 1인 개발로 진행한 개인용 AI 운영체제입니다.
  • 오케스트레이션 백엔드와 HUD 스타일 오퍼레이터 인터페이스를 결합해, 작업 라우팅/승인/실행/근거 표시를 하나의 제품으로 구성했습니다.

백엔드 표면

1) 오케스트레이션 API

  • auth, providers, assistant contexts, missions, councils, executions, workspaces, memory, approvals, reports, radar, upgrades, jarvis sessions 등의 Fastify route 모듈을 구성했습니다.
  • role 기반 인증/세션 처리, rate limit, raw-body parsing, 오류 정규화를 포함합니다.
  • mission/council/execution/assistant/dashboard/notification 업데이트를 SSE/event 스트림으로 제공합니다.

2) 실행/정책 제어

  • provider routing policy, credential resolution, registry refresh, token/health worker를 포함합니다.
  • workspace runtime의 PTY spawn/write/read/shutdown 엔드포인트를 구성했습니다.
  • 고위험 액션은 approval gate와 notification channel을 통해 제어합니다.

프론트엔드 표면

1) HUD 인터페이스

  • Inbox, Assistant, Council, Workbench, Tasks, Reports, Watchers, Dossier, Notifications, Skills, Approvals, Memory, Settings, Model Control, Ideation 모듈을 가진 Next.js HUD를 구성했습니다.
  • visual core 페이지와 scene switching, widget 기반 네비게이션을 제공합니다.
  • core, studio, mission, tasks, approvals, automations, settings, reports 등의 딥링크 라우트를 가집니다.

2) 타입/클라이언트 동기화

  • OpenAPI 스펙에서 프론트 타입을 생성해 클라이언트 계층과 맞췄습니다.
  • 위젯 간 API 요청/응답을 타입 기반으로 연결했습니다.

품질 루프

  • core visibility, HUD intake autoplay, council trace, session restore, auth/settings에 대한 Playwright smoke 커버리지를 구성했습니다.
  • 저장소 내부에 도그푸딩 리포트, 스크린샷, 검증 결과를 남겨 회귀와 품질 이력을 추적합니다.
  • 공개 GitHub 저장소를 통해 코드와 검증 산출물을 직접 확인할 수 있습니다.