Skip to content

System-R-AI/systemr-python

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

systemr

Python SDK for the System R AI API Toolkit.

System R AI is a decision intelligence system for trading and investing. The API Toolkit gives developers access to finance tools for agents, Python workflows, notebooks, and backend services.

The SDK is designed for structured decision-support workflows: position sizing, risk checks, performance diagnostics, market structure analysis, journal records, memory search, and tool discovery.

System R is software for decision support. It is not financial advice, not a broker, not a signal service, and not a guarantee of profits.

PyPI Python 3.9+ License: MIT

Install

pip install systemr

Requires Python 3.9 or higher.

Quick example

from systemr import SystemRClient

client = SystemRClient(api_key="sr_agent_...")

gate = client.pre_trade_gate(
    symbol="AAPL",
    direction="long",
    entry_price="185.50",
    stop_price="180.00",
    equity="100000",
)

print(gate)

pre_trade_gate combines position sizing, risk validation, and supplied system-health context into a single decision-support response.

Chat workflows

from systemr import SystemRClient

client = SystemRClient(api_key="sr_agent_...")

resp = client.chat(
    "Review these R-multiples and tell me what changed in the system: 1.5, -1.0, 2.0, -0.5, 1.8"
)

print(resp["text"])

LLM-backed workflows may use credits depending on the live billing rules. Check the live pricing and billing surfaces before building production workflows.

Tool access

Every current tool should be discovered from the live catalog before use:

tools = client.list_tools()

Generic tool calls:

result = client.call_tool(
    "calculate_position_size",
    equity="100000",
    entry_price="185.50",
    stop_price="180.00",
    direction="long",
)

Common tool areas include:

  • Risk and sizing
  • Performance diagnostics
  • Market structure analytics
  • Scenario planning
  • Journal and memory workflows
  • Asset or research context where supported or supplied
  • Billing and usage visibility where enabled

MCP and REST

The same API Toolkit can be used through MCP-compatible clients and REST integrations.

Pricing

System R AI uses usage-based credits for paid workflows. Current rates and billing rules should be checked through the live pricing endpoint and the System R billing page.

Do not assume every tool, data path, or LLM-backed workflow has the same pricing behavior. Use live discovery and billing responses as the source of truth.

Trust boundary

System R is software for decision support. Users remain responsible for their own trading and investing decisions. AI outputs can be wrong.

System R is not:

  • Financial advice
  • A broker
  • A signal service
  • A guarantee of profit
  • A substitute for trader judgment

Links