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

# 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, add GROQ_API_KEY to .env
Ollama (local)	Development, offline	Install from 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