Skip to content

Latest commit

Β 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

FounderOS β€” Your AI Executive Team

An always-on founder intelligence system and AI executive team built for early-stage startup founders.

MIT License Status: Under Development Open Source 6 C-Suite AI Agents AES-256-GCM Vault

React 18 TypeScript Vite FastAPI Python 3.10+ SQLModel

🚧 Status: Under Active Development
FounderOS is actively being built and refined. Core agent harnesses, C-suite executive tools, and automated workflows are rapidly evolving. Feedback, issues, and contributions are welcomed!


⚑ What is FounderOS?

FounderOS is an open-source AI Executive Operating System that acts as an autonomous co-founder for early-stage startup leaders. Rather than isolated chatbots, FounderOS builds a living model of your company, grounds all reasoning in your real-time financial constraints and founder DNA, runs multi-agent C-suite board debates, and prepares verified, approval-gated execution drafts.

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                              1. SIGNAL INGESTION                                β”‚
β”‚          Email  β€’  Linear  β€’  Stripe  β€’  Slack  β€’  Financials & Metrics         β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                                         β”‚
                                         β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                         2. COMPANY INTELLIGENCE LAYER                           β”‚
β”‚       Company Context  β€’  Financial Constraints  β€’  Institutional Memory        β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                                         β”‚
                                         β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                          3. 6-AGENT C-SUITE BOARD                               β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”‚
β”‚  β”‚    CRO    β”‚ β”‚Skeptic/CPOβ”‚ β”‚   VP CS   β”‚ β”‚    CFO    β”‚ β”‚    CTO    β”‚ β”‚    COO    β”‚  β”‚
β”‚  β”‚ Reforge & β”‚ β”‚Pre-Mortem β”‚ β”‚Superhuman β”‚ β”‚Default    β”‚ β”‚Boring Techβ”‚ β”‚Barrels &  β”‚  β”‚
β”‚  β”‚ MEDDPICC  β”‚ β”‚& Friction β”‚ β”‚PMF Engine β”‚ β”‚Alive/Burn β”‚ β”‚& Two-Way  β”‚ β”‚Ammunition β”‚  β”‚
β”‚  β””β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜  β”‚
β”‚        β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β”‚
β”‚                                    β–Ό                                              β”‚
β”‚                            CEO Orchestrator                                       β”‚
β”‚                 Prioritizes  β€’  Challenges  β€’  Recommends                         β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                                         β”‚
                                         β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                           4. FOUNDER ACTION COCKPIT                             β”‚
β”‚   Daily Morning Brief  ──►  Approval-Gated Drafts  ──►  Decision Ledger (Learn) β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

🌟 Key Capabilities

  • Deep Founder & Company Harness: Grounds every AI agent decision in your exact business model, cash runway, burn rate, GTM motion, competitive moat, tech stack, and founder superpower/gap profile.
  • πŸ‘‘ C-Suite Daily Executive Operating Suite:
    • CEO Investor Update Synthesizer: Ingests real-time milestones, MRR growth, and constraints to generate gold-standard YC/Sequoia monthly investor updates ready to stage to the Action Queue.
    • Task Prioritizer: Automatically segments founder task queues into 10x Leverage (deep work protection), 1x Neutral, and <0.1x Overhead (auto-delegated to AI workers).
    • CFO Default Alive Runway Lab: Real-time Paul Graham capital efficiency simulator modeling headcount changes, salaries, revenue growth deltas, and tooling spend.
    • CTO & ADR Lab: Simulates catastrophic failure modes 6 months into the future before committing code; enforces Dan McKinley Boring Tech innovation token discipline.
    • CRO MEDDPICC Deal Health Radar: Audits enterprise pipeline deals across 8 dimensions (Metrics, Economic Buyer, Decision Criteria/Process, Paper Process, Pain, Champion, Competition) with objection talk tracks.
    • VP CS Superhuman PMF Engine: Analyzes customer sentiment against Rahul Vohra's 40% "Very Disappointed" benchmark and segments High-Expectation Customers (HXC).
  • 6-Agent C-Suite Board Debate Matrix: Concurrently queries CRO (Reforge Growth Loops & MEDDPICC), Skeptic / CPO (Pre-Mortem & Friction Logs), VP CS (Superhuman PMF & NRR), CFO (Paul Graham Default Alive & Burn Multiple), CTO (Boring Tech Rule & Two-Way Doors), and COO (Andy Grove High-Output Management), synthesized by a CEO Orchestrator.
  • CEO Executive Morning Briefing: Daily synthesized briefing answering "What changed overnight and what is the single highest-leverage focus today?" based on incoming signals.
  • Autonomous Approval-Gated Task Execution: Automatically processes delegated tasks into verified draft action receipts awaiting founder sign-off.
  • Tri-Modal Security Postures & Policy Filter: Configurable security postures (Strict, Auto, Dangerous) with automated AST/regex command safety rules to protect startup assets.
  • Scoped Notebook Memory & Decision Ledger: Line-oriented Markdown institutional memory with SHA-256 revision hashing and 300-fact sliding window cap.
  • 100% Offline Peak Local Reasoning: Operates out-of-the-box with zero API keys required using structured local heuristics.
  • AES-256-GCM Vault: Authenticated encryption at rest for third-party OAuth refresh tokens and provider API keys.

