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 DB にロードされるため、外部キーなしですべてのページを探索できます。

コアコンセプト

コンセプト	役割
エージェント	Vercel AI SDK（LLM）を呼び出し、接続モジュールと知識レイヤーとやり取りする `run()` メソッドを持つ小さな TypeScript クラス。
接続モジュール	20以上の統合モジュール（メール/IMAP、Slack、Stripe、Notion、カレンダー、CRM、ソーシャル）。各モジュールは型付きの `ConnectorStatus`（`connected`、`not_configured`、`error`）を返す。
G-Brain	Markdown ファイルはチャンク化され、埋め込まれ、ベクトルストアに保存されます。キーワード検索と意味検索の両方をサポートし、ベクトルサービスがダウンした場合はローカルの grep にフォールバックします。
Optimal Engine	「治められた記憶」で、原始的な信号 → 主張 → 検証された事実 → 持続的な記憶へと進化します。エージェントは信号や主張を書き込むことができますが、信頼できる状態に組み込まれるのは検証された事実のみです。
リポジトリレイヤー	すべての 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エージェントによるルーティン業務の自動化を希望する ソロ起業家。
次の実装を検討する 開発者：
- 信頼できるステータス報告を持つプラグアンドプレイ接続アーキテクチャ
- ハイブリッドな Markdown-ベクトル知識ストア
- 原始信号と検証済み事実を分離する「治められた記憶モデル」（Optimal Engine）
AI強化SaaS製品の開発を教える 教育者／ブートキャンプ – このリポジトリは「Founder OS コホート」で使用される「参考実装」として機能します。

ライセンス

MIT – LICENSE を参照。

結論 – Founder OS は、AI駆動型個人ビジネスオペレーティングシステムの具体的でオープンソースのデモです。Next.js UI、LLMバックエンドエージェント群、豊富な接続モジュールライブラリ、2層構造の知識/記憶システムをすべて、シード済みデータでローカルで実行可能にまとめています。ソロ企業向けのAI強化ワークフローを実験したい人にとって、非常に良い出発点です。