NeqSim 3.27.0

What is NeqSim?

NeqSim is an open-source Java library for thermodynamic fluid properties, phase equilibrium, PVT calculations, and process simulation. It is used to model fluids and process equipment such as separators, compressors, heat exchangers, pipelines, wells, and complete flowsheets.

This release ships both the core NeqSim simulation engine and the MCP server distribution that lets MCP-compatible AI clients call governed NeqSim calculation tools.

What is included in this release

Distribution	Asset	Runtime	Use this when
NeqSim core library	neqsim-3.27.0.jar	Java 17+	You need Java 17 or Python neqsim-python compatibility.
NeqSim core library	neqsim-3.27.0-Java8.jar	Java 8+	You need Java 8 or Python neqsim-python compatibility.
NeqSim MCP server	neqsim-mcp-server-3.27.0-runner.jar	Java 21+	You want VS Code Copilot, Claude Desktop, Cursor, or another MCP client to use NeqSim tools.
NeqSim MCP server checksum	neqsim-mcp-server-3.27.0-runner.jar.sha256	-	You want to verify the downloaded MCP runner jar.
NeqSim MCP server container	ghcr.io/equinor/neqsim-mcp-server:3.27.0	Docker	You want to run the MCP server without installing Java locally.

Install the MCP server

The MCP server gives MCP-compatible LLM clients access to validated thermodynamic and process simulation tools through a governed tool interface.

Jar install (requires Java 21+)

VERSION=3.27.0
curl -fLO "https://github.com/equinor/neqsim/releases/download/v${VERSION}/neqsim-mcp-server-${VERSION}-runner.jar"
curl -fLO "https://github.com/equinor/neqsim/releases/download/v${VERSION}/neqsim-mcp-server-${VERSION}-runner.jar.sha256"
sha256sum -c neqsim-mcp-server-${VERSION}-runner.jar.sha256

Docker install

docker pull ghcr.io/equinor/neqsim-mcp-server:3.27.0

Claude Desktop example

{
  "mcpServers": {
    "neqsim": {
      "command": "java",
      "args": ["-jar", "/path/to/neqsim-mcp-server-3.27.0-runner.jar"]
    }
  }
}

See the MCP Server README for VS Code Copilot, Cursor, Docker, Streamable HTTP, and deployment-profile configuration.

Use the core Java library

Use the release assets above when you need standalone jars. For Maven projects, use the published package dependency:

<dependency>
  <groupId>com.equinor.neqsim</groupId>
  <artifactId>neqsim</artifactId>
  <version>3.27.0</version>
</dependency>

Release notes

GitHub-generated release notes are included with this release and list the commits and pull requests since the previous version.

What's Changed

