Quick Start
From a fresh account to your first IC50 in about five minutes
This walks through one full run, end to end: drop a CSV, pick the assay, get a 4PL fit, export a figure. If you have a dose-response file open already, follow along with it.
Sign in
Go to gradiance.io and sign in with Google. The Free tier includes 20 free runs per calendar month (UTC), shared across bioassay and Flow analysis. Required setup answers are included with each run - no card required.
Open the new-run form
Click New run in the sidebar (or hit ⌘ K and pick “New run” from the command palette). You land on a setup page with three things to do, in order: upload a file, pick the assay, and (optionally) type a one-line prompt.
Drop your data
Drag a CSV or Excel file into the upload zone. Multi-file uploads are supported - drop several at once and they get treated as related datasets within the same run. The minimum is two columns: concentration and response, headers in row 1, numeric values below.
Concentration_uM,Viability_Percent 0.001,98.5 0.01,97.2 0.1,89.3 1,56.7 10,15.2 100,3.8
If you have replicates, repeat the row at the same concentration. Including the unit in the column name (_uM, _nM, _Percent) helps the agent label axes correctly without asking. See Uploading data for plate-reader exports and common parse errors.
Pick the assay
The picker opens with the most likely assays at the top - Gradiance inspected the file shape and made a guess. Accept the suggestion, browse the seven categories (Quantification, Potency, Gene Expression, Kinetics, Cell-based, Binding, Custom), or use the search box if you know what you want (“ic50,” “qpcr,” “cfu”).
For 96/384-well exports the plate painteropens automatically so you can label which wells are standards, unknowns, blanks, and controls. For tabular data you can skip straight to submission.
Optional prompt
One sentence is enough - and you can leave it blank. The agent already has the assay and the data shape; the prompt is for anything special:
Use GAPDH as the reference gene.
Variations all work: “Fix bottom to 0,” “Use the Results sheet,” “Concentrations are already log10-transformed.” On the Custom assay, the prompt is what tells the agent what kind of analysis you actually want.
Watch it run
Submit the form and the workspace opens - two side-by-side panels with a resizable divider, plus the agent chat as a slide-in drawer. The left panel shows progress and a step summary; the right panel is the result viewer that fills in as the fit converges. Most runs finish in 20-40 seconds.
Read the result
The viewer shows, in order:
- The fitted curve over your data points
- A parameter table with 95% CIs
- R² and a quality tier (excellent · good · fair · poor)
- Any QC flags worth your attention
- A one-paragraph plain-English interpretation
Read Understanding your results for the full tour. The short version: trust the curve before the number, and check the residuals if R² is below 0.95.
Refine if needed
If something looks off, click Refine and tell the agent in one sentence - each refinement uses one additional run from your shared monthly allowance.
- “Use the supported unweighted 4PL.”
- “Clarify which columns are concentration and response.”
- “Show me the residual plot.”
The Stop button cancels an in-progress run (each refinement request counts as another run against your shared monthly allowance); Duplicate clones the workflow / prompt / plot config into a new draft so you can branch on a model choice; the share icon copies the run URL to your clipboard. See The Run Workspace for the full tour of the controls.
Export
Use the Export menu in the workspace header. Each format is self-contained.
- PNG (300 DPI) - figure for slides or print. Free tier exports include a small watermark.
- SVG - vector for editing in Illustrator or Inkscape. Pro/Team (coming soon).
- PDF report - figure, parameters, method, provenance. Pro/Team (coming soon).
- CSV - fitted values, residuals, and outlier flags. Available on Free.
- Excel - formatted workbook. Pro/Team (coming soon).
- Figure replay (Python) - a saved-fit replay of the observations, curves, parameters, and intervals; it does not refit your original data. Pro/Team (coming soon).
- Audit bundle (JSON) - full provenance: input file hashes, fit parameters, agent steps. Pro/Team (coming soon).