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.68.10

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.68.10
File Size Uploaded Provenance Actions
openinvest-0.68.10.tar.gz 949.1 kB Without provenance Details for openinvest-0.68.10.tar.gz

Built distribution (wheel)

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

Total release size: 2.1 MB

Release files / openinvest-0.68.10.tar.gz

Download URL openinvest-0.68.10.tar.gz
Size 949.1 kB
Tags Source
SHA-256 checksum
How to use checksums
e308ca3a13aad53e8fe28a3b43054b201816895089285c99689a6f41234605e4
BLAKE2b-256 checksum
How to use checksums
9af8d36c145a69f3924562fa17722cef6f3c0a37ce915083d79096e8dedb2343
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.10-py3-none-any.whl

Download URL openinvest-0.68.10-py3-none-any.whl
Size 1.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums
9bd89c6694afd54ded4f5da045d11628366f630d7ae0aae97f3e8ab7a8939c87
BLAKE2b-256 checksum
How to use checksums
7e4d34531f5edc3e0d703f6a00e883fbf7a9acc32e095ec32c20639b06ee17a4
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.10

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.68.10 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