# OpenClaw Venture Capitalist 🚀

**AI-Powered Investment Analysis for Smart Decisions**

Quickly review business plans and pitch decks, automatically generate comprehensive investment analysis reports and presentation decks.

---

## ✨ Features

- 📊 **Automated Analysis** - Parse pitch decks and business plans instantly
- 🔍 **10-Point Framework** - Comprehensive evaluation across market, team, product, financials, and more
- 📝 **Investment Reports** - Generate detailed analysis reports in multiple formats (Markdown, PDF, DOCX)
- 🎯 **IC Presentations** - Create polished investment committee decks automatically
- ⚖️ **Deal Comparison** - Compare multiple opportunities side-by-side
- 📈 **Data Extraction** - Extract specific metrics (market size, traction, financials)
- 🎨 **Customizable** - Adapt analysis framework to your investment criteria
- 💾 **Deal Tracking** - Maintain history of analyzed deals and decisions

---

## 🚀 Quick Start

### Installation

```bash
# Clone the repository
git clone https://github.com/ZhenRobotics/openclaw-venture-capitalist.git
cd openclaw-venture-capitalist

# Install dependencies
npm install

# Build the project
npm run build
```

### Basic Usage

```bash
# Analyze a pitch deck
npm start analyze pitch-deck.pdf

# Generate full investment report
npm start report pitch-deck.pdf --format pdf

# Create investment committee presentation
npm start deck pitch-deck.pdf

# Compare multiple deals
npm start compare deal-a.pdf deal-b.pdf deal-c.pdf

# Extract specific information
npm start extract pitch-deck.pdf market-size
```

---

## 📖 Command Reference

### `analyze <file>`
Perform comprehensive analysis of a business plan or pitch deck.

**Supported formats**: PDF, PPTX, DOCX, TXT

**Output**: Structured analysis report with:
- Executive Summary
- Market Analysis (TAM/SAM, growth, trends)
- Team Assessment
- Product Evaluation
- Business Model Review
- Traction & Metrics
- Financial Analysis
- Competitive Landscape
- Risk Assessment
- Investment Recommendation

**Example**:
```bash
npm start analyze acme-startup-deck.pdf
```

### `report <file> [options]`
Generate detailed investment analysis report.

**Options**:
- `--format <type>` - Output format: `markdown`, `pdf`, `docx` (default: markdown)
- `--template <name>` - Use custom template
- `--sections <list>` - Comma-separated sections to include
- `--output <path>` - Output file path

**Example**:
```bash
npm start report acme-startup-deck.pdf --format pdf --output ./reports/acme-analysis.pdf
```

### `compare <file1> <file2> [...]`
Compare multiple investment opportunities.

**Output**: Side-by-side comparison matrix with scoring

**Example**:
```bash
npm start compare startup-a.pdf startup-b.pdf startup-c.pdf
```

### `extract <file> <field>`
Extract specific information from pitch deck.

**Available fields**:
- `market-size` - TAM/SAM/SOM
- `team` - Founder and team info
- `financials` - Revenue, projections, burn rate
- `traction` - Users, revenue, growth metrics
- `competition` - Competitors and differentiation
- `ask` - Funding amount and terms
- `valuation` - Pre/post money valuation

**Example**:
```bash
npm start extract acme-startup-deck.pdf traction
```

---

## 🎯 Analysis Framework

Our 10-point investment analysis framework:

### 1. Market Analysis
- Total Addressable Market (TAM)
- Serviceable Addressable Market (SAM)
- Market growth rate and trends
- Market dynamics and timing

### 2. Product/Solution
- Problem identification
- Solution uniqueness
- Product-market fit evidence
- Technology and IP assessment

### 3. Team Assessment
- Founder backgrounds
- Relevant experience and expertise
- Team composition and gaps
- Advisory board strength

### 4. Business Model
- Revenue streams
- Unit economics (CAC, LTV)
- Scalability potential
- Go-to-market strategy

### 5. Traction & Metrics
- Current users/customers
- Revenue and growth rates
- Key performance indicators
- Milestones achieved

### 6. Financial Analysis
- Revenue projections
- Burn rate and runway
- Unit economics
- Use of funds

### 7. Competitive Landscape
- Direct and indirect competitors
- Competitive advantages
- Barriers to entry
- Market positioning

### 8. Risk Assessment
- Market risks
- Execution risks
- Technology risks
- Team risks
- Financial risks

### 9. Investment Terms
- Valuation (pre/post money)
- Funding ask
- Equity stake
- Investment structure

### 10. Investment Recommendation
- Investment thesis
- Key strengths
- Critical concerns
- Go/No-go with reasoning

---

## ⚙️ Configuration

Create `.vcconfig.json` in your project root:

