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.0.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.0-py3-none-any.whl (78.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: systemr_cli-2.1.0.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.0.tar.gz
Algorithm Hash digest
SHA256 ea9adbe3d66f21971faf76acb5b2dd269d1c94d29a3ed74e2f8acc6300b3aae4
MD5 50f8b80c41f7b0d3005bf8f90d785e54
BLAKE2b-256 3fff812a9cdee15c17949ffd98e26570f4921ce8b0b137b15b9a8866fb1a2723

See more details on using hashes here.

File details

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

File metadata

  • Download URL: systemr_cli-2.1.0-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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6d604da21d91fe1628d84b72530a7628847a8ff16c04b9474866e335d3976e2c
MD5 f3d166ed76e4a4485f01adff9d4d52f6
BLAKE2b-256 d18704e07918c8a1eb54475f968bee22b2edec964e4e048afe7dfbfdc64bf919

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