gitwtfhub

wtf is vibe-research?

simonlin1212/vibe-research — explained in plain English

Analysis updated 2026-08-13

2,005TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

A personal investment research dashboard for A-share, US, and Hong Kong stocks that gathers market data and news but leaves all analysis to your own AI.

Mindmap

mindmap
  root((Vibe-Research))
    What it does
      Investment research dashboard
      Aggregates market data
      No buy sell advice
    Tech stack
      Python FastAPI
      React TypeScript
      Tailwind CSS
    Use cases
      Daily market recap
      Bull vs bear AI debate
      Connect your own AI
    Audience
      Retail investors
      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

Why would anyone build with this?

REASON 1

Get a daily recap of A-share, US, and Hong Kong market conditions in one dashboard.

REASON 2

Read individual stock valuation, financials, and fund flow data without recommendations.

REASON 3

Run a bull versus bear AI debate on a stock to see both sides of an argument.

REASON 4

Connect your own AI subscription or API key to analyze the aggregated data.

What's in the stack?

PythonFastAPIReactTypeScriptTailwind CSS

How it stacks up

simonlin1212/vibe-researchmicrosoft/flint-chartdavidmonterocrespo24/velxio
Stars2,0052,0141,990
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasyeasy
Complexity3/53/52/5
Audiencedeveloperdeveloperdeveloper

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Python 3.10+ with a virtual environment for the backend and Node.js/npm for the frontend.

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

Wtf does this do

Vibe Research is a personal investment research dashboard covering Chinese A shares, along with US and Hong Kong stocks. It does not tell you what to buy or sell. Instead it gathers price data, valuation numbers, financial reports, company announcements, fund flows, and news, and lays it all out on a clean dashboard, leaving the final judgment to an AI model that you connect yourself. The dashboard brings together several pieces in one place: a daily market recap covering both the overall index and individual stocks you are watching, a news radar that pulls from over a hundred public feeds across a dozen categories and lets AI summarize the day's key points, detailed pages for individual stocks with valuation history, financial highlights, and fund flow data, a watchlist you can paste stock codes into, a sector overview, a record of your current and past holdings, a place to upload your own research reports, and a running log of your research notes and AI conversations you can look back on later. One notable feature is a bull versus bear debate mode. The backend first pulls together a set of objective facts about a stock, then has separate bullish and bearish AI researchers form independent arguments from that same data, optionally challenging each other, before a neutral moderator summarizes where they agree, where they genuinely disagree, and what data is still missing. It is designed to produce a clearer picture of the debate, not a buy or sell recommendation. All of the underlying market data comes from open source data toolkits that are included directly inside the repository, so nothing extra needs to be downloaded or connected separately to get started. You can connect your own AI in three ways: by using a coding assistant CLI you are already logged into, such as Claude Code, Codex, Qwen Code, or DeepSeek CLI, without needing a separate API key, by entering your own API key for a provider like DeepSeek, OpenAI, or OpenRouter, or by exposing the backend as an MCP server that an agent like Claude Code can call directly. The backend is written in Python with FastAPI, and the frontend uses React 19 with TypeScript and Tailwind. It is released under the MIT license.

Yoink these prompts

Prompt 1
Walk me through running Vibe-Research's backend and frontend locally.
Prompt 2
Explain how Vibe-Research's bull versus bear debate mode works.
Prompt 3
How do I connect my Claude Code subscription to Vibe-Research without an API key?
Prompt 4
What data sources does Vibe-Research use for A-share stocks, and where do they come from?
Prompt 5
Show me how to look up a US stock like AAPL or a Hong Kong stock like 00700 in Vibe-Research.

Frequently asked questions

wtf is vibe-research?

A personal investment research dashboard for A-share, US, and Hong Kong stocks that gathers market data and news but leaves all analysis to your own AI.

What language is vibe-research written in?

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

What license does vibe-research use?

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

How hard is vibe-research to set up?

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

Who is vibe-research for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.