Skip to main content

System R AI — trading operating system for agents

Project description

System R CLI

Trading operating system in your terminal. Like Claude Code, but for trading.

Type natural language. System R runs the full stack — 55 institutional-grade tools, 25 broker adapters, risk engine, G-Score — all from your terminal.

Install

pip install systemr-cli

Or from source:

git clone https://github.com/System-R-AI/systemr-neo.git
cd systemr-neo
pip install -e .

Requires Python 3.11+.

Quick Start

# Set up your profile
systemr setup

# Connect to System R
systemr login

# Start chatting
systemr chat

That's it. Type in plain English:

you > buy TSLA 2% risk

System R will size the position, check risk, show you the trade card, and ask for confirmation before executing.

Commands

Trading

Command Description
systemr chat Interactive conversation with System R
systemr size Position sizing (G-formula)
systemr risk Pre-trade risk validation
systemr eval System performance analysis (G-Score)
systemr scan Market scanner
systemr plan Trade planning

Local

Command Description
systemr journal Trade journal (add/list/show/edit/export)
systemr cron Scheduled tasks (add/list/remove/run)
systemr doctor Health check and diagnostics
systemr setup Profile and rules wizard

Auth

Command Description
systemr login Connect to System R
systemr logout Disconnect
systemr whoami Show current session

Chat Commands

Inside systemr chat, use slash commands:

Command Action
/morning Morning briefing (4 parallel agents)
/eod End of day review + journal
/plan Plan today's trades
/portfolio Show open positions
/risk Risk dashboard
/memory <query> Search past memories
/sessions List recent sessions
/cron Manage scheduled tasks
/permissions View/switch safety profile
/remember <text> Save a memory
/model <name> Switch LLM model
/credits Session credit usage
/help All commands

Safety

Three-tier confirmation protocol:

  • AUTO — Read-only actions (quotes, analysis, calculations)
  • CONFIRM — Trade actions (place/cancel/modify order) — show details, y/n
  • DOUBLE_CONFIRM — Destructive actions (kill switch) — type "KILL"

Permission profiles: paper (max safety), standard (default), experienced (relaxed stops).

Architecture

~/.systemr/
  PROFILE.md          # Trader identity, risk params
  RULES.md            # Hard/soft rules + standing orders
  auth.json           # API credentials (chmod 600)
  config.json         # Settings, model config
  journal.db          # SQLite trade journal
  memory/
    MEMORY.md         # Index
    YYYY-MM-DD.md     # Daily trading logs
    *.md              # Lessons, notes, violations
  sessions/
    last_session.json # Resume state
  cron/
    jobs.json         # Scheduled tasks
    runs/             # Run history (JSONL)

All data stays on your machine. The backend (agents.systemr.ai) processes requests — your profile, rules, and journal never leave your disk.

Backend

System R CLI connects to agents.systemr.ai:

  • 55 MCP tools (sizing, risk, intelligence, planning, behavioral)
  • 25 broker/exchange adapters
  • 187 domain services
  • Per-agent encryption (AES-128-CBC)
  • Multi-model LLM via AWS Bedrock (Claude, GPT, Nova)
  • Compute credit billing (USDC, SOL, OSR)

Development

git clone https://github.com/System-R-AI/systemr-neo.git
cd systemr-neo
pip install -e ".[dev]"
pytest

Rules

  • Decimal for all money — never float
  • structlog only — zero print()
  • Additive-only — never remove/rename
  • Tests for every module

Stats

  • 33 source files, ~8,800 lines
  • 206 tests passing
  • Zero bare print() statements
  • Python 3.11+

Links

Built by Ashim Nandi and Shannon at System R AI.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

systemr_cli-2.1.1.tar.gz (91.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

systemr_cli-2.1.1-py3-none-any.whl (78.6 kB view details)

Uploaded Python 3

File details

Details for the file systemr_cli-2.1.1.tar.gz.

File metadata

  • Download URL: systemr_cli-2.1.1.tar.gz
  • Upload date:
  • Size: 91.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for systemr_cli-2.1.1.tar.gz
Algorithm Hash digest
SHA256 d36dbf808e0056908c3236a37af8c65ff5945bed901aaa1230b7c5e19e4ac218
MD5 4e5b0c2f4c43de50802c79c0104130a3
BLAKE2b-256 280a8f192b1a6096dd2c5bb7956c6b8270b6c89f28ba77e6696cd3b01c6d1caa

See more details on using hashes here.

File details

Details for the file systemr_cli-2.1.1-py3-none-any.whl.

File metadata

  • Download URL: systemr_cli-2.1.1-py3-none-any.whl
  • Upload date:
  • Size: 78.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for systemr_cli-2.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 65bf21de3beef7fb96df370e52539622c8402fe0b1a3e58a87d4a28e05c20d57
MD5 2bd934ef811a001a2cc200595badb54f
BLAKE2b-256 f2d9a15c392ca543f8c97af3acee10074ea267df45fabffa8502f9908c633f60

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page