CLI Reference

Every command available in the spore CLI.

spore set <provider> <key>

Configure an LLM provider for the experiment agent. Supported providers: groq, anthropic, openai, xai.

$ spore set anthropic <your-api-key>

Run node in foreground (Ctrl+C to stop). Connects to configured peers and starts the experiment loop.

Flag	Default	Description
--bootstrap	—	Full setup: copy bundled train.py and prepare.py, download data, connect to bootstrap peer, sync graph, start loop.
--resource	100	Limit resource usage to N% (1-100). Scales training batch size.
--no-train	—	Run as sync-only node (no experiments).

$ spore run --bootstrap

Run node as a background daemon.

Flag	Default	Description
--port, -p	7470	Listen port for gossip
--peer	—	Peer address (host:port). Can be specified multiple times.

$ spore start --port 7470 --peer 192.168.1.100:7470

Stop the background daemon.

Show experiment count, frontier, and recent activity.

Show node identity, port, and peer count.

Launch the web UI — D3.js DAG visualization, live feed, frontier table, and reputation leaderboard.

Show research DAG as ASCII tree.

Flag	Default	Description
--depth, -d	50	Maximum depth to render

Show best unbeaten experiments.

Flag	Default	Description
--gpu, -g	—	Filter by GPU class

Add a peer.

$ spore connect 192.168.1.10:7470

Remove a peer.

$ spore disconnect 192.168.1.10:7470

List configured peer.

Show daemon log.

Flag	Default	Description
-f	—	Follow log output

Remove all Spore data.

Flag	Default	Description
--all	—	Also remove cached data

Explicitly initialize the node. Not usually needed — every command auto-initializes if the node hasn't been set up yet.

Show version.