qrisp.interface.Backend.max_circuits

property Backend.max_circuits: int | None

Maximum number of circuits this backend can execute in a single job.

Many hardware backends impose a per-job circuit limit (e.g. a cloud provider may accept at most 300 circuits per submission). Submitting a batch larger than this limit causes an opaque error from the vendor SDK. Exposing the limit here lets Qrisp provide an early, clear ValueError via run() and _check_circuit_limit() before any network call is made.

Concrete backends should override this property and return the actual limit. Implementations of run_async() should also call _check_circuit_limit() before submitting to the hardware so that users who bypass run() still get the same early error.

Returns None if the backend imposes no limit (simulators) or does not expose this information.