---
title: ColliderML Simulation
emoji: ⚛️
colorFrom: indigo
colorTo: pink
sdk: gradio
sdk_version: 5.50.0
python_version: "3.12"
app_file: app.py
pinned: true
license: apache-2.0
hf_oauth: true
---

# ColliderML Simulation Service

Submit custom ColliderML simulation requests without installing anything
locally. This Space is a thin frontend for the ColliderML backend — it
sends the same payloads that the `colliderml` pip package sends and
returns the same results.

## Usage

1. Click **Sign in with HuggingFace** (you'll get 10 free credits on your first sign-in).
2. Choose a physics channel, number of events, and pileup.
3. Click **Submit**. You'll be given a request ID and an email when the job
   completes.
4. Use the **Chat** tab if you'd rather describe what you need in plain English —
   the Claude-powered agent estimates the compute cost, checks your balance,
   and asks for confirmation before submitting.

## Environment variables

| Variable              | Purpose                                                                                    |
|-----------------------|--------------------------------------------------------------------------------------------|
| `COLLIDERML_BACKEND`  | Backend URL (default: `https://api.colliderml.com`)                                        |
| `ANTHROPIC_API_KEY`   | Required for the Chat tab. Without it the chat tab shows a "not configured" message.       |

## See also

- [Event display](https://huggingface.co/spaces/CERN/colliderml-event-display) — visualise existing datasets
- [Leaderboard](https://huggingface.co/spaces/CERN/colliderml-leaderboard) — benchmarks and credits
- [`colliderml` pip package](https://pypi.org/project/colliderml/) — same capabilities from the CLI
- [Remote simulation guide](https://opendatadetector.github.io/ColliderML/guide/remote-simulation)

## Deployment

Synced automatically from `spaces/simulation-form/` on the
[OpenDataDetector/ColliderML](https://github.com/OpenDataDetector/ColliderML)
repo via the `sync-spaces.yml` workflow.