SDK Installation

This guide shows how to install the Orion SDK locally.

---

1) Clone the Repo

git clone https://github.com/OrionFinanceAI/orion-sdk.git

2) Create a Virtual Env & Install

make venv
source .venv/bin/activate
make install

Check available CLI commands any time:

orion --help

3) Configure Environment

Copy an example and fill in values:

cp .env.sepolia.example .env
# or: cp .env.localhost.example .env

Common variables:

• RPC_URL – Chain RPC endpoint (e.g., Sepolia / L2)
• PRIVATE_KEY – Curator wallet private key (for signing)
• CURATOR_ADDRESS – Curator EOA for fees/ownership
• IPFS_GATEWAY – Optional, for public context downloads

Note: Keep your .env file private.

Dependencies

orion-sdk requires:

lighthouseweb3>=0.1.4,<1.0.0
python-dotenv>=1.1.0,<2.0.0
tenseal>=0.3.16,<1.0.0
numpy>=1.26.0,<2.0.0
typer>=0.16.0,<1.0.0
web3>=7.12.0,<8.0.0
pyarrow>=19.0.1,<20.0.0
pandas>=2.1.0,<2.3.0