File size: 2,061 Bytes
a483eeb 1e0a3c9 a483eeb 1e0a3c9 a483eeb 1e0a3c9 a483eeb 1e0a3c9 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 | ---
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.
|