Autonomous Investment Swarm¶

Risk-gated autonomous trading with multi-agent orchestration.

AIS coordinates specialist strategy agents through a governed execution pipeline where every order requires cryptographic risk approval before submission. The system fails closed — not open.

Risk-Gated Execution¶

Every order requires an HMAC-signed approval token from the risk engine. No token, no trade. The system fails closed.

Multi-Agent Orchestration¶

Multiple strategy agents compete to generate signals. Weighted arbitration selects the best signal based on confidence, return, and liquidity.

Mandate Governance¶

Strategies operate within explicit mandates that cap allocation, restrict instruments, and enforce position limits.

Multi-Exchange¶

Route orders across Aster DEX, Binance, Coinbase, Bybit, and Interactive Brokers through a unified exchange abstraction.

Three Execution Modes¶

Paper (simulated), Shadow (read-only), and Live (gated). The same pipeline runs in all modes — what you test is what you deploy.

Full Observability¶

Prometheus metrics, Grafana dashboards, Alertmanager integration, structured JSON logging, and position reconciliation.

Quick Start¶

# Clone and install
git clone https://github.com/kmshihab7878/Autonomous-Investment-Swarm.git
cd Autonomous-Investment-Swarm
pip install -e ".[dev]"

# Configure
cp .env.example .env
# Set AIS_RISK_HMAC_SECRET at minimum

# Run in paper mode
python -m aiswarm --mode paper

Get Started Architecture API Reference

How It Works¶

graph LR
    D[Market Data] --> A1[Strategy Agent 1]
    D --> A2[Strategy Agent 2]
    A1 --> ARB[Arbitration]
    A2 --> ARB
    ARB --> PA[Portfolio Allocator]
    PA --> RE[Risk Engine]
    RE -->|HMAC Token| OMS[Order Management]
    OMS --> EX[Exchange]
    EX --> MON[Monitoring]
    style RE fill:#e8eaf6,stroke:#5e35b1,stroke-width:2px

What Makes AIS Different¶

Feature	AIS	Typical Trading Bots
Risk validation	HMAC-signed approval tokens, fail-closed	Basic stop-loss
Agent architecture	Multi-agent with weighted arbitration	Single strategy
Governance	Mandate system with allocation caps	None
Execution safety	3 modes sharing same pipeline	Live-only or separate codepaths
Observability	Prometheus + Grafana + reconciliation	Log files
Exchange support	5 exchanges, unified abstraction	1-2, hardcoded
Audit trail	Append-only event store + decision log	None

License¶

Apache License 2.0. See LICENSE.