README.md

---
title: StartupScan
emoji: 🚀
colorFrom: red
colorTo: red
sdk: docker
app_port: 8501
tags:
  - streamlit
pinned: false
short_description: AI-powered tool for scanning and validating startup ideas
---

# 🚀 StartupScan - Streamlit App

A comprehensive AI-powered tool for scanning and validating startup ideas with market research and competitive analysis.

## Features

- **🎯 Idea Clarification**: AI assessment of originality, mission, and objectives
- **📊 Market Research**: TAM/SAM/SOM analysis and customer segmentation  
- **🏢 Competitor Analysis**: SWOT analysis and positioning assessment
- **📋 Validation Report**: Executive summary with strategic recommendations

## Setup & Installation

1. **Install Dependencies**:
   ```bash
   pip install -r requirements.txt
   ```

2. **Set Environment Variables**:
   ```bash
   export OPENAI_API_KEY="your-openai-api-key"
   export ATLA_INSIGHTS_TOKEN="your-atla-insights-token"
   export GOOGLE_API_KEY="your-google-api-key"  # For search functionality
   ```

3. **Run the Streamlit App**:
   ```bash
   streamlit run src/streamlit_app.py
   ```

4. **Open Your Browser**:
   The app will automatically open at `http://localhost:8501`

## Usage

1. **Enter Your Startup Idea**: Describe your startup idea in detail in the text area
2. **Choose AI Model**: Select from GPT-4o, GPT-4o-mini, o1, or o3-mini for analysis
3. **Click "Validate My Idea"**: The AI agents will scan and analyze your idea through multiple phases
4. **Review Results**: Get a comprehensive validation report with recommendations
5. **Download Report**: Save the validation report as a markdown file

## Example Startup Ideas

- AI-powered personal finance coach for millennials
- Sustainable packaging solutions for e-commerce
- Virtual reality fitness platform for remote workers
- Marketplace for local artisan food products
- Smart home energy optimization system

## Requirements

- Python 3.8+
- Valid OpenAI API key
- Atla Insights token (for monitoring)
- Google API key (for search functionality)

## Troubleshooting

- **API Errors**: Ensure all environment variables are set correctly
- **Slow Performance**: The validation process typically takes 2-5 minutes
- **Connection Issues**: Check your internet connection and API limits

## Note

This validation is for informational purposes only. Conduct additional due diligence before making investment decisions.