Installation

Prerequisites

• Node.js 22.13+
• Git
• Foundry (forge, cast, anvil)
• Python 3.11+ (oracle scoring / connectors)
• Docker (optional, for Kafka and local dependencies)

Install Foundry

curl -L https://foundry.paradigm.xyz | bash
foundryup
forge --version

Clone & workspace layout

git clone <your-ukiyo-monorepo>
cd ukiyo

# typical packages (names may vary by release)
packages/
  contracts/     # Solidity + Foundry
  oracle/        # ingestion + scorer
  agency/        # agent runtime + policy tooling
  sdk/           # TypeScript consumer SDK

Contracts

cd packages/contracts
forge install
forge build

Oracle (Python)

cd packages/oracle
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -r requirements.txt

Agency / SDK (Node)

cd packages/agency && npm install
cd ../sdk && npm install