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.

doctor output
$ 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

start output
$ 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 ok

Exit 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.