From ccbdbd308dd1cb1ffc0d8d9d7af1cd3ef134553d Mon Sep 17 00:00:00 2001 From: Yusuf Date: Mon, 20 Oct 2025 11:56:19 +0100 Subject: [PATCH 1/2] starplex showcase --- docs/showcase/starplex.mdx | 92 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 92 insertions(+) create mode 100644 docs/showcase/starplex.mdx diff --git a/docs/showcase/starplex.mdx b/docs/showcase/starplex.mdx new file mode 100644 index 0000000..419fe3c --- /dev/null +++ b/docs/showcase/starplex.mdx @@ -0,0 +1,92 @@ +--- +title: StarPlex +description: An AI-powered startup intelligence platform that helps entrepreneurs validate their business ideas and find the right resources to succeed. +sidebar_position: 1 +keywords: [startup, AI, business ideas, Perplexity, Sonar Pro, 3D globe, market validation, competitor research] +--- + +# StarPlex + +StarPlex is an AI-powered startup intelligence platform designed to help entrepreneurs validate their business ideas and connect with the resources they need to succeed. Powered primarily by Perplexity Sonar Grounded LLM, it features an interactive 3D globe as its main UI. Simply enter your startup idea, and watch as the AI engine analyzes and visualizes insights directly on the globe—mapping out competitors, markets, demographics, VCs, and potential co-founders across the world in real-time. + +## Features + +- **Market Validation**: Analyzes if there's a need for the startup, market capitalization, geographic usage, historical growth, and projected growth. +- **Competitor Research**: Identifies similar startups through an interactive map filter. +- **Demographic Research**: Maps where the target market is located. +- **VC & Co-Founder Discovery**: Helps find the best-fit VC and potential co-founders with interactive map filters. +- **Interactive 3D Globe**: Visualizes all data and insights on an interactive globe. +- **Slide Deck Generation**: Automatically generates a pitch deck based on the analysis. +- **RAG Context-Aware Chatbot**: A chatbot that understands the user's business and data. + +## Prerequisites + +- Node.js (v18 or higher) +- Python 3.8+ +- Perplexity API Key +- Mapbox Token +- SERP API Key + +## Installation + +1. **Clone the repository:** + ```bash + git clone https://github.com/JerryWu0430/StarPlex.git + cd StarPlex + ``` + +2. **Backend Setup:** + ```bash + cd backend + pip install -r requirements.txt + ``` + Create a `.env` file and add your API keys: + ``` + PERPLEXITY_API_KEY=your_api_key_here + MAPBOX_TOKEN=your_api_key_here + SERPAPI_KEY=your_api_key_here + ``` + Then run the backend server: + ```bash + python3 main.py + ``` + +3. **Frontend Setup:** + ```bash + cd frontend + npm i + npm run dev + ``` + +## Usage + +Once both the backend and frontend servers are running, open `http://localhost:3000` in your browser. Enter your startup idea in the input field to begin the analysis. Use the interactive globe and map filters to explore the generated data on market trends, competitors, and more. + +## Code Explanation + +StarPlex leverages the Perplexity API (primarily the Sonar Pro model) as its core intelligence engine. The backend, built with Python and FastAPI, handles requests for AI-powered analysis. It features a centralized client for Perplexity that includes caching to optimize API usage and structured prompts for reliable JSON outputs. + +The frontend is built with Next.js and uses Cobe for the 3D globe visualization and Mapbox GL for interactive maps. + +### Example Perplexity API Usage + +```python +from perplexity import Perplexity + +client = Perplexity() +response = client.chat.completions.create( + model="sonar", + messages=[ + {"role": "system", "content": "You are a market analysis expert..."}, + {"role": "user", "content": "Analyze the market for [startup idea]"} + ], + temperature=0.7 +) +``` + +## Links + +- [GitHub Repository](https://github.com/JerryWu0430/StarPlex) +- [Devpost Submission](https://devpost.com/software/starplex) +- [Live Demo](https://www.youtube.com/watch?v=iusCyDNzY60) +- [Website](https://starplex.app) From 120c660f04cda45bb6efcdaa90c5cad618e857ec Mon Sep 17 00:00:00 2001 From: Kesku Date: Tue, 21 Oct 2025 12:24:17 +0100 Subject: [PATCH 2/2] Restructure StarPlex showcase and add video embed --- docs/showcase/starplex.mdx | 153 +++++++++++++++++++++---------------- 1 file changed, 87 insertions(+), 66 deletions(-) diff --git a/docs/showcase/starplex.mdx b/docs/showcase/starplex.mdx index 419fe3c..4c06647 100644 --- a/docs/showcase/starplex.mdx +++ b/docs/showcase/starplex.mdx @@ -1,92 +1,113 @@ --- -title: StarPlex -description: An AI-powered startup intelligence platform that helps entrepreneurs validate their business ideas and find the right resources to succeed. -sidebar_position: 1 -keywords: [startup, AI, business ideas, Perplexity, Sonar Pro, 3D globe, market validation, competitor research] +title: StarPlex | AI-Powered Startup Intelligence Platform +description: An AI-powered startup intelligence platform that helps entrepreneurs validate their business ideas and find the right resources to succeed +sidebar_position: 26 +keywords: [StarPlex, Sonar Pro, business ideas, Perplexity, Sonar Pro, 3D globe, market validation, competitor research] --- -# StarPlex +**StarPlex** is an AI-powered startup intelligence platform that helps entrepreneurs validate their business ideas and connect with the resources they need to succeed. Powered primarily by **Perplexity Sonar Pro**, it features an interactive **3D globe interface** as its main UI. Simply enter your startup idea, and watch as the AI engine analyzes and visualizes insights directly on the globe—mapping out competitors, markets, demographics, VCs, and potential co-founders across the world in real-time. -StarPlex is an AI-powered startup intelligence platform designed to help entrepreneurs validate their business ideas and connect with the resources they need to succeed. Powered primarily by Perplexity Sonar Grounded LLM, it features an interactive 3D globe as its main UI. Simply enter your startup idea, and watch as the AI engine analyzes and visualizes insights directly on the globe—mapping out competitors, markets, demographics, VCs, and potential co-founders across the world in real-time. + ## Features -- **Market Validation**: Analyzes if there's a need for the startup, market capitalization, geographic usage, historical growth, and projected growth. -- **Competitor Research**: Identifies similar startups through an interactive map filter. -- **Demographic Research**: Maps where the target market is located. -- **VC & Co-Founder Discovery**: Helps find the best-fit VC and potential co-founders with interactive map filters. -- **Interactive 3D Globe**: Visualizes all data and insights on an interactive globe. -- **Slide Deck Generation**: Automatically generates a pitch deck based on the analysis. -- **RAG Context-Aware Chatbot**: A chatbot that understands the user's business and data. +* **Market Validation Analysis** with AI-proof scoring, market cap estimation, and growth trend analysis +* **Interactive 3D Globe Interface** for visualizing global startup intelligence data +* **Competitor Research** with threat scoring and competitive landscape mapping +* **VC & Investor Matching** based on investment thesis and portfolio alignment +* **Co-founder Discovery** with compatibility scoring and expertise matching +* **Demographic Research** with heatmap visualization of target audience locations +* **AI Pitch Deck Generation** creating investor-ready presentations +* **Context-Aware Chatbot** with RAG integration across all research data ## Prerequisites -- Node.js (v18 or higher) -- Python 3.8+ -- Perplexity API Key -- Mapbox Token -- SERP API Key +* Node.js 18+ and npm +* Python 3.8+ and pip +* Perplexity API key (Sonar Pro) +* Mapbox token and SERP API key ## Installation -1. **Clone the repository:** - ```bash - git clone https://github.com/JerryWu0430/StarPlex.git - cd StarPlex - ``` - -2. **Backend Setup:** - ```bash - cd backend - pip install -r requirements.txt - ``` - Create a `.env` file and add your API keys: - ``` - PERPLEXITY_API_KEY=your_api_key_here - MAPBOX_TOKEN=your_api_key_here - SERPAPI_KEY=your_api_key_here - ``` - Then run the backend server: - ```bash - python3 main.py - ``` - -3. **Frontend Setup:** - ```bash - cd frontend - npm i - npm run dev - ``` +```bash +# Clone the repository +git clone https://github.com/JerryWu0430/StarPlex.git +cd StarPlex + +# Backend setup +cd backend +pip install -r requirements.txt + +# Frontend setup +cd ../frontend +npm install +``` + +## Configuration + +Create `.env` file in the backend directory: +```ini +PERPLEXITY_API_KEY=your_perplexity_api_key +MAPBOX_TOKEN=your_mapbox_token +SERPAPI_KEY=your_serpapi_key +``` ## Usage -Once both the backend and frontend servers are running, open `http://localhost:3000` in your browser. Enter your startup idea in the input field to begin the analysis. Use the interactive globe and map filters to explore the generated data on market trends, competitors, and more. +1. **Start Backend**: + ```bash + cd backend + python main.py + ``` -## Code Explanation +2. **Start Frontend**: + ```bash + cd frontend + npm run dev + ``` -StarPlex leverages the Perplexity API (primarily the Sonar Pro model) as its core intelligence engine. The backend, built with Python and FastAPI, handles requests for AI-powered analysis. It features a centralized client for Perplexity that includes caching to optimize API usage and structured prompts for reliable JSON outputs. +3. **Access Application**: Open http://localhost:3000 and enter your startup idea -The frontend is built with Next.js and uses Cobe for the 3D globe visualization and Mapbox GL for interactive maps. +4. **Explore Intelligence**: Use the 3D globe to visualize competitors, VCs, demographics, and co-founders -### Example Perplexity API Usage +5. **Generate Assets**: Create pitch decks and chat with the AI assistant about your analysis -```python -from perplexity import Perplexity +## How StarPlex Uses Perplexity Sonar API -client = Perplexity() -response = client.chat.completions.create( - model="sonar", - messages=[ - {"role": "system", "content": "You are a market analysis expert..."}, - {"role": "user", "content": "Analyze the market for [startup idea]"} - ], - temperature=0.7 -) -``` +StarPlex leverages Perplexity's Sonar API through a **multi-module intelligence architecture**: + +**Market Analysis Engine** +Uses Sonar Pro for comprehensive market validation, combining Google Trends data with AI analysis to generate market cap estimates, AI-disruption scores, and growth projections with structured JSON outputs. + +**Competitor Intelligence** +Employs multiple concurrent Sonar queries to identify competing companies, funding status, and threat levels. Each competitor receives a 1-10 threat score with detailed competitive positioning analysis. + +**VC & Co-founder Matching** +Leverages Sonar's real-time web knowledge to find relevant investors and potential co-founders, scoring matches based on investment thesis alignment, expertise fit, and geographic proximity. + +**Context-Aware Business Assistant** +Implements RAG (Retrieval-Augmented Generation) by feeding all research data into Sonar conversations, creating a knowledgeable startup advisor that can answer questions about market positioning, competitive threats, and strategic decisions. + +**Geographic Intelligence** +Combines Sonar's demographic insights with Mapbox geocoding to create interactive heatmaps showing where target audiences are concentrated globally. + +## Code Explanation + +* **Backend**: Python FastAPI with AsyncIO for concurrent Perplexity API calls across multiple analysis modules +* **Frontend**: Next.js with React 19, featuring Cobe for 3D globe visualization and Mapbox GL for interactive mapping +* **AI Integration**: Multi-model Perplexity strategy using Sonar Pro for complex analysis and Sonar for faster queries +* **Data Pipeline**: Intelligent caching, structured JSON responses, and real-time streaming for immediate user feedback +* **Visualization**: Dynamic data binding between Perplexity insights and interactive globe/map interfaces ## Links - [GitHub Repository](https://github.com/JerryWu0430/StarPlex) -- [Devpost Submission](https://devpost.com/software/starplex) -- [Live Demo](https://www.youtube.com/watch?v=iusCyDNzY60) -- [Website](https://starplex.app) +- [Live Demo](https://starplex.app) +- [Devpost Submission](https://devpost.com/software/starplex) \ No newline at end of file