fmu-settings-cli

fmu-settings-cli is the CLI package for fmu-settings.

Usage

To launch the application simply run

fmu settings

The command starts one server for both the API and the built GUI on port 8000, and opens the FMU Settings home page in your web browser.

GUI development

To develop the GUI, start only the API. You can also use --reload if you change API code.

fmu settings api

By default the API will set CORS rules restricting requests to a default host and port (localhost:8000). In development with a GUI it's likely your frontend port will be something different. You can specify this like so:

fmu settings api --gui-port 5173

This will update the CORS rules in the API to accept requests from localhost:5173.

The API authorizes all requests with a randomly generated token. When starting the API for use in development this token can be printed by setting the FMU_SETTINGS_PRINT_TOKEN environment variable or providing the --print-token flag.

fmu settings api --gui-port 5173 --print-token
# or
export FMU_SETTINGS_PRINT_TOKEN=true
# or
FMU_SETTINGS_PRINT_TOKEN=true fmu-settings api --gui-port 5173

It's also possible to print the full URL a user would be directed to with a similar URL flag and environment variable.

fmu settings api --gui-port 5173 --print-url
# or
export FMU_SETTINGS_PRINT_URL=true
# or
FMU_SETTINGS_PRINT_URL=true fmu-settings api --gui-port 5173

Note that these additional flags are intended for development so they only work with fmu settings api subcommand.

CLI development

Clone and install into a virtual environment.

git clone git@github.com:equinor/fmu-settings-cli.git
cd fmu-settings-cli
# Create or source virtual/Komodo env
pip install -U pip
pip install -e ".[dev]"
# Make a feature branch for your changes
git checkout -b some-feature-branch

Run the tests with

pytest -n auto tests

Ensure your changes will pass the various linters before making a pull request. It is expected that all code will be typed and validated with mypy.

ruff check
ruff format --check
mypy src tests

See the contributing document for more.

Development Status
- 3 - Alpha
Natural Language
- English
Operating System
- POSIX :: Linux
Programming Language
Topic
- Scientific/Engineering
- Utilities

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fmu_settings_cli-1.1.0.tar.gz (137.4 kB view details)

Uploaded Aug 11, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

fmu_settings_cli-1.1.0-py3-none-any.whl (36.6 kB view details)

Uploaded Aug 11, 2026 Python 3

File details

Details for the file fmu_settings_cli-1.1.0.tar.gz.

File metadata

Download URL: fmu_settings_cli-1.1.0.tar.gz
Upload date: Aug 11, 2026
Size: 137.4 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for fmu_settings_cli-1.1.0.tar.gz
Algorithm	Hash digest
SHA256	`f76a66b16616340177d21c4cddfd7ac12885e584bd79d633d1da9dc8d0d3dfde`
MD5	`cd3e40f824375ad52b9fd13329bb51f1`
BLAKE2b-256	`6fc55bffba76c611b313c0f55044958f56ba73124fb369f7469819d06d48b399`

See more details on using hashes here.

Provenance

The following attestation bundles were made for fmu_settings_cli-1.1.0.tar.gz:

Publisher: publish.yml on equinor/fmu-settings-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: fmu_settings_cli-1.1.0.tar.gz
- Subject digest: f76a66b16616340177d21c4cddfd7ac12885e584bd79d633d1da9dc8d0d3dfde
- Sigstore transparency entry: 2419177161
- Sigstore integration time: Aug 11, 2026
Source repository:
- Permalink: equinor/fmu-settings-cli@767f6cb9e95441e4a5906facdb5b297a6bb967c6
- Branch / Tag: refs/tags/1.1.0
- Owner: https://github.com/equinor
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@767f6cb9e95441e4a5906facdb5b297a6bb967c6
- Trigger Event: release