# 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
```

### `deck <file> [options]`
Create investment committee presentation deck.

**Options**:
- `--template <name>` - Presentation template (default: ic-standard)
- `--slides <list>` - Specific slides to include
- `--output <path>` - Output file path

**Example**:
```bash
npm start deck acme-startup-deck.pdf --template ic-standard --output ./decks/acme-ic.pptx
```

### `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,
  "api_keys": {
    "openai": "your-api-key",
    "anthropic": "your-api-key"
  }
}
```

### Configuration Options

- **analysis_framework**: Use `standard` or `custom` framework
- **required_sections**: Sections that must be included in analysis
- **scoring**: Enable/disable automated scoring with custom weights
- **report_template**: Default template for reports
- **output_directory**: Where to save generated reports
- **save_history**: Track all analyzed deals
- **api_keys**: API keys for AI services (optional)

---

## 📂 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
│   ├── templates/
│   │   ├── report-standard.md   # Standard report template
│   │   ├── report-detailed.md   # Detailed report template
│   │   └── ic-deck.json         # IC presentation template
│   ├── utils/
│   │   ├── ai.ts                # AI/LLM integration
│   │   ├── logger.ts            # Logging utilities
│   │   └── validator.ts         # Input validation
│   └── cli/
│       └── index.ts             # CLI entry point
├── config/
│   ├── default.json             # Default configuration
│   └── .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
│   └── comparison-output.md     # Sample comparison
├── tests/
│   ├── analyzer.test.ts
│   ├── extractor.test.ts
│   └── generators.test.ts
├── 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

# Output: Executive summary with key highlights and concerns
```

### Example 2: Full Investment Memo

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

# Output: 10-15 page investment memo with full analysis
```

### 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

# Output: 10-slide PowerPoint presentation
```

### 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

# Output: Comparative analysis with scoring matrix
```

### Example 5: Extract Market Data

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

# Output:
# TAM: $50B
# SAM: $10B
# SOM: $500M (5-year target)
# Growth Rate: 25% CAGR
```

---

## 🎯 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

### For Investment Committees
- **Decision Support**: Receive standardized deal summaries
- **Comparative Analysis**: Review multiple opportunities at once
- **Risk Assessment**: Understand key risks before voting
- **Documentation**: Maintain records of investment decisions

---

## 📊 Output Examples

### Investment Analysis Report

```markdown
# Investment Analysis: Acme Fintech

**Analysis Date**: March 26, 2024
**Analyst**: AI Investment Assistant
**Recommendation**: STRONG BUY

## Executive Summary

Acme Fintech is building an AI-powered financial planning platform for SMBs...

**Investment Highlights**:
- Large and growing market ($50B TAM)
- Strong founder team with 20+ years fintech experience
- Proven traction: $2M ARR, 300% YoY growth
- Defensible technology with proprietary ML models

**Key Concerns**:
- Competitive market with well-funded incumbents
- High customer acquisition costs ($2,500 CAC)
- Regulatory risks in financial services

**Overall Score**: 8.2/10

## Market Analysis

**Total Addressable Market (TAM)**: $50B
...

[Full 10-section analysis]

## Investment Recommendation

**Recommendation**: Proceed with investment

**Investment Thesis**:
Acme addresses a clear pain point for SMBs with a differentiated AI approach...

**Next Steps**:
1. Deep dive on unit economics
2. Reference calls with existing customers
3. Technical due diligence on ML models
4. Term sheet preparation
```

### Comparison Matrix

```markdown
# Deal Comparison - Q1 2024 Pipeline

|  | Acme Fintech | Beta SaaS | Charlie AI |
|---|---|---|---|
| **Market Size** | $50B TAM | $20B TAM | $100B TAM |
| **Team Score** | 9/10 | 7/10 | 8/10 |
| **Traction** | $2M ARR | $500K ARR | $5M ARR |
| **Growth** | 300% YoY | 150% YoY | 200% YoY |
| **Valuation** | $20M | $15M | $50M |
| **Overall** | 8.2/10 | 6.5/10 | 7.8/10 |
| **Recommendation** | STRONG BUY | HOLD | BUY |
```

---

## 🔐 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
- Configurable data retention policies

---

## 🛠️ Development

### Prerequisites

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

### 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

# Lint code
npm run lint
```

### Adding Custom Analysis Modules

```typescript
// src/analyzers/custom-analyzer.ts
import { BaseAnalyzer } from './base';

export class CustomAnalyzer extends BaseAnalyzer {
  async analyze(document: Document): Promise<Analysis> {
    // Your custom analysis logic
  }
}
```

---

## 🤝 Contributing

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

### Areas for Contribution
- Additional document parsers (Notion, Google Docs, etc.)
- New analysis frameworks (industry-specific)
- Report templates
- Integration with deal management platforms
- Automated data enrichment (market data APIs)

---

## 📝 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
- **Discord**: https://discord.gg/openclaw

---

## 🙏 Acknowledgments

Built with:
- TypeScript
- Commander.js (CLI)
- pdf-parse (PDF parsing)
- officegen (PPTX generation)
- marked (Markdown processing)
- Anthropic Claude API (AI analysis)

---

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

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