"Vibe-Trading: Your Personal Trading Agent"
How to install vibe-trading?
hkuds/vibe-trading
$git clone https://github.com/hkuds/vibe-tradingInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Install vibe-trading by running `git clone https://github.com/hkuds/vibe-trading`, then use it for the current task and follow its documentation at https://github.com/hkuds/vibe-trading.
README.md
| 1 | <p align="center"> |
| 2 | <b>English</b> | <a href="README_zh.md">中文</a> | <a href="README_ja.md">日本語</a> | <a href="README_ko.md">한국어</a> | <a href="README_ar.md">العربية</a> |
| 3 | </p> |
| 4 | |
| 5 | <p align="center"> |
| 6 | <img src="assets/icon.png" width="120" alt="Vibe-Trading Logo"/> |
| 7 | </p> |
| 8 | |
| 9 | <h1 align="center">Vibe-Trading: Your Personal Trading Agent</h1> |
| 10 | |
| 11 | <p align="center"> |
| 12 | <b>One Command to Empower Your Agent with Comprehensive Trading Capabilities</b> |
| 13 | </p> |
| 14 | |
| 15 | <p align="center"> |
| 16 | <a href="https://trendshift.io/repositories/25527" target="_blank"><img src="https://trendshift.io/api/badge/repositories/25527" alt="HKUDS%2FVibe-Trading | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a> |
| 17 | </p> |
| 18 | |
| 19 | <p align="center"> |
| 20 | <img src="https://img.shields.io/badge/Python-3.11%2B-3776AB?style=flat&logo=python&logoColor=white" alt="Python"> |
| 21 | <img src="https://img.shields.io/badge/Backend-FastAPI-009688?style=flat" alt="FastAPI"> |
| 22 | <img src="https://img.shields.io/badge/Frontend-React%2019-61DAFB?style=flat&logo=react&logoColor=white" alt="React"> |
| 23 | <a href="https://pypi.org/project/vibe-trading-ai/"><img src="https://img.shields.io/pypi/v/vibe-trading-ai?style=flat&logo=pypi&logoColor=white" alt="PyPI"></a> |
| 24 | <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow?style=flat" alt="License"></a> |
| 25 | <br> |
| 26 | <a href="https://github.com/HKUDS/.github/blob/main/profile/README.md"><img src="https://img.shields.io/badge/Feishu-Group-E9DBFC?style=flat-square&logo=feishu&logoColor=white" alt="Feishu"></a> |
| 27 | <a href="https://github.com/HKUDS/.github/blob/main/profile/README.md"><img src="https://img.shields.io/badge/WeChat-Group-C5EAB4?style=flat-square&logo=wechat&logoColor=white" alt="WeChat"></a> |
| 28 | <a href="https://discord.gg/6TdQnT5xcF"><img src="https://img.shields.io/badge/Discord-Join-7289DA?style=flat-square&logo=discord&logoColor=white" alt="Discord"></a> |
| 29 | </p> |
| 30 | |
| 31 | <p align="center"> |
| 32 | <a href="https://vibetrading.wiki/">Website</a> · |
| 33 | <a href="https://vibetrading.wiki/docs/">Docs</a> · |
| 34 | <a href="#-news">News</a> · |
| 35 | <a href="#-key-features">Features</a> · |
| 36 | <a href="#-shadow-account">Shadow Account</a> · |
| 37 | <a href="#-demo">Demo</a> · |
| 38 | <a href="#-quick-start">Quick Start</a> · |
| 39 | <a href="#-examples">Examples</a> · |
| 40 | <a href="#-api-server">API / MCP</a> · |
| 41 | <a href="#-roadmap">Roadmap</a> · |
| 42 | <a href="#-contributing">Contributing</a> |
| 43 | </p> |
| 44 | |
| 45 | <p align="center"> |
| 46 | <a href="#-quick-start"><img src="assets/pip-install.svg" height="45" alt="pip install vibe-trading-ai"></a> |
| 47 | </p> |
| 48 | |
| 49 | --- |
| 50 | |
| 51 | ## 📰 News |
| 52 | |
| 53 | > ⚠️ **Security warning:** The X account `VibeTrading_HKU`, Virtuals project `101845`, and token contract `0x640BDBF77b6447E8b7DB7894cED84BD1c40571f4` are not official Vibe-Trading assets. We have never launched or endorsed any token or memecoin. Do not buy, connect a wallet, or sign anything. [Details](SECURITY.md#official-channels--impersonation). |
| 54 | |
| 55 | - **2026-07-22** 🚀 **v0.1.12 released** ([Release notes](https://github.com/HKUDS/Vibe-Trading/releases/tag/v0.1.12), `pip install -U vibe-trading-ai`): The **correlation regime timeline** adds a `GET /correlation/regime` endpoint + an opt-in Correlation-tab strip — edge density run through a causal hysteresis state machine that marks FUSED market episodes, descriptive risk context rather than a signal ([#756](https://github.com/HKUDS/Vibe-Trading/pull/756), closes [#719](https://github.com/HKUDS/Vibe-Trading/issues/719), thanks @ebujinovch). Provider endpoint resolution now falls back to each provider's canonical base URL and gracefully handles non-SSE endpoints, fixing the native **zai** provider on glm-5.1 ([#758](https://github.com/HKUDS/Vibe-Trading/issues/758)). Plus a strict-JSON / finite-number **reliability sweep** across metrics, factors, pattern, session, and journal ([#761](https://github.co |
Related
6 picksType
- financetoolkit200+ transparent financial metrics calculated from raw statements, not third-party endpoints.Jul 2026
- mcp-serverAn MCP server for interacting with the Financial Datasets stock market API.Jun 2025
- mcp-serverPython MCP server for local interactions with the QuantConnect API.May 2026
- alpaca-mcp-serverAlpaca Trading API integration for Model Context Protocol (MCP). V2 generates 60+ tools directly from Alpaca's OpenAPI specs using FastMCP.Jul 2026
- finopsmcpSee where your cloud and AI bills go, and spend less. Local-first, in your terminal or editor.Jul 2026
- xero-mcp-serverMCP server implementation for Xero integrationJun 2026
