Installation
Install FEHM from PyPI with uv, verify its private runtime, and preserve project state across upgrades.
FEHM 1.0.0 is the first release and is available on PyPI. npm publication is pending.
FEHM is available from PyPI. The package contains the compiled engine and production JavaScript dependencies. Its pinned nodejs-wheel-binaries dependency supplies private Node 24.19.0. No separate Node/npm installation or FEHM source checkout is needed by users.
Install from PyPI
Install uv using the official uv installation guide. Python 3.10+ is required; uv can provision Python if needed. This release's installed-artifact tests were run on macOS ARM64 with Python 3.11. Linux, Windows, Intel macOS and other Python versions remain unverified; a portable wheel tag is not a tested-platform claim.
uv tool install fehm
uv tool update-shell
fehm --version
fehm doctorOpen a new terminal if the command is not found. Installation requires network access for Python/build dependencies and the private Node wheel unless cached. Startup does not download dependencies. Git workflows need Git; executing project checks needs the project's own toolchain.
First project
cd /path/to/your/project
fehm scan .
fehm context "authentication flow" --budget 4000
fehm serve --port 4317The scan saves .fehm/graph.json and .fehm/index.json. The dashboard is at http://127.0.0.1:4317. Stop it with Ctrl+C. See quickstart.
Upgrade and uninstall
Stop running FEHM servers, install the reviewed replacement wheel, and refresh only the assistant scopes you selected:
uv tool upgrade fehm
fehm --version
fehm install --platform claude
fehm integrations --platform claudeUse the replacement artifact's actual filename. Customized skills are preserved; --force backs up before replacement. A same-version reinstall has been tested; cross-version migrations require release-specific qualification. After a verified registry publication, the normal upgrade command will be uv tool upgrade fehm.
fehm uninstall --platform claude
uv tool uninstall fehmAdd --project to remove a project skill. Uninstalling the CLI leaves project .fehm state, policies, history and separately installed skills intact. MCP settings remain client-owned; remove only the FEHM entry through that client's settings.
Contributor source setup
Contributors need Node 22.13+, npm and Git. End users installing a wheel do not need these build steps.
npm ci
npm run build
node dist/cli.js --versionDo not mix a globally linked development command and a wheel command without checking fehm doctor for the actual runtime location.