Install guide
SpiderCaster needs Python 3.11 or newer and nothing else. It uses the standard library only, so there is nothing extra to install.
One-command install
The installer downloads the build, checks its SHA-256 checksum, installs it, and runs the doctor.
macOS and Linux
curl -fsSL https://mdata.tokenctr.com/spidercaster/install.sh | sh
Windows PowerShell
irm https://mdata.tokenctr.com/spidercaster/install.ps1 | iex
Install folder
~/.local/share/spidercaster on macOS and Linux, or %LOCALAPPDATA%\SpiderCaster on Windows. Set SPIDERCASTER_INSTALL_DIR to choose another folder on macOS and Linux.
A bad download
If the checksum does not match, the installer stops and nothing is installed.
From the source code
Clone the repository and run the doctor from the folder. No install step is needed.
Clone
git clone https://github.com/SpiderCaster/COSMOS-SC.git
Enter the folder
cd COSMOS-SC
Check the setup
python spidercaster.py doctor
As a command
pip install . adds the spidercaster command. Set SPIDERCASTER_HOME to the folder when you run it from somewhere else.
Check the setup
The doctor prints one JSON report and changes nothing. "ok": true means the molds, frames, seats, and hands line up.
python
The Python version that ran the doctor.
molds and frames
The molds and section frames the package ships. Version 0.1.0 reports 4 molds and 14 frames.
seats
The seven seats, each with its skill and wrapper.
hands_match
True when every seat's hands are present.
What the doctor prints
Real output from version 0.1.0. The doctor reads the package and changes nothing.
$ python spidercaster.py doctor | python -m json.tool
{
"python": "3.13.5",
"root": "/tmp/spidercaster-docs-run/spidercaster",
"molds": [
"clarify-mix",
"discover-grid",
"spidercaster-com",
"warmth-authority"
],
"frames": 14,
"seats": [
{
"id": "architect",
"skill": true,
"wrapper": true
},
{
"id": "content",
"skill": true,
"wrapper": true
},
{
"id": "frontend",
"skill": true,
"wrapper": true
},
{
"id": "graphics",
"skill": true,
"wrapper": true
},
{
"id": "visual",
"skill": true,
"wrapper": true
},
{
"id": "seo",
"skill": true,
"wrapper": true
},
{
"id": "deployer",
"skill": true,
"wrapper": true
}
],
"hands_match": true,
"vault_exists": false,
"ok": true,
"errors": []
}Exit code: 0
$ python spidercaster.py start --dry-run
start --dry-run (no writes, no server, no browser):
1. doctor gate (python, molds, frames, seats, hands)
2. ensure offline demo site from project 'demo-local' (0 tokens)
3. serve studio desk on http://127.0.0.1:4180/ and open browser
live agent: desk rooms (plan/check/preview/crew) + `spidercaster.py ui`
doctor okExit code: 0
First run
The start command runs the doctor, builds the demo site at zero tokens, and opens the studio desk in your browser.
Start
python spidercaster.py start
Rehearse
python spidercaster.py start --dry-run prints the steps and runs the doctor only. No writes, no server, no browser.
No browser
python spidercaster.py start --no-browser serves the desk but does not open the browser.
Another port
python spidercaster.py start --port followed by a port number.