```json
{
  "analysis_framework": "custom",
  "required_sections": [
    "market",
    "team",
    "product",
    "financials",
    "traction"
  ],
  "scoring": {
    "enabled": true,
    "weights": {
      "market": 0.25,
      "team": 0.30,
      "product": 0.20,
      "traction": 0.15,
      "financials": 0.10
    },
    "thresholds": {
      "strong_buy": 8.0,
      "buy": 6.5,
      "hold": 5.0,
      "pass": 0
    }
  },
  "report_template": "default",
  "output_directory": "./reports",
  "save_history": true
}
```

---

## 📂 Project Structure

```
openclaw-venture-capitalist/
├── src/
│   ├── core/
│   │   ├── analyzer.ts          # Main analysis engine
│   │   ├── extractor.ts         # Document parsing & data extraction
│   │   ├── scorer.ts            # Investment scoring logic
│   │   └── types.ts             # TypeScript type definitions
│   ├── generators/
│   │   ├── report.ts            # Report generation
│   │   ├── deck.ts              # Presentation deck creation
│   │   └── comparison.ts        # Multi-deal comparison
│   ├── parsers/
│   │   ├── pdf.ts               # PDF parsing
│   │   ├── pptx.ts              # PowerPoint parsing
│   │   └── docx.ts              # Word document parsing
│   └── cli/
│       └── index.ts             # CLI entry point
├── config/
│   └── .vcconfig.example.json   # Example user config
├── templates/
│   ├── reports/                 # Report templates
│   └── decks/                   # Presentation templates
├── examples/
│   ├── sample-pitch-deck.pdf    # Sample pitch deck
│   └── analysis-output.md       # Sample analysis
├── skill.md                     # SKILL definition
├── README.md                    # This file
├── package.json
└── tsconfig.json
```

---

## 🎓 Usage Examples

### Example 1: Quick Deal Screening

```bash
# Analyze pitch deck for quick screening
npm start analyze acme-fintech.pdf
```

### Example 2: Full Investment Memo

```bash
# Generate comprehensive investment report
npm start report acme-fintech.pdf \
  --format pdf \
  --output ./reports/acme-memo-2024-03.pdf
```

### Example 3: Investment Committee Presentation

```bash
# Create IC presentation deck
npm start deck acme-fintech.pdf \
  --template ic-standard \
  --output ./decks/acme-ic-presentation.pptx
```

### Example 4: Pipeline Comparison

```bash
# Compare 5 deals in current pipeline
npm start compare \
  deal-a.pdf \
  deal-b.pdf \
  deal-c.pdf \
  deal-d.pdf \
  deal-e.pdf \
  --output ./reports/q1-pipeline-comparison.md
```

### Example 5: Extract Market Data

```bash
# Quick market size extraction for partner discussion
npm start extract acme-fintech.pdf market-size
```

---

## 🎯 Use Cases

### For Venture Capital Firms
- **Deal Flow Management**: Screen 100+ deals per month efficiently
- **Investment Memos**: Generate standardized investment memos
- **Partner Meetings**: Prepare IC presentations automatically
- **Portfolio Analysis**: Track and compare portfolio companies

### For Angel Investors
- **Due Diligence**: Quick assessment of startup opportunities
- **Investment Notes**: Document investment rationale
- **Deal Comparison**: Compare multiple angel investments
- **Learning**: Analyze patterns in successful investments

### For Corporate VCs
- **Strategic Fit**: Assess alignment with corporate goals
- **Market Intelligence**: Track emerging technologies and trends
- **Investment Reports**: Generate reports for stakeholders
- **Pipeline Management**: Maintain deal pipeline and status

---

## 🔐 Privacy & Security

- All document processing happens locally
- No data sent to external servers (unless AI APIs configured)
- Sensitive information can be redacted before analysis
- Investment reports stored locally with encryption option

---

## 🛠️ Development

### Prerequisites

- Node.js 18+
- TypeScript 5+
- npm or pnpm

### Setup Development Environment

```bash
# Install dependencies
npm install

# Run in development mode
npm run dev

# Run tests
npm test

# Build for production
npm run build
```

---

## 🤝 Contributing

Contributions welcome! Please read our [Contributing Guide](CONTRIBUTING.md).

---

## 📝 Changelog

### v1.0.0 (2024-03-26)
- ✨ Initial release
- ✅ PDF, PPTX, DOCX parsing
- ✅ 10-point analysis framework
- ✅ Report generation (Markdown, PDF, DOCX)
- ✅ Investment committee deck creation
- ✅ Multi-deal comparison
- ✅ Data extraction capabilities
- ✅ Configurable scoring system

---

## 📄 License

MIT License - see [LICENSE](LICENSE) file

---

## 🔗 Links

- **GitHub**: https://github.com/ZhenRobotics/openclaw-venture-capitalist
- **Documentation**: https://docs.openclaw.ai/venture-capitalist
- **Issues**: https://github.com/ZhenRobotics/openclaw-venture-capitalist/issues
- **npm**: https://www.npmjs.com/package/openclaw-venture-capitalist

---

**Make smarter investment decisions with AI-powered analysis** 🚀📊

*"In venture capital, pattern recognition is everything. This tool helps you see the patterns faster."*
