openInvest
An investment runtime built for AI agents. Your agent knows you — openInvest knows investing.
openInvest runs a 4-role LLM investment committee (Macro Strategist, Quant Analyst, Risk Officer, CIO) that debates any asset and returns a BUY / ACCUMULATE / HOLD / TRIM / SELL verdict with a written memo — plus portfolio tracking, a decision ledger, and full decision-accounting (which advice you followed, what happened after).
It is not a chatbot. Conversation, memory, and personalization stay in your agent (Claude Code, Codex, Hermes, OpenClaw, Cursor, or any script); openInvest provides the investing capabilities behind it.
Install & run
# no install needed — uvx fetches and caches it
INVEST_HOME=~/openInvest uvx openinvest status
# or install it
pip install openinvest
INVEST_HOME is your data directory (portfolio, ledgers, .env). All state lives there — the package itself is stateless.
First-time setup
uvx openinvest init # interactive onboarding (or `--from-stdin` for agents)
uvx openinvest doctor # health check
As an MCP server (recommended for agents)
Tools for portfolio read/write, live prices, the decision ledger, and the committee — over stdio (or openinvest-mcp --http for a remote streamable-HTTP server, BETA):
claude mcp add openinvest -e INVEST_HOME=~/openInvest -- uvx openinvest-mcp
Read tools carry readOnlyHint; money-moving tools (buy, sell, deposit, withdraw) carry destructiveHint, so MCP clients gate them behind confirmation.
As an agent plugin (Claude Code / Codex / Hermes)
Skills (committee orchestration protocol) + MCP server, bundled:
# Claude Code
/plugin marketplace add longsizhuo/openInvest
/plugin install invest@openinvest
# Codex
codex plugin marketplace add longsizhuo/openInvest
codex plugin add invest@openinvest
# Hermes Agent (official plugin catalog)
hermes plugins install openinvest --enable
# older Hermes without the catalog: hermes plugins install longsizhuo/openInvest/plugin --enable
What it does
- Investment committee — 4 LLM roles debate any
yfinancesymbol (equities, ETFs, crypto, commodities, any currency). Two execution paths: Coordinator (your agent plays the roles — no API key) or Direct (backend LLM, needsDEEPSEEK_API_KEY). - Portfolio management — multi-currency cash + holdings with an append-only, fcntl-locked ledger. Never places real orders.
- Decision accounting — every verdict is joined at read time with rule interventions, your executions (or refusals, with reasons), and post-hoc PnL. Ask it: "How often did I actually follow the committee?"
- Discipline ledger — counterfactual PnL of what the safety rules blocked.
CLI
uvx openinvest status # portfolio + live P&L
uvx openinvest run_committee GC=F # one-shot committee verdict
uvx openinvest decisions --days 90 # decision ledger + adoption rate
uvx openinvest record_execution 2026-07-03/GC=F --rejected --reason "too pricey"
uvx openinvest buy --symbol AAPL --units 10 --price 210 --currency USD
Disclaimer
LLM-driven decision support — not investment advice. LLMs make mistakes and get overconfident. openInvest never auto-trades; its ledger is a local SQLite record with no connection to any brokerage or payment system. Past performance does not predict future returns.
Links
Metadata
Release files for openinvest 0.68.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| openinvest-0.68.2.tar.gz | 768.0 kB | Without provenance | Details for openinvest-0.68.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| openinvest-0.68.2-py3-none-any.whl | Python 3 | none | any | Details for openinvest-0.68.2-py3-none-any.whl |
Total release size: 1.7 MB
Release files / openinvest-0.68.2.tar.gz
| Download URL | openinvest-0.68.2.tar.gz |
|---|---|
| Size | 768.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5af090ed59014c51cb176812fc51e17e0d4d44c6ed925bc7d2b8ecc73610247f
|
|
BLAKE2b-256 checksum How to use checksums |
e39c4be3a91f0c9577e31d99d169b7943aa7431da7beb235b23b011976cdbb1b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / openinvest-0.68.2-py3-none-any.whl
| Download URL | openinvest-0.68.2-py3-none-any.whl |
|---|---|
| Size | 924.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
57cb08e18d2c4d7716bca43e9b06fcfe3ecac99f7e8d732926fa04af41c971e4
|
|
BLAKE2b-256 checksum How to use checksums |
1d8d79dadc8f1071942f7a9f5239dcd980be0edae4311cf342c9967d06438d67
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for openinvest 0.68.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.