explaingit

shythu49/competeinsight

Analysis updated 2026-05-18

40PythonAudience · pm founderComplexity · 4/5Setup · hard

TLDR

A multi-agent research tool that turns a competitive analysis question into a sourced, evidence-backed Markdown report comparing named competitors.

Mindmap

mindmap
  root((CompeteInsight))
    What it does
      Plans research queries
      Gathers public evidence
      Writes Markdown report
    Tech stack
      FastAPI
      React
      Python
    Use cases
      Competitor comparison matrix
      Pricing and feature research
      Market positioning report
    Audience
      PMs and founders
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Generate a competitor comparison matrix across pricing, features, or positioning.

USE CASE 2

Produce a sourced Markdown report on a market with citations and confidence levels.

USE CASE 3

Ask follow-up questions about a completed research report through the AI Analysis Assistant.

What is it built with?

PythonFastAPIReactTypeScriptVite

How does it compare?

shythu49/competeinsightcortex-ai-quant/crypto-arbitrage-bot-automated-tradingdexmal/realtime-vla-flash
Stars404040
LanguagePythonPythonPython
Setup difficultyhardhardhard
Complexity4/53/55/5
Audiencepm foundergeneralresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires configuring at least one LLM provider key plus search API keys (Tavily, Exa, Zhihu) before it runs.

In plain English

CompeteInsight is a research automation tool that takes a competitive analysis question and turns it into a full written report. You describe a product, name the competitors you want to study, set a research objective and the dimensions you care about (for example, pricing, features, or market positioning), and the system does the rest. The output includes structured evidence tied to sources, a competitor comparison matrix, and a final Markdown report with recommendations. Under the hood, the work is split across five AI agents that each handle one stage of the pipeline. A Planning Agent breaks the question into search queries and quality rules. A Search Agent runs those queries against public sources including Tavily, Exa, Zhihu, and DuckDuckGo. A Fetcher retrieves the actual page content. An Evidence Agent reads that content and extracts specific quotes and facts, recording the source URL, confidence level, and which competitor and dimension each fact relates to. An Analysis Agent then groups the evidence into claims and runs a red-team review step that looks for weaknesses or counter-evidence in those claims. Finally, a Report Agent assembles everything into the final report files. The pipeline includes a coverage check between the search and reporting stages. If the evidence collected is too thin, too uniform in sources, or has too many weak-confidence claims, the system generates additional search queries and loops back to gather more material before proceeding. The backend is built with FastAPI and Python, the frontend is React. LLM calls use an OpenAI-compatible client that can connect to Ark, DeepSeek, or Qwen model providers. All research artifacts are saved locally under a data/runs directory as JSON, Markdown, and CSV files, making individual runs traceable. The project was built for an AI agent competition and is described in the README as a public demo rather than a production multi-tenant product.

Copy-paste prompts

Prompt 1
Set up CompeteInsight locally with the FastAPI backend and React frontend
Prompt 2
Run a competitive research pass on three named competitors and a pricing dimension
Prompt 3
Explain how the Coverage Gate decides when to gather more evidence
Prompt 4
Which LLM provider keys does CompeteInsight need to run?

Frequently asked questions

What is competeinsight?

A multi-agent research tool that turns a competitive analysis question into a sourced, evidence-backed Markdown report comparing named competitors.

What language is competeinsight written in?

Mainly Python. The stack also includes Python, FastAPI, React.

How hard is competeinsight to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is competeinsight for?

Mainly pm founder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.