Local AI Stock Bot · Hermes engine v1.1.0 · public beta
Three agents.
One hard risk gate.
Credential-free paper trading with a visible Mira → Nova → Vesper decision room. Every proposed order must survive deterministic checks before an optional handoff to Robinhood’s official Agentic Trading MCP.
No account. No checkout. No feature gate. MIT licensed. Optional tips unlock nothing. Optional Pro feed for Mira: public filings + daily brief.
READY FOR PAPER EXECUTION
Representative role simulation using illustrative delayed sample data—not a live agent session, recommendation, or signal.
Optional support
If it helps, fund the next release.
Everything is free—the complete download, source, paper mode, live bridge, and future public updates. No account, license, or locked feature. If the bot saves you time, an optional one-time tip helps fund testing, market-data compatibility, docs, and polish. Skipping it is completely fine.
Tips never unlock features and are not an investment, managed-trading fee, or promise of returns.
The decision architecture
Conversation proposes. Code decides what is allowed.
Three roles keep research, advocacy, and criticism separate. A fourth, deterministic layer enforces the rules no model may negotiate away.
🔎
Mira
Research and evidence
◇
Nova
Exact trade proposal
⚖
Vesper
Adversarial risk review
⛨
Hard gate
Deterministic validation
Fail-closed by design
An approval is not a blank check.
Each decision is short-lived, single-use, and bound to the exact fields Vesper reviewed.
Fresh evidence only
Stale timestamps and expired proposals are rejected before execution.
Exact-order binding
Changing side, symbol, size, order type, limit, or expiry invalidates approval.
Researched universe
Unknown tickers, missing prices, halts, and excessive spreads fail closed.
Portfolio limits
Buying power, duplicate positions, maximum size, and loss budgets are code-enforced.
No phantom fills
A broker acknowledgement stays “submitted” until authoritative account state changes.
Measure the system
Compare one-agent and three-agent paper runs by expectancy, drawdown, turnover, and sample size.
Two modes, one codebase
Learn locally. Connect officially.
The safe default works without brokerage authentication. Live operation adds a user-controlled agent host and Robinhood’s dedicated Agentic account.
Credential-free paper mode
Research, debate, simulate, monitor, and inspect locally before risking capital.
- Public or user-configured market data
- Local JSON portfolio and reports
- Password-protected localhost dashboard
- No Robinhood login accepted
Official Agentic MCP handoff
Your supported agent host connects Robinhood’s MCP and the bot’s local stdio bridge.
- Dedicated Agentic account required
- Fresh account snapshot every five minutes
- Atomic claim and terminal receipt
- Broker order ID required for acceptance
Optional for Pro & Builder
Give Mira real public filings.
The bot is free forever. If you already use Agent Media Tools Pro or Builder, you can plug in an agent key so Mira’s research cycle also sees hosted disclosure intel—the same public SEC and House data on Stock Intelligence.
Pro filing feed for Mira
When AMT_AGENT_KEY is set, each research cycle can include:
- Company insider Form 4 buys/sells
- House member trade disclosures
- Form 144 proposed-sale notices
- Large holders (13D/G) & fund 13F snapshots
- Mira’s plain-English daily take (buy / sell-if-you-own / watch)
Fail-soft · research only
No key? The free bot runs unchanged. Wrong plan or network error? Mira skips the pack and keeps going—paper trading never depends on Pro.
- Create a Pro agent key on your AMT account
- Add
AMT_AGENT_KEY=mt_…to the bot’s private.env - Restart the monitor — look for “AMT Pro key detected”
- Filings are public data for research context, not advice
Stock Intelligence row data and the API are included with Pro and Builder.
From your AMT account / API keys page — starts with mt_.
.envKeep mode 0600. Never commit the key. Optional: AMT_BASE_URL.
Mira loads the pack into her research prompt each cycle.
# private .env (never commit)
AMT_AGENT_KEY=mt_your_pro_key
# AMT_BASE_URL=https://agentmediatools.com
source venv/bin/activate
python -c "from analysis.amt_market_intel import is_configured, mira_context; \
print('configured', is_configured()); print(mira_context(candidates=['AAPL'])[:400])"
./launch_monitor.sh
Not financial advice. Public filings can be late or incomplete. Free paper mode never requires Pro. Browse Stock Intelligence → · Pricing →
Ten-minute paper start
Download it. Inspect it. Run it.
Python 3.10+ recommended. Robinhood credentials never belong in the bot or its .env.
No account or purchase receipt required.
The setup script installs pinned dependencies.
Use the private URL printed by the dashboard to choose an LLM and create your login.
Run tests, initialize paper mode, and inspect decisions before risking capital.
tar -xzf hermes-stock-bot-v1.1.0.tar.gz cd hermes-stock-bot-v1.1.0 ./setup.sh source venv/bin/activate python -m unittest discover -s tests -v ./launch_dashboard.sh # Open the private setup URL printed above. # Then, in a second terminal: python run_paper.py --reset --initial-cash 1000 python run_paper.py --summary ./launch_monitor.sh
The whole package is free
Build evidence before confidence.
Use paper mode, compare the three-agent workflow against a one-agent baseline, and let results—not personality or hype—earn the right to continue.