File size: 1,596 Bytes
caabe1a f28409b caabe1a f28409b caabe1a f28409b caabe1a f28409b | 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 52 | ---
title: CERNenv
emoji: ⚛️
colorFrom: blue
colorTo: indigo
sdk: docker
suggested_hardware: cpu-basic
pinned: false
license: bsd-3-clause
short_description: LHC particle-discovery RL environment
---
# CERNenv — LHC Discovery RL Environment
OpenEnv-compatible reinforcement-learning environment that simulates an
LHC (Large Hadron Collider) analysis. An LLM (Large Language Model) agent
configures the beam, allocates luminosity, picks a decay channel and
trigger, runs reconstruction, fits an invariant-mass spectrum, estimates
significance, and finally submits a structured discovery claim that is
graded against a hidden ground-truth particle.
The Space exposes the standard OpenEnv HTTP + WebSocket API:
* `GET /health` — liveness
* `GET /schema` — action / observation / state JSON schemas
* `POST /reset` — start a new episode (`{ "seed": 7, "scenario": "easy_diphoton_160" }`)
* `POST /step` — execute one action
* `GET /state` — current `CernState`
* `WS /ws` — persistent session (recommended for multi-step rollouts)
## Quickstart (Python client)
```python
import asyncio
from openenv.core import EnvClient
from huggingface_hub import constants
# replace with your space id
SPACE = "YOUR_HF_USERNAME/cernenv"
# (option A) connect to the running Space directly
import websockets
async def main():
async with EnvClient.from_env(SPACE) as env: # uses websockets under the hood
result = await env.reset(seed=7, scenario="easy_diphoton_160")
...
asyncio.run(main())
```
For training, see the companion **CERNenv Trainer** Space.
|