# Connect your tool: Crackle Check

Crackle Check runs from your own code and agents as well as this page, and the segments it reads are open data you can load yourself, with no account needed for either.

Checked 2026-10-24. Generated from `connect.json` by `kit spaceconnect` in [ChaseHendrick/Scrolls](https://github.com/ChaseHendrick/Scrolls).

## Call Crackle Check from code or an agent

`https://huggingface.co/spaces/SharpMeow/crackle-check`

License: Code Apache 2.0; readers MIT; scans CC BY-NC 4.0. Examples are precomputed; a new region uses ZeroGPU time, so pass Client(..., token=...) to use your own. Model output, not a reading.

### Python /check_example (tested 2026-10-24)

```python
# pip install gradio_client
from gradio_client import Client

client = Client("SharpMeow/crackle-check")
result = client.predict(sample_id="0841-w00", reader="readerv3", api_name="/check_example")
```

### Python /check_segment (tested 2026-10-24)

```python
# pip install gradio_client
from gradio_client import Client

client = Client("SharpMeow/crackle-check")
result = client.predict(segment="PHerc0841/segments/20260220213127-w00", volume="", x=3008, y=2944, size=384, reader="readerv3", api_name="/check_segment")
```

### Python /list_readers (tested 2026-10-24)

```python
# pip install gradio_client
from gradio_client import Client

client = Client("SharpMeow/crackle-check")
result = client.predict(api_name="/list_readers")
```

### curl /check_example (tested 2026-10-24)

```bash
URL=https://sharpmeow-crackle-check.hf.space
EVENT=$(curl -s -X POST $URL/gradio_api/call/check_example -H 'Content-Type: application/json' \
  -d '{"data": ["0841-w00", "readerv3"]}' | python3 -c 'import json,sys; print(json.load(sys.stdin)["event_id"])')
curl -sN $URL/gradio_api/call/check_example/$EVENT
```

### MCP (Claude, Cursor and other agents) (tested 2026-10-24)

```json
{
  "mcpServers": {
    "crackle-check": {
      "url": "https://sharpmeow-crackle-check.hf.space/gradio_api/mcp/sse"
    }
  }
}

Tool list: https://sharpmeow-crackle-check.hf.space/gradio_api/mcp/schema
```

## The layers it reads, example PHerc0841 w00 (9.366 um surface volume)

`https://vesuvius-challenge-open-data.s3.us-east-1.amazonaws.com/PHerc0841/segments/20260220213127-w00/surface-volumes/9.366um-1.2m-113keV-volume-20250821151531.zarr`

License: CC BY-NC 4.0 (Vesuvius Challenge open data). Shape (layers, height, width). Read live from the open data when someone runs a check; nothing is bundled.

### Python (zarr) (tested 2026-10-24)

```python
# pip install "zarr>=3" fsspec aiohttp
import zarr

root = zarr.open_group("https://vesuvius-challenge-open-data.s3.us-east-1.amazonaws.com/PHerc0841/segments/20260220213127-w00/surface-volumes/9.366um-1.2m-113keV-volume-20250821151531.zarr", mode="r")  # OME-Zarr, zarr v2
a = root["0"]  # level 0 is full resolution; level L is 2**L times coarser
print(a.shape, a.dtype, a.chunks)
block = a[0:64, 2800:2864, 2900:2964]  # (z, y, x); reads only the chunks it touches
```

### villa's vesuvius package (tested 2026-10-24)

```python
# pip install "vesuvius[volume-only]"
from vesuvius import Volume

v = Volume(type="zarr", path="https://vesuvius-challenge-open-data.s3.us-east-1.amazonaws.com/PHerc0841/segments/20260220213127-w00/surface-volumes/9.366um-1.2m-113keV-volume-20250821151531.zarr/0")  # one pyramid level
block = v[0:64, 2800:2864, 2900:2964]
```

### curl (tested 2026-10-24)

```bash
curl -s https://vesuvius-challenge-open-data.s3.us-east-1.amazonaws.com/PHerc0841/segments/20260220213127-w00/surface-volumes/9.366um-1.2m-113keV-volume-20250821151531.zarr/.zattrs            # OME multiscales metadata
curl -s https://vesuvius-challenge-open-data.s3.us-east-1.amazonaws.com/PHerc0841/segments/20260220213127-w00/surface-volumes/9.366um-1.2m-113keV-volume-20250821151531.zarr/0/.zarray     # one level: shape, chunks, dtype, codec
```