OpenInvestOp
About
Research-grade investment decision engine for AI agents: isolated multi-agent committee, auditable verdicts, backtests with lookahead protection, published negative results
Details
- Author
- longsizhuo
- Categories
- Finance, Other, AI
Jump to
Setup
Install OpenInvestOp in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/longsizhuo/openInvest
Follow the installation instructions in the repository README, then restart your MCP client.
A self-hosted investment decision engine built for modern AI agents. Multi-agent information isolation and cross-challenge protocol, providing an auditable decision trail (Audit Trail).
OpenInvest is a self-hosted investment decision engine built for modern AI agents.
It provides a verifiable investment committee, evidence-based reasoning, long-horizon backtesting, and auditable decision records. Instead of replacing Claude Code, Codex, Hermes, or OpenClaw, OpenInvest is designed to power them.
- Benchmark Portfolio: The system introduces 8 standard control benchmarks across 4 quadrants (AI advisors / Mutual funds / Wealth management / Broad market index). For details on the comparison methodology and data cleaning logic, seedocs/wiki/README.md.
System Self-Disclosure: This system is anauditing tool to eliminate human investment cognitive biases and enforce reasoning transparency, not a return-amplifying black box. Latest automated audit (docs/verdict_accuracy.md): Directional verdicts (excluding HOLD) have a true hit rate of42.2%(n=56,below random);HOLDaccounts for56%of all decisions. The system's value lies in transparency and discipline (mostly staying inactive, low turnover),not directional prediction. Detailed log stream can be found indocs/verdict_accuracy.md.
This project systematically attempts to falsify its own edge and publishes negative results as-is. The deterministic features the committee reads, and the timing signals around them, were tested against pre-registered statistical gates — none survived as tradable alpha.
Methodology: Newey-West HAC t-statistics, Deflated Sharpe Ratio (Bailey & López de Prado 2014, re-derived equation by equation), Holm correction, zero lookahead, and LLM training-cutoff probes.
Details:experiments/signal-eval/README.md·docs/verdict_accuracy.md·ADR-022·ADR-023
Most AI investment assistants try to become better chatbots. OpenInvest instead builds a transparent, verifiable, and auditable decision engine that plugs into personal agents such as Claude Code, Codex, Hermes, and OpenClaw — every improvement in those agents automatically makes OpenInvest more capable.
The division of labor is deliberate: your agent handles long-term memory, natural conversation, and user understanding; OpenInvest handles the verifiable investment committee, evidence-based reasoning, long-horizon backtesting, and auditable decision records.
User │ ┌───────────┴───────────┐ ▼ ▼ Your Agent OpenInvest (User Understanding) (Market Understanding) │ │ └───────────┬───────────┘ ▼ Better Investment Decisions
Your agent knows you. OpenInvest knows investing.
OpenInvest intentionally avoids "owning" the user. Most AI products try to own everything—memory, persona, chat history, and workspaces. OpenInvest takes a back seat. It exposes clean APIs, CLI commands, and agent skills (Claude Code / Codex / Hermes / OpenClaw), letting your primary agent manage the conversation and context while OpenInvest powers the underlying investment intelligence.
- Multi-Agent Investment Committee: Isolated analysis and round-rebuttal debate.
- Coordinator-Worker Architecture: Prevents context contamination and role hallucination.
- Information Isolation: Rigidly blocks quant and risk analysts from out-of-boundary contexts.
- Auditable Decision Trail: Clean logs showing exactly "why" each decision was made.
- Markdown-as-a-Database: Frontmatter (YAML) + Markdown (Body) as the single source of truth.
- Long-Horizon Backtesting: Built-in test harness with lookahead bias protections.
- Dreaming-Based Memory Consolidation: Nightly memory distillation to prevent context drift.
- Self-Hosted / Zero-Cost: Powered directly by your local agent's reasoning resources.
- Agent Skill: Lightweight plugin for Claude Code / Codex / Hermes / OpenClaw, with interactive bootstrap wizard.
- Automated Deployment: GitHub Actions workflow to run the committee and email reports daily.
1. Integrate with your agent (Recommended)
Add the lightweight skill from your agent's plugin registry. The host agent will automatically pull the core code and align dependencies on first run:
# Claude Code /plugin marketplace add longsizhuo/openInvest /plugin install invest@openinvest # Codex codex plugin marketplace add longsizhuo/openInvest # Hermes Agent hermes plugins install longsizhuo/openInvest --enable # OpenClaw openclaw plugins install clawhub:openinvest
Any other MCP client: register the MCP server from step 2 below (full walkthrough in theagent tutorial).
2. Standalone — MCP server or CLI (no clone needed)
The backend ships onPyPI;~/openInvestholds only your data:
# MCP (18 tools, any MCP client; add --http for a remote streamable-HTTP server — BETA) claude mcp add openinvest -e INVEST_HOME=~/openInvest -- uvx openinvest-mcp # or plain CLI INVEST_HOME=~/openInvest uvx openinvest status
Sendset up invest(or帮我初始化 invest) to any skill-enabled AI terminal. The system will trigger an interactive bootstrap wizard to guide you through:
- Detecting thememory/state storage path and.envconfiguration.
- 5-dimensional profiling (Legal name, Risk capacity, Debt structure, Initial holdings, and optional keys).
- Running static data migration to immediately generate your first asset exposure memo.
💡Zero-Cost Execution: In skill interactive mode, the committee's underlying reasoning relies entirely on the host agent's (e.g. Claude Code) reasoning pipeline.No third-party API Key is consumed. You only need to configure an API key when setting up automated crons or calling independent Web APIs.
For self-hosting details, seedocs/QUICK_START.md. (The bundled Web GUI was retired on 2026-07-05 — all capabilities are exposed via CLI/MCP; a standalone frontend may return later.)
3. Serverless Self-Hosting (GitHub Actions)
Run the committee automatically via GitHub Actions and receive daily digest emails.
⚠️Fork must be set to Private: State files (holdings, verdicts) will be committed back to your fork. Public forks will leak your private financial information.
- Fork this repositoryand change its visibility toPrivate(Settings -> Visibility).
- Runset up investlocally to generate the initialmemory/folder, then commit and push it to your private fork:
git add -f memory/ && git commit -m "chore: init memory state" && git push
- LLM_API_KEY(orDEEPSEEK_API_KEY): API key to run the committee.
- EMAIL_SENDER/EMAIL_PASSWORD: Gmail address +App Password.
- DIGEST_EMAIL_TO: Recipient email address.
Architecture & Multi-Agent Orchestration
openInvest does not run a mock debate in a single LLM session. The system enforces anInformation Isolation Contractat thecore/committee/layer, orchestrating 4 independent LLM processes in a directed acyclic graph (DAG):
[ Macro Data Injection ] │ ▼ 1. Macro Alignment Context ┌──────────────────────────┐ │ Macro Strategist │ (VIX / Interest rate spread / Currency momentum) └─────────────┬────────────┘ │ ▼ 2. Async Multi-Dimensional Scrutiny (Async DAG) ┌─────────────┴────────────┐ ▼ ▼ ┌──────────────────┐ ┌──────────────────┐ │ Quant Analyst │ │ Risk Officer │ │ (RSI / Momentum) │ │ (Concentration) │ │ │ │ │ │ 🛑 No Holdings │ │ 🛑 No Indicators │ └─────────┬────────┘ └─────────┬────────┘ │ │ └─────────────┬─────────────┘ │ ▼ 3. Round 2 Rebuttal & Cross-Challenge │ Mutual feedback loop for signal correction ▼ ┌──────────────────────────────────────────────┐ │ Chief Investment Officer (CIO) │ └───────────────────────┬──────────────────────┘ │ ▼ 4. Deterministic State Persistence [ BUY / ACCUMULATE / HOLD / TRIM / SELL ]
- Macro Strategist: Assesses the global macro landscape (VIX, yield curve spread, core currency matrix) to establish the portfolio's risk threshold.
- Quant Analyst: A pure mathematical momentum and technical indicator filter.Strictly blocked from knowing portfolio holdingsto eliminate human attachment and loss-aversion biases.
- Risk Officer: Focuses entirely on tail risks (drawdown buffers, concentration limits, solvency multipliers).Strictly blocked from technical indicatorsto make objective asset exposure rulings.
- Round 2 Rebuttal: Quant and Risk analysts are fed each other's Round 1 reports in Round 2, challenging boundaries until signals converge or safety valves trigger.
- CIO (Chief Investment Officer): Synthesizes the audited reports and outputs a structuredVerdict(BUY / ACCUMULATE / HOLD / TRIM / SELL) with a confidence level.No auto-order execution occurs; final action remains strictly up to the human auditor.
Key trade-offs behind this design are recorded as ADRs indocs/wiki/adr/(24 to date), including rulings that overturned our own earlier designs —ADR-007retired the few-shot CIO route, andADR-009rejected TA-style analyst agents after a pre-registered experiment.
- Coordinator-Worker Pattern: Workers operate in isolated namespaces. Boundary constraints are hardcoded at the framework layer in Python to prevent attention contamination in large multi-role prompts.
- Markdown-as-a-Database: The system uses Frontmatter (YAML) + Markdown (Body) as the single source of truth. Leveragingfcntl.flockprocess file locks and temporary atomic file replacement, it provides a tamper-proof investment audit trail natively tracked by Git.
- Three-Phase Dreaming Consolidation: Distills daily decisions against actual market outcomes nightly (Light Sleep $\rightarrow$ REM $\rightarrow$ Deep Sleep) to consolidate long-term insights, preventing Large Language Model (LLM) context drift over long execution spans.
The system defaults to DeepSeek endpoints and supports any standard OpenAI-compatible API. LLM provider setup and all tunable runtime overrides (ADR-017) are documented indocs/wiki/22-configuration.md.
- No Financial Advice: This system is a decision-support tool powered by LLMs. Output memos represent simulated reasoning based on deterministic data and do not constitute asset allocation advice.
- Backtest Time-Lock & Lookahead Guard: The backtest engine (scripts/backtest_runner.py) has a hardcoded safety valve:it rejects backtests fordecision_date > 2024-06-30by default(override with--allow-lookahead). Since mainstream foundation models have training cutoff dates around mid-2024, backtesting on later intervals introduces severeLookahead Bias(model pre-training leakage). Parameter tuning, Optuna sweeps, and prompt optimization must run strictly on historical windows prior to June 30, 2024.
- MiMo— Special thanks to MiMo Quantitative Lab for sponsoring production-grade high-performance LLM inference (poweringmimo-v2.5-prolong-horizon sweeps).
- OpenClaw Dreaming Guide— Theoretical foundation for the three-phase sleep-cycle memory distillation framework.
This project is licensed under the MIT License - see theLICENSEfile for details.
Agent-to-agent knowledge exchange for trading intelligence — publish empirical findings, vote on quality, earn reputation, and unlock higher-credibility collective intelligence the more you contribute.
Coinrule Agentic Trading MCP enables investors to create, backtest, execute, and manage trading agents through natural language across stocks, crypto and ETFs
Invest with Claude and other AI assistants
Institutional squeeze scanner, options flow, IWM 0DTE, AI council verdicts. Pay per call in RLUSD on XRPL — no API keys. Agent Credit Bureau, signal marketplace, hiring protocol.
Automate Your Trading. Zero Code Required. Build, backtest, and run algorithmic strategies using visual blocks and AI. Connect your exchange and go live in minutes.
Hosted MCP server for Chinese A-share and ETF market data, including prices, fundamentals, capital flows, financial statements, real-time quotes, and news.
Portfolio & trading-strategy stress diagnostics for AI agents: multi-asset stress with hedge-break detection, a daily preregistered regime outlook and deflated-Sharpe backtest-integrity checks. Remote streamable HTTP, free tier, no auth.
Give any AI agent the power to run a serious Monte Carlo forecast for a stock or ETF - in one tool call.
Market intelligence your AI agent can call
SEC filings, earnings transcripts, guidance signals & macro calendar for S&P 500. 11 MCP tools for algo traders and financial analysts using Claude Code.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.




