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 的 Web 應用程式，模擬在單一螢幕上運行一位獨資創業者的全部業務。UI 分為「部門」（通訊、銷售漏斗、社群成長、財務、知識圖譜等），每個部門皆由小型 LLM 驅動的代理 支援，這些代理可執行程式碼、查詢知識庫，並更新結構化記憶層。

為何重要 – 它展示了如何將 20 多個連接器（郵件、Slack、Stripe、Notion、CRM、社群 API 等）與混合知識系統（基於 Markdown 的 G-Brain + 受控的「Optimal Engine」記憶）整合，使自主代理能取得最新資料與可信記憶。此程式庫是 完全可執行的示範：種子資料已載入本地 SQLite 資料庫，因此無需任何外部金鑰即可探索每個頁面。

核心概念

概念	作用
代理	具有 `run()` 方法的小型 TypeScript 類別，呼叫 Vercel AI SDK（LLM），並與連接器及知識層互動。
連接器	20 多個整合模組（郵件/IMAP、Slack、Stripe、Notion、日曆、CRM、社群）。每個回傳型別化的 `ConnectorStatus`（`connected`、`not_configured`、`error`）。
G-Brain	Markdown 檔案被切塊、嵌入並儲存在向量儲存中。支援關鍵字與語意搜尋；當向量服務當機時，會回退至本地 grep。
Optimal Engine	一種「受控記憶」，將原始訊號 → 主張 → 已驗證的事實 → 持久記憶。代理可寫入訊號/主張，但僅經審核的事實才會成為 OS 可信狀態的一部分。
儲存庫層	所有資料庫存取皆透過型別化的儲存庫（`agents`、`departments`、`social` 等）進行，因此將種子 SQLite 替換為生產資料庫，僅需變更 `lib/data.ts` 即可。

主要 UI 路由（示範）

/ – 操作員控制台（脈搏、連接狀態、代理名單、知識核心）
/comms – 統一收件箱，聚合郵件、Slack、WhatsApp、語音輸入
/funnel – 視覺化客戶旅程流程（線性與徑向檢視）
/social – 粉絲圖表、受眾佔比、發文節奏
/content – 內容管道與日曆
/finances – 收入/支出圖表及分類分解
/agents – AI 代理列表，顯示即時 run() 狀態
/tasks – 由代理輸出填滿的任務看板
/brain – 互動式知識圖譜檢視
/workflows – 多步驟工具工作流程
/integrations – 所有連接器的狀態儀表板
以及多個管理員/路線圖頁面。

技術堆疊（如程式庫中列出）

框架：Next.js 14（App Router）與伺服器元件
語言：TypeScript
樣式：Tailwind CSS（5 個內建主題，預設為「Monolith」）
資料庫：示範使用 better-sqlite3；生產環境預期支援任何托管資料庫
驗證：在每個資料庫/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 資料庫，因此無需任何 API 金鑰即可在所有頁面看到真實感的佔位資料。也提供生產建構、測試、類型檢查與重新種子的指令（npm run build && npm start、npm test、npm run typecheck、npm run seed）。

預期使用情境

希望透過 AI 代理自動化日常業務任務的 獨資創業者。
尋找以下參考實作的 開發者：
- 可即插即用的連接器架構，並具備誠實的狀態報告
- 混合 Markdown-向量知識儲存
- 將原始訊號與已驗證事實分離的受控記憶模型（Optimal Engine）
教授建構 AI 增強 SaaS 產品的 教育者 / 培訓營 – 此程式庫是 Founder OS 學員專案中使用的「參考實作」。

授權

MIT – 請參閱 LICENSE。

總結 – Founder OS 是一個具體、開源的 AI 驅動型個人業務作業系統示範。它整合了 Next.js UI、一組 LLM 支援的代理、豐富的連接器庫，以及兩層知識/記憶系統，所有內容皆可在種子資料下本地執行。對於希望探索獨資企業 AI 增強工作流程的任何人而言，這是一個堅實的起點。