valuecell README

The project's README from github.com/ValueCell-ai/valuecell. As one markdown file: README.md.

Python version License: Apache2.0
chat on Discord follow on X(Twitter) follow on LinkedIn follow on Facebook Watch on YouTube
English 中文(简体) 中文(繁體) 日本語

ValueCell

Our Product Launched 🔥🔥🔥

ValueCell now provides A-share deep research, market analysis and requires no deployment—access directly at valuecell.ai.

Description

ValueCell is a community-driven, multi-agent platform for financial applications. Our mission is to build the world's largest decentralized financial agent community.

It provides a team of TOP investment Agents to help you with stock selection, research, tracking, and even trading.

The system keeps all your sensitive information stored locally on your device, ensuring core data security.

Welcome to join our Discord community to share feedback and issues you encounter, and invite more developers to contribute 🔥🔥🔥

Note: ValueCell team members will never proactively contact community participants. This project is for technical exchange only. Investing involves risk. ⚠️

Screenshot

Watch the video

Key Features

Multi-Agent System

Flexible Integrations

Quick Start

New Users

To get started quickly, download the latest ValueCell application for MacOS or Windows from the Releases page on GitHub.

After installation, please configure your preferred model provider before using ValueCell for the first time. Refer to the instructions in the application or documentation as needed.

Live Trading

Supported Exchanges

Exchange Notes Status
Binance Only supports international site binance.com, not US site. Uses USDT-M futures (USDT-margined contracts). Ensure your futures account has sufficient USDT balance. Trading pair format: BTC/USDT. Note: Ensure perpetual contract account balance is not 0. When applying for API, add IP whitelist by searching My IP in search engine ✅ Tested
Hyperliquid Only supports USDC as margin currency. Uses your main wallet address + API wallet private key authentication (use API tab to apply). Market orders are automatically converted to IoC limit orders. Trading pair format must be manually adjusted to SYMBOL/USDC (e.g., WIF/USDC). Configure with main wallet address + API wallet private key. Minimum 10U per trade ✅ Tested
OKX Requires API Key, Secret, and Passphrase (OKX account password) for authentication. Supports USDT-margined contracts. Trading pair format: BTC/USDT ✅ Tested
Coinbase Supports USDT-margined contracts. Coinbase International is not yet supported 🟡 Partially Tested
Gate.io Supports USDT-margined contracts. Requires API Key and Secret 🟡 Partially Tested
MEXC Supports USDT-margined contracts. Requires API Key and Secret 🟡 Partially Tested
Blockchain Supports USDT-margined contracts. Requires API Key, Secret 🟡 Partially Tested

Legend:

Notice


Note: Before running the application, ensure all prerequisites are installed and environment variables are properly configured. If it has been a long time since the last update, you can delete local data stores and start fresh:

Developers

We sincerely invite all developers to join our Discord discussion group, where we regularly share the community roadmap and upcoming contributor benefit plans.

Details on development processes and standards are provided below:CONTRIBUTING.md

ValueCell is a Python-based application with a comprehensive web interface, supporting multi-platform deployment. Follow the configuration below to get started quickly.

Clone Repository

git clone https://github.com/ValueCell-ai/valuecell.git
cd valuecell

Running the Application

Launch the complete application (frontend, backend, and agents):

Linux / Macos

bash start.sh

Windows (PowerShell)

.\start.ps1

Accessing the Interface

Next Steps

Once the application is running, you can explore the web interface to interact with ValueCell's features and capabilities.

Configuration

More detailed configuration information can be found at CONFIGURATION_GUIDE

Roadmap

🤖 Enhanced Agent Capabilities

Trading Capabilities

Market Expansion

Asset Diversification

Advanced Notification & Push Types

⚙️ Product Configuration & Personalization

Multi-platform Products

Internationalization (i18n)

Token & Authentication Management

User Preferences & Customization

Memory & Learning Systems

🔧 ValueCell SDK Development

Core SDK Features

Agent Integration Framework

Developer Tools & Documentation

LICENSE

This project is licensed under the Apache License 2.0 — see the LICENSE file for details.

📌 Note: Apache 2.0 applies only to original code authored by the ValueCell team and contributors. Third-party components (e.g., APIs, widgets, libraries) are governed by their own licenses and terms — see below.

Third-Party Components & Licensing

ValueCell integrates external services and embeds third-party widgets. Their usage is not covered by Apache 2.0, and compliance with their terms is your responsibility as a user/developer.

Component Type License / Terms
TradingView Advanced Chart Embedded iframe widget Free Advanced Charts Agreement (proprietary)
Exchange APIs (Binance, OKX, Hyperliquid, etc.) REST/WebSocket endpoints Each exchange’s ToS (e.g., Binance API Terms)
LLM Providers (OpenAI, Azure, Google, DeepSeek, etc.) Inference APIs Provider-specific ToS (e.g., OpenAI ToS)

Star History

TradingAgents Star History

valuecell (ValueCell-ai/valuecell)

Searching Database…

What is this?ValueCell is a community-driven, multi-agent platform for financial applications: a team of AI investment agents that helps you pick stocks, do research, track markets and even execute trades.
Is this an app I install, or something I run from source?Both. Ready-made apps for macOS and Windows are published on the GitHub Releases page, and developers can clone the Python repo and run frontend, backend and agents themselves — either way you work through a web UI in the browser.
What do I do first after installing?Configure your preferred model provider — the app asks for it on first launch. For live trading you then add your model API key and exchange API credentials through the web interface, create a strategy and start the trader.
Do I need to bring my own AI model?Yes. You add an API key for one of the supported providers — OpenRouter, SiliconFlow, Azure, OpenAI, Google, DeepSeek or any OpenAI-compatible endpoint. Live trading additionally requires API credentials from your exchange.
Can it trade with real money, and is there a catch?Only contract trading is supported — spot is emulated as 1X contracts — so your perpetuals account needs a sufficient balance. Binance, Hyperliquid and OKX are fully tested; Coinbase, Gate.io and MEXC are only partially tested.
Is it safe to paste my exchange API keys into it?Secrets stay on your device: the README states they are stored locally and not sent to any third party, and the LanceDB store, knowledge files and SQLite database also live in your system application directory. Resetting API keys regularly is recommended.
What exactly does the Apache 2.0 license cover here?Only the original ValueCell code. Third-party pieces embedded in the app — the TradingView chart widget, exchange APIs and LLM providers — carry their own terms, and complying with them is your responsibility.
Which exchanges are actually proven for live trading?Binance (international site only, USDT-margined futures), Hyperliquid (USDC margin, minimum 10 USD per trade) and OKX are fully tested in production. Coinbase, Gate.io, MEXC and Blockchain are implemented but only partially tested, so expect to debug.
What can the agents do besides trading?The DeepResearch Agent retrieves and analyzes fundamental documents to produce data insights and interpretable summaries, and the News Retrieval Agent delivers personalized scheduled news to track key information in real time. More agents are in planning.
Which markets does it cover?US, crypto, Hong Kong and China markets, with A-share deep research and market analysis available directly at valuecell.ai without any deployment. European indexes, commodities, forex, bonds and options analysis are on the roadmap.
Is it safe to let the agents trade my money?The team is explicit that the project is for technical exchange only and investing involves risk. Only leverage trading is supported, you must keep API secrets secure to avoid losing funds, and regular API key resets are advised.
Size
21.6 MB
Stars
11K
Age
1y
Commits · 90 Days