• chore(agents): route paperlab and dynamic-equipment, fix release-skill triggers by @EvenSol in #4473
• feat(optimization): refine envelope feasibility boundaries by @EvenSol in #4474
• [AI-Assisted] feat(refinery): aggregate reforming feed cuts by @EvenSol in #4471
• [AI-Assisted] fix(well): preserve layered definitions through deep copies by @EvenSol in #4475
• refact: wrap apache commons math as a linearalgebra implementer by @asmfstatoil in #4467
• [AI-Assisted] test(thermo): retain measured-state hydrate partition by @EvenSol in #4477
• [AI-Assisted] docs: repair repository examples navigation (D204) by @EvenSol in #4480
• Docs/echo 3d equipment visuals by @EvenSol in #4476
• [AI-Assisted] feat(refinery): allocate reformer hydrogen recovery by @EvenSol in #4479
• [AI-Assisted] feat(refinery): add hydrocracking yield and hydrogen supply balance by @EvenSol in #4486
• [AI-Assisted] fix(process): reject unsupported produced-water interaction tuning by @EvenSol in #4485
• feat(refinery): add FCC yield and coke regenerator balance by @EvenSol in #4488
• fix(olga): correct three-phase RS, standard ratios and bubble curves by @EvenSol in #4484
• fix(refinery): close FCC dry-gas molar balance by @EvenSol in #4492
• feat(refinery): add delayed-coking screening balances by @EvenSol in #4493
• docs: repair focused Maven test selectors (D205) by @EvenSol in #4494
• Feature/labyrinth seal flow by @AndreasHNyhus in #4487
• docs(refinery): reconcile campaign capability inventory by @EvenSol in #4495
• feat(optimization): report refined boundary headroom by @EvenSol in #4489
• [AI-Assisted] feat(well): add explicit liquid mass injectivity by @EvenSol in #4490
• feat(refinery): connect Big Hill atmospheric and vacuum fractionation by @EvenSol in #4498
• docs: repair labyrinth guide rendering contract (D206) by @EvenSol in #4500
• feat(refinery): screen connected Big Hill vacuum operation by @EvenSol in #4501
• feat: process-study-report skill, agent and neqsim process-report command by @EvenSol in #4503
• fix: validate interfacial tension models and reject incomplete profiles by @EvenSol in #4499
• docs: repair refinery guide rendering contract (D207) by @EvenSol in #4504
• feat(optimization): rank cross-slice constraint evidence by @EvenSol in #4505
• [AI-Assisted] fix(injection): correct multi-zone injectivity units by @EvenSol in #4506
• perf: reduce interfacial-tension validation overhead by @EvenSol in #4507
• docs: enforce recursive landing-page title ownership (D208) by @EvenSol in #4508
• [AI-Assisted] fix(tpflash): conserve multiphase roots and amounts by @EvenSol in #4502
• docs: repair hydrate examples and API contract (D209) by @EvenSol in #4510
• feat(optimization): compare lifecycle constraint identities by @EvenSol in #4511
• Skill process study report by @EvenSol in #4513
• feat(injection): make multi-zone water PVT basis explicit by @EvenSol in #4512
• fix(process): JSON export of column outlets/feeds and recycle inlets; connectivity audit for process-report by @EvenSol in #4514
• docs: repair process observability examples (D210) by @EvenSol in #4515
• fix(cpa): populate second-temperature site derivative by @EvenSol in #4516
• docs: repair ESD pressure monitoring guide by @EvenSol in #4517
• fix(cpa): expose higher volume site derivatives by @EvenSol in #4521
• feat(report): render lifecycle operating-envelope evidence by @EvenSol in #4519
• Add VFP lift curve builder, deviated tubing survey and VLP provider API by @EvenSol in #4520
• TwoFluidPipe transient: boundary-face pressure traction, outlet-face placement, physical wall film split by @EvenSol in #4522
• docs(flow-assurance): repair erosion prediction guide by @EvenSol in #4524
• test(cpa): accept finite zero site curvature by @EvenSol in #4523
• [AI-Assisted] fix(pipeline): stabilize and conserve two-fluid wall heat exchange by @EvenSol in #4525
• fix(thermo): recycle removed phase storage safely by @EvenSol in #4526
• fix(pipeline): correct two-fluid transient pressure, force and thermal stability by @EvenSol in #4527
• docs(emissions): repair Norwegian methods comparison by @EvenSol in #4529
• feat(living): promote guarded lifecycle evidence by @EvenSol in #4530
• fix(injection): solve active multi-zone allocation by @EvenSol in #4531
• feat(oilquality): add RVP_ASTM_D6377_ADD_WATER_SATURATED (dry EOS VPCR4 + IAPWS-IF97 water Psat) and BIP-safe water-free basis by @dupuypablo in #4532
• docs(statistics): repair data smoothing guide by @EvenSol in #4536
• fix(thermo): restore phase-removal flash regressions by @EvenSol in #4533
• feat(injection): add opt-in pure-water PVT evidence by @EvenSol in #4538
• docs(standards): execute ASTM D6377 guide by @EvenSol in #4539
• feat(optimizer): bridge lifecycle evidence to living tasks by @EvenSol in #4537
• fix(deps): upgrade Pillow to 13 and require Python 3.11 by @EvenSol in #4542
• test(docs): protect standards landing-page routes by @EvenSol in #4545
• feat(injection): couple live radial-Darcy water injectivity by @EvenSol in #4557
• feat(optimization): validate ten-well living workflow by @EvenSol in #4546
• Reject invalid Pedersen heavy-TBP estimates and fix SRK m inversion by @EvenSol in #4540
• [AI-Assisted] fix(thermo): converge water dew point to fugacity equilibrium by @EvenSol in #4558
• fix(corrosion): clear stale exposure when replacing fluid by @EvenSol in #4560
• fix(transport): isolate PFCT state during parallel pipe runs by @EvenSol in #4562
• Expose phase-named oil density and viscosity in CCE by @EvenSol in #4556
• feat(thermo): support persistent opt-in PR OmegaB overrides by @EvenSol in #4563
• Fix isothermal swelling volumes and document reservoir-fluid qualification by @EvenSol in #4569
• fix(pvt): reject unsupported regression targets by @EvenSol in #4570
• fix(pipeline): calibrate slug-unit slip and front-mixing loss to a reference base model on a subsea sweep by @EvenSol in #4541
• [AI-Assisted] fix(thermo): Component.getCpD() returns the stored coefficient by @rqms40 in #4568
• fix(transport): align Chung and CO2 models; add Letsou–Stiel viscosity by @EvenSol in #4572
• feat(ai): source-backed discovery and reservoir-to-products modeling workflows by @EvenSol in #4578
• fix(characterization): preserve Pedersen plus-fraction mass by @EvenSol in #4559
• docs(thermo): execute Huron-Vidal NRTL guide by @EvenSol in #4574
• fix(thermo): reconcile latent-heat getters and pipeline fallback units by @EvenSol in #4581
• feat(optimization): bind lifecycle objective metadata by @EvenSol in #4582
• test(optimization): revalidate lifecycle limit changes by @EvenSol in #4585
• docs(process): execute PFR worked examples by @EvenSol in #4588
• Feature/class a deliverables from process by @EvenSol in #4589
• Check each declared task output separately; gate-package guidance in skills by @EvenSol in #4590
• Add BrazilSpecialParticipation (Decreto 2.705/1998 statutory SP) by @EvenSol in #4586
• Feature/class a deliverables from process by @EvenSol in #4591
• feat: flow-assurance study report toolkit, agent and skill by @EvenSol in #4592
• test(thermo): diagnose KCl CO2 hydrate inputs by @EvenSol in #4580
• fix: flow-assurance report single-flowline support and data-driven narrative by @EvenSol in #4593
• feat(devtools): SURF design study workflow (neqsim surf-study) by @EvenSol in #4604
• fix(devtools): keep hand-written work-record narratives that contain … by @EvenSol in #4601
• Fix black-oil conversion and PVTO export for near-critical volatile oils by @EvenSol in #4594
• test(thermo): extend salt-free CO2 temperature baseline by @EvenSol in #4600
• feat(pvt): add PVT characterization studies, reports and verified E300 handover by @EvenSol in #4602
• docs(safety): make alarm examples executable and explicit about scope by @EvenSol in #4605
• feat(thermo): add Watson reference-state latent-heat estimation by @EvenSol in #4606
• feat(optimization): bind lifecycle capacity coverage by @EvenSol in #4607
• [AI-Assisted] fix(pipeline): transport newly appearing phases within source budgets by @EvenSol in #4608
• fix(network): conserve elevation energy on generic SURF edges by @EvenSol in #4610
• Add checked onshore and offshore plant layout studies by @EvenSol in #4613
• [AI-Assisted] fix(pipeline): recover transient P/T from conservative energy by @EvenSol in #4611
• [AI-Assisted] fix(pvt): preserve complete CVD/DLE regression histories by @EvenSol in #4609
• Add process utilities design report agent and skill by @EvenSol in #4612
• [AI-Assisted] fix(thermo): qualify SRK/PR Huron–Vidal consistency and derivatives by @EvenSol in #4577
• build(deps-dev): bump org.apache.maven.plugins:maven-surefire-plugin from 3.6.0 to 3.6.1 by @dependabot[bot] in #4614
• build(deps): bump org.apache.maven:apache-maven from 3.9.16 to 3.10.0 by @dependabot[bot] in #4615
• build(deps): bump com.fasterxml.jackson.core:jackson-databind from 2.22.3 to 2.22.4 by @dependabot[bot] in #4617
• build(deps-dev): bump org.apache.maven.plugins:maven-failsafe-plugin from 3.6.0 to 3.6.1 by @dependabot[bot] in #4618
• build(deps): bump com.fasterxml.jackson.dataformat:jackson-dataformat-yaml from 2.22.3 to 2.22.4 by @dependabot[bot] in #4616
• build(deps): bump astral-sh/setup-uv from 10.3.0 to 10.3.2 by @dependabot[bot] in #4619
• Fix PVT regression sample weighting and CVD pressure configuration by @EvenSol in #4621
• test(thermo): qualify ideal-gas caloric properties against NIST by @EvenSol in #4622
• docs: make De Boer screening guide executable and bounded by @EvenSol in #4623
• feat(optimizer): cover accepted plant constraints by @EvenSol in #4624
• feat(network): hand off steady two-fluid state to conservative transients by @EvenSol in #4625
• fix(agents): repair master metadata validation failures by @EvenSol in #4626
• docs: modernize well stabilization example APIs by @EvenSol in #4627
• docs: route well-document evidence requests to enterprise-welldb-agent by @EvenSol in #4631
• Improve plugin-only session bootstrap by @EvenSol in #4635
• fix(flash): stop PH flash Newton iteration on residual stall by @AndreasHNyhus in #4629
• Keep other plugins' skills known in --only plugin builds by @EvenSol in #4639
• fix(plugin): strict frontmatter check, repo link rewriting, private deps, serialized installs by @EvenSol in #4642
• fix(plugin): make reports and tools work from a plugin-only install by @EvenSol in #4643
• fix(serialization): load .neqsim files from older NeqSim versions correctly by @AndreasHNyhus in #4630
• fix: modernize PR-CPA and restore CPA caloric consistency by @EvenSol in #4637
• [AI-Assisted] test(thermo): preserve measured MEG HV assessment and consistency gates by @EvenSol in #4633
• docs: make compressor dynamic Python example executable by @EvenSol in #4638
• [AI-Assisted] fix(transport): complete Filippov pressure factor and lifecycle checks by @EvenSol in #4640
• feat(optimizer): retain full envelope constraint ladder by @EvenSol in #4641
• test(ci): allow Maven options in electrolyte evidence workflow contract by @EvenSol in #4644
• fix(dew-point): solve trace-water CPA gas and mixed-liquid equilibrium by @EvenSol in #4645
• fix(separator): reject unclosed transient VU states by @EvenSol in #4646
• docs: execute PH flash Joule-Thomson example by @EvenSol in #4647
• fix(thermo): isolate standard Huron–Vidal clone state by @EvenSol in #4648
• [AI-Assisted] docs(properties): reconcile vapor-pressure qualification evidence by @EvenSol in #4653
• feat(dynamics): add bounded transactional adaptive step acceptance by @EvenSol in #4650
• fix(thermo): derive exact extended Debye-Huckel derivatives by @EvenSol in #4652
• docs: execute exact landing quick-start source by @EvenSol in #4655
• feat(optimization): screen next constraint opportunities by @EvenSol in #4656
• feat(pipeline): expose accepted boundary energy transfers by @EvenSol in #4657
• fix(thermo): recycle removed physical phase slots by @EvenSol in #4649
• [AI-Assisted] perf(thermo): reduce HV derivative workspace allocation by @EvenSol in #4660
• Compressor shaft groups, driver-limited throughput, gas-turbine site rating, platform power system by @EvenSol in #4661
• docs: execute exact physical-properties examples by @EvenSol in #4663
• feat(dynamics): add one-scan pressure transmitter sampling by @EvenSol in #4665
• docs(compressor): add dry-gas-seal literature review and agent workflows by @EvenSol in #4668
• fix: stabilize wet-gas equilibrium, pipe pressure and CPA state by @EvenSol in #4658
• feat(thermo): expose CPA mixed site derivatives for electrolyte chain rules by @EvenSol in #4664
• feat(separator): add optional emulsion-layer studies and agent discovery by @EvenSol in #4667
• docs: execute exact process-energy examples by @EvenSol in #4669
• [AI-Assisted] test(thermo): qualify Wagner derivative and inverse APIs by @EvenSol in #4670
• feat(dynamics): make valve actuators transactional by @EvenSol in #4672
• feat: conserve component energy at two-fluid nodes by @EvenSol in #4673
• feat(optimization): qualify paired constraint relief receipts by @EvenSol in #4677
• [AI-Assisted] test(thermo): qualify source-compatible SRK-HV MEG by @EvenSol in #4680
• feat(pipeline): support VFPPROD table-driven hydraulics by @EvenSol in #4676
• [AI-Assisted] fix(pipeline): conserve energy through stiff phase friction by @EvenSol in #4679
• [AI-Assisted] fix(transport): correct Fuller volumes and gas diffusivity clones by @EvenSol in #4686
• [AI-Assisted] feat(pipeline): own signed outlet thermodynamic donors by @EvenSol in #4687
• feat(optimization): rank qualified relief portfolios by @EvenSol in #4688
• feat: conserve two-fluid node source thermodynamics by @EvenSol in #4689
• [AI-Assisted] Gate release inventory by live phase geometry by @EvenSol in #4690
• [AI-Assisted] docs(skills): multi-platform complex model pattern and future-operation study skill by @EvenSol in #4692
• docs: execute risk framework quick start by @EvenSol in #4684
• [AI-Assisted] feat(ejector): fixed-geometry off-design mode with breakdown detection by @EvenSol in #4691
• feat(process): qualify embedded LCV and PCV transient control by @EvenSol in #4685
• [AI-Assisted] feat(expander): nozzle capacity, IGV flow function, JT bypass and shaft closure for TurboExpanderCompressor by @EvenSol in #4694
• [AI-Assisted] feat(process): opt-in run watchdog (time budget, stall detection, stop) for ProcessSystem and ProcessModel by @EvenSol in #4693
• fix(electrolyzer): conserve water and align Faradaic operating modes by @EvenSol in #4696
• [AI-Assisted] feat(process): automation addresses, recycle application, platform power unit and equipment limit register by @EvenSol in #4695
• Support Python 3.11+ (no upper bound) in toolkit and plugin hook by @EvenSol in #4698
• test(thermo): stage PR-HV water/gas provenance and bidirectional nitrogen assessment by @EvenSol in #4697
• [AI-Assisted] fix(electrolyzer): use a traceable alkaline current-efficiency reference by @EvenSol in #4699
• fix(pipeline): relax conserved hydrocarbon component targets by @EvenSol in #4701
• docs: execute oil quality quick start by @EvenSol in #4703
• feat(optimization): qualify non-additive relief combinations by @EvenSol in #4704
• feat(compressor): fixed-speed operating point with recycle, throttling and head-deficit classification by @EvenSol in #4700
• [AI-Assisted] feat(process): qualify sampled vessel-level control chain by @EvenSol in #4702
• feat(network): route signed outlet thermodynamics by @EvenSol in #4705
• perf(thermo): reuse invocation-local HV column pure terms by @EvenSol in #4706
• docs: render task contribution follow-up by @EvenSol in #4709
• fix(pipeline): correct Safety Shutdown acoustic timing and valve boundary by @EvenSol in #4708
• fix(fluidmechanics): qualify opt-in coupled gas/oil film solve by @EvenSol in #4711
• test(thermo): qualify phase-slot lifecycle performance by @EvenSol in #4712
• build(deps): bump tornado from 6.5.10 to 6.6 in /devtools in the uv group across 1 directory by @dependabot[bot] in #4710
• docs: correct Python runtime prerequisites by @EvenSol in #4713
• feat(pipeline): add experimental Safety Shutdown valve travel boundary by @EvenSol in #4714
• feat(measurement): analyser sample-system screening, TEG absorber phase diagnostics, Bukacek dew-point fallback by @EvenSol in #4715
• feat(optimization): qualify combined-relief envelope slices by @EvenSol in #4716
• fix(plugin): stop writing user mcp.json on VS Code 1.141+ by @EvenSol in #4717
• fix(pipeline): honor exact Safety Shutdown valve travel knots by @EvenSol in #4720
• docs: explain analyser sample-system screening by @EvenSol in #4719
• docs(rfc): propose Safety Shutdown acoustic inventory contracts by @EvenSol in #4723
• feat(pipeline): TwoFluidPipe liquid holdup calibration multiplier by @EvenSol in #4722
• fix(pipeline): conserve Safety Shutdown acoustic cell inventory by @EvenSol in #4724
• fix(physicalproperties): preserve liquid diffusion pair invariants by @EvenSol in #4725
• [AI-Assisted] docs: expose standards guides from landing page by @EvenSol in #4727
• fix(compressor): honor selected polytropic method in chart mode by @EvenSol in #4721
• [AI-Assisted] test(process): qualify separator pressure-control inventory by @EvenSol in #4726
• fix(thermo): correct GERG-water derivatives and ISO 18453 agent setup by @EvenSol in #4728
• feat(optimization): expose sampled 2D envelope cells by @EvenSol in #4729
• [AI-Assisted] docs: execute diffusivity guide example by @EvenSol in #4733
• feat(thermo): qualify CPA boundaries and hydrate amount flashes by @EvenSol in #4731
• feat(pipeline): add bounded Safety Shutdown pump-curve acoustics by @EvenSol in #4734
• fix: scale compressor head inversion tolerance for tiny shaft duties by @EvenSol in #4735
• fix(compressor): resolve sub-watt wet-gas energy closure by @EvenSol in #4739
• feat(plugin): start skill-declared silent warm-ups from the SessionStart hook by @EvenSol in #4743
• [AI-Assisted] feat(reservoir): add generalized Rs/Rv history balance by @EvenSol in #4741
• fix(pipeline): transient handoff and conservative wet component sources by @EvenSol in #4732
• docs: execute process quick start from literal guide source by @EvenSol in #4737
• [AI-Assisted] feat(process): add event-exact safety scenario timing by @EvenSol in #4738
• feat: add route-conditioned separator-pressure envelope by @EvenSol in #4742
• test(thermo): stage bidirectional CO2-HV diagnostics and performance evidence by @EvenSol in #4744
• docs: execute safety overview from literal guide source by @EvenSol in #4745
• feat(pipeline): add Safety Shutdown ideal lift/check-valve acoustics by @EvenSol in #4746
• [AI-Assisted] feat(pvt): freeze calibrated fluids and reservoir-history handoff by @EvenSol in #4747
• feat(agents): add PFD layout review gate and sync report agents/skills by @EvenSol in #4749
• feat(thermo): add generic four-site polarity topology by @EvenSol in #4748
• feat(pipeline): qualify read-only hydrostatic cell depth and area by @EvenSol in #4750
• [AI-Assisted] feat(reservoir): replay and fit measured component histories by @EvenSol in #4753
• devtools: process-study-report equipment notes, auto table widths, wide sensitivity pages by @EvenSol in #4757
• EmissionsTracker: use IPCC AR5 methane GWP (28) like the other emission calculators by @EmbryoSpace in #4751
• feat(safety): qualify final-element fault response by @EvenSol in #4752
• Start structure-H parameter qualification with sourced data and fit checks by @EvenSol in #4754
• docs: execute PVT separator quick start from guide source by @EvenSol in #4755
• feat(optimization): add common-shaft speed envelope action by @EvenSol in #4756
• fix(pipeline): balance mechanical pressure at closed walls by @EvenSol in #4758
• [AI-Assisted] fix(ci): keep inventory writes off protected master by @EvenSol in #4763
• [AI-Assisted] feat(reservoir): consolidate depletion PVT and history uncertainty by @EvenSol in #4759
• docs: align task-solving tutorial runtime and report workflow by @EvenSol in #4767
• test(optimization): refine common-speed driver boundary by @EvenSol in #4765
• [AI-Assisted] chore(release): prepare NeqSim 3.27.0 by @EvenSol in #4764

New Contributors

• @rqms40 made their first contribution in #4568
• @EmbryoSpace made their first contribution in #4751

Full Changelog: v3.26.0...v3.27.0