NeqSim 3.28.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.28.0.jar	Java 17+	You need Java 17 or Python neqsim-python compatibility.
NeqSim core library	neqsim-3.28.0-Java8.jar	Java 8+	You need Java 8 or Python neqsim-python compatibility.
NeqSim MCP server	neqsim-mcp-server-3.28.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.28.0-runner.jar.sha256	-	You want to verify the downloaded MCP runner jar.
NeqSim MCP server container	ghcr.io/equinor/neqsim-mcp-server:3.28.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.28.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.28.0

Claude Desktop example

{
  "mcpServers": {
    "neqsim": {
      "command": "java",
      "args": ["-jar", "/path/to/neqsim-mcp-server-3.28.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.28.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

• feat(two-fluid): expose phase-resolved boundary ledgers by @EvenSol in #4769
• feat(engineering): revision-control dynamic scenario evidence by @EvenSol in #4766
• [AI-Assisted] feat(reservoir): predict produced composition and separator GOR by @EvenSol in #4771
• docs: repair developer Javadoc and runtime entrypoints by @EvenSol in #4774
• fix(pipeline): balance interior hydrostatic pressure and signed work by @EvenSol in #4768
• [AI-Assisted] fix(compressor): keep chart power local to each run by @EvenSol in #4775
• [AI-Assisted] feat(pvt): qualify laboratory gas-density handoff with source bounds by @EvenSol in #4776
• [AI-Assisted] test(thermo): check declared HV source CO2 saturation roots by @EvenSol in #4772
• energy-project-agents plugin, well-planning physics package, process-overview skill by @EvenSol in #4777
• [AI-Assisted] feat(pipeline): qualify stratified hydrostatic pressure moments by @EvenSol in #4778
• test(optimization): qualify map-to-driver boundary migration by @EvenSol in #4780
• docs: execute compressor chart-to-efficiency quick start by @EvenSol in #4779
• [AI-Assisted] feat(pvt): preserve native depletion states through phase appearance by @EvenSol in #4781
• [AI-Assisted] fix(pipeline): reject incomplete pressure-moment audit matrices by @EvenSol in #4782
• Fix numbered citation links in book HTML by @EvenSol in #4787
• [AI-Assisted] feat(layout): qualify physical isolation inventory evidence by @EvenSol in #4790
• docs: link compressor guide from landing page by @EvenSol in #4788
• [AI-Assisted] test(thermo): qualify selected-pair HV multicomponent cost by @EvenSol in #4783
• [AI-Assisted] fix(thermo): require fugacity closure in pressure flash by @EvenSol in #4784
• [AI-Assisted] fix(thermo): correct sensitivities and batch property gradients by @EvenSol in #4786
• test(optimization): persist map-to-driver migration evidence by @EvenSol in #4789
• [AI-Assisted] feat(pipeline): couple stratified phase pressure moments by @EvenSol in #4791
• [AI-Assisted] feat(pvt): preserve closed-mass native CCE handoff by @EvenSol in #4792
• fix(reports): validate detail slides and preserve small flows by @EvenSol in #4796
• Add neqsim report-manifest: hand a solved task to project-development… by @EvenSol in #4799
• [AI-Assisted] fix(pvt): refine native CVD upper-dew cell reference by @EvenSol in #4797
• [AI-Assisted] feat(pipeline): qualify cross-sectional gravity energy budgets by @EvenSol in #4798
• docs: execute PT phase-envelope example by @EvenSol in #4801
• paperlab books: full-width wide figures in Word, no duplicate chapter opener by @EvenSol in #4802
• feat(optimization): report map-to-driver migration timeline by @EvenSol in #4803
• Package discipline_report_manifest; add USE WHEN to two skill descriptions by @EvenSol in #4804
• [AI-Assisted] feat(dynamics): qualify sampled temperature-control scans (DYN-C030) by @EvenSol in #4800
• [AI-Assisted] test(thermo): qualify held HV evaluator proposals by @EvenSol in #4805
• docs: execute pump design example by @EvenSol in #4808
• build(deps): bump org.apache.maven:apache-maven from 3.9.16 to 3.10.0 by @dependabot[bot] in #4811
• [AI-Assisted] fix(pvt): restore CVD volume after liquid disappearance by @EvenSol in #4806
• [AI-Assisted] feat(safety): couple external heat to release inventory by @EvenSol in #4807
• build(deps): bump com.google.code.gson:gson from 2.14.0 to 2.15.0 by @dependabot[bot] in #4812
• build(deps-dev): bump org.apache.maven.plugins:maven-enforcer-plugin from 3.6.3 to 3.7.0 by @dependabot[bot] in #4813
• build(deps): bump astral-sh/setup-uv from 10.3.2 to 10.3.3 by @dependabot[bot] in #4814
• [AI-Assisted] fix(pipeline): conserve total energy in optional Rusanov flux by @EvenSol in #4809
• docs: execute field-development overview by @EvenSol in #4816
• [AI-Assisted] feat(pipeline): retain bidirectional phase-face transport by @EvenSol in #4818
• feat: link map-driver evidence to lifecycle replay by @EvenSol in #4817
• [AI-Assisted] feat(pvt): preserve aqueous closed-mass CCE handoff by @EvenSol in #4819
• docs: execute flow-assurance overview by @EvenSol in #4822
• [AI-Assisted] feat(safety): retain finite-rate phase inventory by @EvenSol in #4820
• [AI-Assisted] feat(pipeline): add gas-only pressure outlet by @EvenSol in #4821
• [AI-Assisted] test(thermo): retain quarantined CO2-MEG source receipts by @EvenSol in #4823
• [AI-Assisted] feat(pvt): retain liquid inventories in native wet DLE by @EvenSol in #4824
• [DYN-C031] Qualify physical flow transmitter scans by @EvenSol in #4825
• docs: execute process cookbook example by @EvenSol in #4826
• feat: report optimizer termination in lifecycle evidence by @EvenSol in #4827
• fix(reservoir): correct Horner buildup permeability, skin and P* in TransientWellModel by @EvenSol in #4829
• docs: repair choke-collapse Python example by @EvenSol in #4830
• build(deps-dev): bump org.jacoco:jacoco-maven-plugin from 0.8.15 to 0.8.16 by @dependabot[bot] in #4810
• fix: recover PS roots and accelerate bracketed saturation flashes by @EvenSol in #4831
• feat(pvt): add transactional explicit-reference fixed-cell depletion by @EvenSol in #4832
• feat(process): add OscillationAnalyzer and CompressorLoadLimiter by @EvenSol in #4834
• docs: execute corrected Horner buildup example by @EvenSol in #4835
• Add physical-inventory safeguarding design proposals by @EvenSol in #4836
• feat: add runnable field-to-facility acceptance by @EvenSol in #4837
• feat: add DEXPI 2.0.1 P&ID review packages and simulation handoff by @EvenSol in #4839
• fix(absorber): handle hydrocarbon liquid in SimpleTEGAbsorber; feat: ProcessReplay time-series replay; CPA TEG/MEG tests by @EvenSol in #4840
• Feat/teg restart sample system dynamics by @EvenSol in #4841
• test(thermo): preserve nitrogen-water primary source versions by @EvenSol in #4842
• docs: distinguish guide and API navigation by @EvenSol in #4844
• feat(pipeline): qualify conservative hydrocarbon pool transfer by @EvenSol in #4838
• Generate native DEXPI 2.0.1 PFD and instrumented P&ID review drawings by @EvenSol in #4845
• fix(pvt): refine explicit fixed-cell equilibrium and volume precision by @EvenSol in #4843
• Add P&ID quality review and reconcile native drawing topology by @EvenSol in #4848
• docs: execute literal physical-property examples by @EvenSol in #4846
• feat(pipeline): retain wall inventory through restart screening by @EvenSol in #4847
• [AI-Assisted] test(thermo): retain MEG natural-gas source data by @EvenSol in #4850
• [AI-Assisted] feat(pvt): qualify laboratory CVD component accounting by @EvenSol in #4851
• docs: execute literal heat-exchanger example by @EvenSol in #4852
• [AI-Assisted] chore(release): prepare NeqSim 3.28.0 by @EvenSol in #4849

Full Changelog: v3.27.0...v3.28.0