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-1.0.2.tar.gz (82.9 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-1.0.2-py3-none-any.whl (69.3 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for systemr_cli-1.0.2.tar.gz
Algorithm Hash digest
SHA256 0e041acdd6c4be6c09c398544a802e9b03a75a62778a8c13d5a69fd194e4ecaa
MD5 54cda3bd25e98af52b8dc69a4c81a017
BLAKE2b-256 8fda3d1b9fa5a6a8301c56463cd8a2571e0f499709e857cc07a457a9652c1565

See more details on using hashes here.

File details

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

File metadata

  • Download URL: systemr_cli-1.0.2-py3-none-any.whl
  • Upload date:
  • Size: 69.3 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-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 ad6744e136a159f38d909379c9f5c61245fe1368a9b58b50955f9e57f531202d
MD5 5c7da2951222ae2fa7e52c20779673ac
BLAKE2b-256 cf521e020e8862180918e403d3bf5e12d1a89684c71c261bccfd1b4354799361

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