README.md

# Startup Idea Validator

Describe your startup idea and get comprehensive AI analysis: market size, competition, feasibility, business model, risks, and a go/no-go verdict.

## Features

- **Viability Score** - 1-100 score with GO/NO-GO verdict
- **Market Analysis** - TAM, growth trends, timing assessment
- **Competition Check** - Direct competitors with strengths/weaknesses
- **Feasibility** - Technical complexity, MVP timeline, cost estimate
- **Business Model** - Revenue model, pricing, unit economics
- **User Acquisition** - Channels, viral potential, early adopters
- **Risk Assessment** - Key risks with severity and mitigation
- **Action Plan** - Prioritized next steps
- **Pivot Suggestions** - Alternative angles if needed

## Quick Start

```bash
# Backend
cd backend
cp .env.example .env
npm install
npm start            # Port 3005

# Frontend
cd frontend
npm install
npm run dev          # Port 5178
```

### AI Setup (choose one - both are FREE)

| Provider | Best For | Setup |
|----------|----------|-------|
| **Groq** (cloud) | Deployment, sharing | Get free key at [console.groq.com/keys](https://console.groq.com/keys), add `GROQ_API_KEY` to `.env` |
| **Ollama** (local) | Development, offline | Install from [ollama.com](https://ollama.com), run `ollama pull llama3.2:3b` |

If both are configured, Groq is used first with Ollama as fallback.

## Tech Stack

- **Frontend**: React 19 + Vite
- **Backend**: Express.js
- **AI**: Groq (cloud) / Ollama (local) - both free, no paid API needed