Quick start - Signalium

Prerequisites

Tool	Version	Install
Node.js	22+	nodejs.org or `nvm install 22`
pnpm	10+	`curl -fsSL https://get.pnpm.io/install.sh \| sh`
bun	1.3+	`curl -fsSL https://bun.sh/install \| bash`
foundry (only for contract tests)	latest	`curl -L https://foundry.paradigm.xyz \| bash && foundryup`

1. Clone + install

git clone https://github.com/rstfulzz/signalium.git
cd signalium
pnpm install

2. Configure env

cp .env.example .env

Minimum needed to read live mainnet markets:

Var	What it’s for	Where to get it
`OG_NETWORK`	Always `mainnet` — Signalium is mainnet-only (Gimo `StakePool` lives on chain id `16661`)	n/a
`NEXT_PUBLIC_REOWN_PROJECT_ID`	Wallet connection (Reown AppKit)	Free at cloud.reown.com

To create markets locally you also need:

Var	What it’s for
`X_RAPIDAPI_API_KEY`	Pull tweets via twitter241
`OG_COMPUTE_PROVIDER_URL`, `OG_COMPUTE_API_KEY`	DeepSeek V3 inference via 0G Compute
`STORAGE_UPLOADER_PRIVATE_KEY`	Pays for sealing judge prompts to 0G Storage

3. Run the stack

pnpm dev
# api on http://localhost:3001
# web on http://localhost:3000

Open http://localhost:3000, connect a wallet, browse markets. The page loads the same on-chain contracts as production at chainId 16661.

4. (Optional) Run the contract test suite

pnpm --filter @signalium/contracts test
# 138 unit tests, ~3s

# Fork tests against the real Gimo proxy on 0G mainnet
pnpm --filter @signalium/contracts test --fork-url https://evmrpc.0g.ai
# 4 fork tests, ~6s

Next: Architecture

See how the web, API, judge worker, contracts, and subgraph fit together.