Skip to main content

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

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 yfinance symbol (equities, ETFs, crypto, commodities, any currency). Two execution paths: Coordinator (your agent plays the roles — no API key) or Direct (backend LLM, needs DEEPSEEK_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.

Metadata

Release files for openinvest 0.66.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for openinvest 0.66.0
File Size Uploaded Provenance Actions
openinvest-0.66.0.tar.gz 709.1 kB Without provenance Details for openinvest-0.66.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for openinvest 0.66.0
File Interpreter ABI Platform Actions
openinvest-0.66.0-py3-none-any.whl Python 3 none any Details for openinvest-0.66.0-py3-none-any.whl

Total release size: 1.6 MB

Release files / openinvest-0.66.0.tar.gz

Download URL openinvest-0.66.0.tar.gz
Size 709.1 kB
Tags Source
SHA-256 checksum
How to use checksums
d55ea4dddcc07aec9b563bccee7bbac4b0682713c1e012f6f3029606dbeadf46
BLAKE2b-256 checksum
How to use checksums
a4fab3d6a3a06c4e65c9fead9291bc7cd95074b424369e5ece712d978c5979f0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.4 {"installer":{"name":"uv","version":"0.13.4","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.66.0-py3-none-any.whl

Download URL openinvest-0.66.0-py3-none-any.whl
Size 857.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
81737b9db541a0b529b2caebb8ba8cfc85ee968bbb598e9ea2dc78ccb1ab87c2
BLAKE2b-256 checksum
How to use checksums
f8a8c796aa2c8098143cfa1dae85dac408e8da2aaa1d156021ea9fe0d6c2e215
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.4 {"installer":{"name":"uv","version":"0.13.4","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.66.0

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.

Release history Release notifications | RSS feed

This release

0.66.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page