MarketFish – Simulate a market with 128 AI consumers before you launch

🐟 MarketFish

Don't guess. Simulate.

Before you launch, let hundreds of AI consumers vote with their wallets.

MarketFish is a multi-agent market simulation engine. Instead of asking one LLM "will this product succeed?", it builds a digital market with 128+ AI consumers — each with their own identity, budget, emotions, and biases — and lets them shop across 30 rounds. Their purchase decisions, churn patterns, and social influence reveal what real users would do.

Built on 6 academic papers (Generative Agents, OASIS, TwinMarket, Agent Bazaar, EconSimulacra, SMIF) and 11 LLM providers.

中文文档

Quick Start

git clone https://github.com/Key-wxh/market-fish.git cd market-fish cp .env.example .env # Edit .env — add at least ONE LLM API key (DeepSeek is cheapest) pip install -r requirements.txt streamlit run streamlit_app.py

Open http://localhost:8501 → pick a mode → run.

Screenshots

... continue reading