Documentation · Getting started

From sign-up to your first PASS in five minutes.

cufemlab runs as a hosted SaaS at cufemlab.secrotec.nl. You don't install anything — sign up, claim your free trial credits, submit a job, and read the verdict. This page walks you through the first run.

Free tier. Every new account receives 2 free trial credits. That's two complete analyses on any of the 12 physics domains — no card required.

1. Create an account

Open cufemlab.secrotec.nl and click Sign up. You'll need:

  • A work email address
  • A password (10 characters minimum — Argon2id-hashed server-side)
  • Your full name (for the analysis report header)

The signup endpoint creates your account, hashes your password with Argon2id, appends 2 trial credits to your ledger, and signs you in. You'll land on the dashboard.

2. Tour the dashboard

The dashboard shows three things at a glance:

  • Credit balance. Reserved + available. Each analysis reserves credits up-front; on success they commit, on failure they refund.
  • Recent jobs. Status (queued, running, completed, failed), domain, runtime, verdict.
  • Profile. Email, role (user / admin), API keys.

3. Submit your first analysis

Click New analysis. Pick:

  • Domain — magnetics, thermal, mechanics, fluids, electrochemistry, acoustic, plasma, chemistry, optimization, UQ, porous, or an integrated workflow (motor / battery / cooling).
  • Project — optional grouping; auto-created if you skip it.
  • Inputs — typed parameters (current, geometry, material choice) OR an uploaded YAML / JSON spec. See the examples page for ready-to-clone inputs.

Submit. The job enters the Redis priority queue and a worker container picks it up on the next poll. Most v0.3.0 analyses complete in under 30 seconds on our RTX-class hardware.

4. Read the verdict

Each completed job returns:

  • Verdict: PASS, GPU_PASS, PARTIAL, or NOT_IMPLEMENTED (with a roadmap pointer).
  • Cited reference — the published benchmark this domain validates against (e.g. Wang 2018 IEEE TIA for motor magnetics).
  • Declared tolerance and measured error — both required for PASS.
  • Provenance hash — SHA-256 of inputs + code + materials, so you (or an auditor) can re-run and confirm bit-for-bit.
  • Numeric outputs — flux density, peak stress, temperature field, Sobol indices, whatever the domain produces.
  • Downloadable bundle — PDF + JSON + Markdown report.

5. Use the API (optional)

Every browser action has a REST equivalent. Generate an API key from app / api_keys, then:

POST /api/v1/jobsbash
curl -X POST https://app.cufemlab.secrotec.nl/api/v1/jobs \
  -H "Authorization: Bearer cfm_YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "analysis_type": "magnetics_integrated",
    "input_params": {
      "stator_od": 0.20,
      "current_a": 12.0,
      "slot_temp_k": 393
    }
  }'

Returns { "job_id": "uuid", "status": "QUEUED", "credits_reserved": 1 }. Poll GET /api/v1/jobs/{id} until status is COMPLETED, then GET /api/v1/jobs/{id}/result for the full bundle.

6. Top up credits

When the 2 free credits run out, go to app / credits and pick a plan:

  • Starter — €49 / 100 credits
  • Pro — €199 / 500 credits
  • Business — €799 / 2 500 credits

Checkout is via Stripe. Credits are non-expiring; the ledger is idempotent and audit-friendly (every grant has a Stripe event ID, every consumption has a job ID).

Next steps

Need help?

Stuck on signup, lost your password, or got a NOT_IMPLEMENTED verdict you didn't expect? Write to info@secrotec.nl with your account email and the job ID (if applicable). We aim to reply within one business day.

For commercial enquiries (custom benchmarks, on-prem deployment, multi-month engagements), see pilot tiers or write to ebaturan@gmail.com.