Bennettxai/FounderOS-DEMO

An open-source, single-operator business command center: run a one-person operated company as AI-assisted departments (comms, funnel, social, finances, agents, and a knowledge graph) from one live dashboard.

Founder OS – AI 강화 개인 운영 체제의 데모

무엇인가요 – Founder OS는 단일 화면에서 소규모 창업자의 전체 비즈니스를 가상으로 운영하는 Next.js 웹 앱입니다. UI는 "부서"(커뮤니케이션, 세일즈 펌프, 소셜 성장, 재무, 지식 그래프 등)로 나뉘며, 각 부서는 코드를 실행하고 지식 기반을 질의하며 구조화된 메모리 계층을 업데이트할 수 있는 작은 LLM 기반 에이전트에 의해 지원됩니다.

왜 중요한가요 – 이는 이메일, Slack, Stripe, Notion, CRM, 소셜 API 등 다양한 연결 모듈과 하이브리드 지식 시스템(마크다운 기반 G-Brain + 통제된 "Optimal Engine" 메모리)을 통합하여 자율 에이전트가 최신 데이터와 신뢰할 수 있는 메모리를 갖도록 하는 방법을 보여줍니다. 이 리포지토리는 완전히 실행 가능한 데모입니다: 시드 데이터가 로컬 SQLite DB에 로드되므로 외부 키 없이 모든 페이지를 탐색할 수 있습니다.

핵심 개념

개념	역할
에이전트	Vercel AI SDK(모델)를 호출하고 연결 모듈 및 지식 계층과 상호작용하는 `run()` 메서드를 가진 작은 TypeScript 클래스입니다.
연결 모듈	20개 이상의 통합 모듈(이메일/IMAP, Slack, Stripe, Notion, 캘린더, CRM, 소셜). 각각은 타입화된 `ConnectorStatus`(`connected`, `not_configured`, `error`)를 반환합니다.
G-Brain	마크다운 파일은 청크로 나누어 임베딩되고 벡터 스토어에 저장됩니다. 키워드 검색과 의미 기반 검색 모두 지원하며, 벡터 서비스가 다운되었을 경우 로컬 grep으로 백업됩니다.
Optimal Engine	"통제된 메모리"로 원시 신호 → 주장 → 검증된 사실 → 지속 가능한 기억으로 진화합니다. 에이전트는 신호/주장을 쓸 수 있지만, 오직 검증된 사실만 OS의 신뢰할 수 있는 상태에 포함됩니다.
저장소 계층	모든 DB 접근은 타입화된 저장소(`agents`, `departments`, `social` 등)를 통해 이루어지므로, 시드된 SQLite를 프로덕션 DB로 교체하려면 `lib/data.ts`의 변경만으로 가능합니다.

주요 UI 경로(데모)

/ – 운영자 콘솔(펄스, 연결 상태, 에이전트 명단, 지식 코어)
/comms – 이메일, Slack, WhatsApp, 음성 녹음 통합 수신함
/funnel – 시각적 고객 여정 흐름(선형 및 원형 뷰)
/social – 팔로워 차트, 청중 공유율, 게시 빈도
/content – 콘텐츠 파이프라인 및 캘린더
/finances – 수입/지출 차트 및 카테고리 분석
/agents – 실시간 run() 상태를 가진 AI 에이전트 목록
/tasks – 에이전트 출력으로 채워진 작업 보드
/brain – 인터랙티브 지식 그래프 뷰
/workflows – 다단계 도구 워크플로우
/integrations – 모든 연결 모듈의 상태 보드
추가로 여러 관리자/로드맵 페이지도 포함됩니다.

기술 스택(리포지토리에 기재됨)

프레임워크: Next.js 14(App Router) 및 서버 컴포넌트
언어: TypeScript
스타일링: Tailwind CSS(5개의 내장 테마, 기본값은 "Monolith")
데이터베이스: 데모용 better-sqlite3; 프로덕션은 어떤 관리형 DB도 가능
검증: DB/API 경계마다 Zod 스키마
LLM 호출: Vercel AI SDK
그래프: 지식 그래프 시각화용 d3-force
테스트: Vitest + 메모리 내 SQLite
배포 대상(데모): Railway(또는 어떤 Node 호스트든) – 프로덕션은 G-Brain과 Optimal Engine에 별도 서비스 추가

시작하기(README에서 빠른 시작)

# 전제 조건: Node 18+
npm install
cp .env.example .env.local   # 선택 사항 – 실제 연결 모듈 사용 시 필요
npm run dev   # http://localhost:4100

처음 실행 시 시드된 SQLite DB가 생성되므로 API 키 없이도 모든 페이지에 현실적인 플레이스홀더 데이터가 표시됩니다. 프로덕션 빌드, 테스트, 타입 체크, 재시드용 명령어도 제공됩니다(npm run build && npm start, npm test, npm run typecheck, npm run seed).

예상 사용 사례

AI 에이전트를 통해 루틴 업무를 자동화하고 싶은 소규모 창업자.
다음을 참고하고자 하는 개발자:
- 신뢰할 수 있는 상태 보고를 하는 플러그 앤 플레이 연결 아키텍처
- 하이브리드 마크다운-벡터 지식 저장소
- 원시 신호와 검증된 사실을 분리하는 통제된 메모리 모델(Optimal Engine)
AI 강화 SaaS 제품 개발을 가르치는 교육자/부트캠프 – 이 리포지토리는 Founder OS 코호트에서 사용되는 "참고 구현"입니다.

라이선스

MIT – LICENSE 참조.

결론 – Founder OS는 AI 기반 개인 비즈니스 운영 체제의 구체적이고 오픈소스 데모입니다. Next.js UI, LLM 기반 에이전트 집합, 풍부한 연결 모듈 라이브러리, 두 계층의 지식/메모리 시스템을 모두 시드된 데이터로 로컬에서 실행 가능하게 구성했습니다. 소규모 기업용 AI 강화 워크플로우를 실험하고 싶은 누구에게나 훌륭한 출발점입니다.