git404hub

what is market-fish fr?

key-wxh/market-fish — explained in plain English

Analysis updated 2026-05-18

44PythonAudience · pm founderComplexity · 3/5LicenseSetup · moderate

tl;dr

A multi-agent simulation tool that predicts product success by running 128+ AI shopper agents through a simulated market over 30 rounds.

vibe map

mindmap
  root((repo))
    What it does
      Simulates AI shoppers
      Predicts product success
    Tech stack
      Python
      Streamlit
      LLM APIs
    Use cases
      Idea validation
      Competitor simulation
    Audience
      Founders
      Product managers

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 make with this?

VIBE 1

Test whether a product idea would survive by simulating over 100 AI shoppers deciding whether to buy it

VIBE 2

Discover promising product directions by letting AI agents explore seed market data

VIBE 3

Compare your product idea against AI-generated competitors in the same simulated market

what's the stack?

PythonStreamlitLLM APIs

how it stacks up fr

key-wxh/market-fishajay150313/agentsre-langchainhakkachhamza/clonex
Stars444444
LanguagePythonPythonPython
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audiencepm founderdeveloperdeveloper

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

how do i run it?

Difficulty · moderate time til it works · 30min

Requires at least one LLM provider API key added to a local .env file before running.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

MarketFish is a simulation tool that tries to predict whether a product idea will succeed by building a small artificial market instead of just asking a single AI model for an opinion. It creates over 128 AI shopper agents, each with its own identity, budget, emotional traits, and biases, and runs them through 30 rounds of shopping so their purchase decisions, drop-off patterns, and influence on each other can be observed like a miniature market. The project draws its design from six published research papers on agent-based simulation, including work on generative agents that remember and reflect on their own past decisions, a time engine that activates agents realistically instead of having everyone active every round, a recommendation system for personalized product suggestions, a cognitive loop with behavioral biases, a stress model that adjusts what agents are willing to pay under financial or social pressure, and a grounding layer that keeps agent decisions constrained by retrieved facts and rules. To use it, you clone the repository, copy the example environment file, add at least one API key for a supported large language model provider such as DeepSeek, OpenAI, or Anthropic, install the Python dependencies, and launch a Streamlit dashboard in the browser. From there you pick one of three modes: an exploration mode that lets the AI agents discover promising product directions from seed data on their own, a validation mode where you describe your own product idea and get back a survival score, buyer profiles, and a suggested price, and a hybrid mode that pits your idea against AI-generated competitor products in the same simulated market. There is also a command-line interface for running the same explore and validate workflows without the dashboard, including an option to reuse previously generated agents to cut down on API costs. The README compares MarketFish to a similar project called MiroFish, noting that MarketFish focuses specifically on product market prediction, runs as a single Streamlit app with no external memory service, and supports eleven different LLM providers across Chinese and global vendors. The project requires Python 3.12 or newer and is released under the MIT license, free for personal and commercial use.

prompts (copy fr)

prompt 1
Help me run MarketFish in validate mode to test my product idea and get a survival score
prompt 2
Explain the difference between MarketFish's explore, validate, and hybrid modes
prompt 3
Walk me through adding a DeepSeek or OpenAI API key to the .env file and starting the Streamlit dashboard

Frequently asked questions

what is market-fish fr?

A multi-agent simulation tool that predicts product success by running 128+ AI shopper agents through a simulated market over 30 rounds.

What language is market-fish written in?

Mainly Python. The stack also includes Python, Streamlit, LLM APIs.

What license does market-fish use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is market-fish to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is market-fish for?

Mainly pm founder.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.