πŸ—οΈ Architecture & Tech Stack

Layer Technologies
Frontend Cockpit React 18, TypeScript, Vite, Vanilla CSS Design System with Glassmorphism UI
Backend Core Python 3.10+, FastAPI, Pydantic v2, WebSockets for live push events
Data & Storage SQLModel / SQLAlchemy (Async), SQLite (aiosqlite) / PostgreSQL compatible
Security & Vault AES-256-GCM Authenticated Encryption (cryptography), Action Policy AST/Regex Engine
AI Reasoning Layer Universal LLM Connector Registry (Hermes / OpenClaw architecture) supporting the full 2026 intelligence leaderboard: Anthropic (Claude Opus 5 max, Claude Fable 5 with fallback, Sonnet 5), OpenAI (GPT-5.6 Sol max, Luna max, o3-mini), xAI (Grok 4.6 high/xhigh), Moonshot AI (Kimi K3 max 2.8T), Google Gemini (Gemini 3.7 Flash high, 3.1 Pro), DeepSeek (DeepSeek V4 Pro max, R1), Zhipu AI (GLM-5.2 max), NVIDIA NIM (Nemotron 3 Ultra), Meta / Muse (Muse Spark 1.2 xhigh), Groq LPUs, OpenRouter (200+ models), and Local Ollama with live /v1/models auto-discovery

πŸš€ Quickstart

Prerequisites

  • Node.js: v18 or higher
  • Python: v3.10 or higher

1. Frontend Setup

# Install dependencies
npm install

# Start Vite development server
npm run dev

The frontend will launch at http://localhost:5173.

2. Backend Setup

# Navigate to the backend directory
cd server

# Create and activate a virtual environment
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Start the FastAPI server with live reload
uvicorn app.main:app --reload --port 8000

The backend API and interactive documentation will be available at http://localhost:8000/docs.


πŸ“ Repository Structure

FounderOS/
β”œβ”€β”€ public/                # Static assets & web manifest
β”œβ”€β”€ media/                 # Branding, illustrations & banner assets
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ App.tsx            # Main application shell, router & modals
β”‚   β”œβ”€β”€ api.ts             # Typed API client with error handling
β”‚   β”œβ”€β”€ domain.ts          # TypeScript interfaces & domain models
β”‚   └── styles.css         # Glassmorphism design system & utility styles
β”œβ”€β”€ server/
β”‚   β”œβ”€β”€ app/
β”‚   β”‚   β”œβ”€β”€ main.py        # FastAPI entrypoint & background workers lifecycle
β”‚   β”‚   β”œβ”€β”€ models.py      # SQLModel database schemas
β”‚   β”‚   β”œβ”€β”€ db.py          # Async session maker & database engine
β”‚   β”‚   β”œβ”€β”€ vault.py       # AES-256-GCM token encryption & decryption
β”‚   β”‚   β”œβ”€β”€ policy/        # Security postures & command safety rules
β”‚   β”‚   β”œβ”€β”€ routers/       # API endpoints (workspace, briefing, debate, tasks, etc.)
β”‚   β”‚   β”œβ”€β”€ services/      # Unified LLMEngine, briefing synthesizer & voice profiler
β”‚   β”‚   └── workers/       # Background execution & signal ingestion loops
β”‚   └── requirements.txt   # Python dependencies
β”œβ”€β”€ architecture.md        # Authoritative system design & architecture specification
β”œβ”€β”€ harness.md             # AI Agent Harness specification & mental models reference
β”œβ”€β”€ CONTRIBUTING.md        # Open-source contribution guidelines
β”œβ”€β”€ SECURITY.md            # Security disclosure policy
└── LICENSE                # MIT License

πŸ“œ License & Contributing