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.3.3.tar.gz (87.3 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.3.3-py3-none-any.whl (73.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: systemr_cli-2.3.3.tar.gz
  • Upload date:
  • Size: 87.3 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.3.3.tar.gz
Algorithm Hash digest
SHA256 e13d29ba8039d15653fc769fded69217e132d6a55dd20e94fd7b0c8e880eb761
MD5 04ba0b644d3501686006539b0dd80dbc
BLAKE2b-256 7202f0a88ce7c2d5cd06743b55bc09aa0997fdec5d7c212f305de4a77d3066df

See more details on using hashes here.

File details

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

File metadata

  • Download URL: systemr_cli-2.3.3-py3-none-any.whl
  • Upload date:
  • Size: 73.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.3.3-py3-none-any.whl
Algorithm Hash digest
SHA256 89e899f59b081e5a2fb01f311d62d2cd153fa5b0ab9a1da72985eae3710947d7
MD5 47062f9ebce0e7a2c408d4767edf1b1e
BLAKE2b-256 3e864898ee04efe892be981393dfdd14064f94a64fb9fe352e070c903d8da5d3

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