Metadata-Version: 2.4
Name: seamm-manager
Version: 2026.9.27.6
Summary: The manager for SEAMM (Simulation Environment for Atomistic and Molecular Simulations): installs, updates and configures SEAMM in a uv-managed environment.
Home-page: https://github.com/molssi-seamm/seamm_manager
Author: Paul Saxe
Author-email: psaxe@molssi.org
License: GNU Lesser General Public License v3+
Keywords: SEAMM,plug-in,flowchart,installer,updater
Platform: Linux
Platform: Mac OS-X
Platform: Unix
Platform: Windows
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Chemistry
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.12
Description-Content-Type: text/x-rst
License-File: LICENSE
License-File: AUTHORS.rst
Requires-Dist: packaging
Requires-Dist: platformdirs
Requires-Dist: pmw
Requires-Dist: pyyaml
Requires-Dist: requests
Requires-Dist: seamm-util
Requires-Dist: seamm-widgets
Requires-Dist: tabulate
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: platform
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

=============
SEAMM Manager
=============

| |pull| |CI| |docs| |coverage| |lgtm| |PyUp|
| |Release| |PyPi|

Installs, updates and configures SEAMM (the Simulation Environment for Atomistic and
Molecular Simulations) in a uv-managed Python environment.

* Free software: GNU Lesser General Public License v3+
* Documentation: https://molssi-seamm.github.io/seamm_manager/index.html

.. |pull| image:: https://img.shields.io/github/issues-pr-raw/molssi-seamm/seamm_manager
   :target: https://github.com/molssi-seamm/seamm_manager/pulls
   :alt: GitHub pull requests

.. |CI| image:: https://github.com/molssi-seamm/seamm_manager/workflows/CI/badge.svg
   :target: https://github.com/molssi-seamm/seamm_manager/actions?query=workflow%3ACI
   :alt: CI status

.. |docs| image:: https://github.com/molssi-seamm/seamm_manager/workflows/Documentation/badge.svg
   :target: https://github.com/molssi-seamm/seamm_manager/actions?query=workflow%3ADocumentation
   :alt: Documentation Status

.. |coverage| image:: https://codecov.io/gh/molssi-seamm/seamm_manager/branch/master/graph/badge.svg
   :target: https://codecov.io/gh/molssi-seamm/seamm_manager
   :alt: Code coverage

.. |lgtm| image:: https://img.shields.io/lgtm/grade/python/g/molssi-seamm/seamm_manager.svg?logo=lgtm&logoWidth=18
   :target: https://lgtm.com/projects/g/molssi-seamm/seamm_manager/context:python
   :alt: Code Quality

.. |PyUp| image:: https://pyup.io/repos/github/molssi-seamm/seamm_manager/shield.svg
   :target: https://pyup.io/repos/github/molssi-seamm/seamm_manager/
   :alt: Updates for requirements

.. |Release| image:: https://github.com/molssi-seamm/seamm_manager/workflows/Release/badge.svg
   :target: https://github.com/molssi-seamm/seamm_manager/actions?query=workflow%3ARelease
   :alt: CI status for releases

.. |PyPi| image:: https://img.shields.io/pypi/v/seamm_manager.svg
   :target: https://pypi.python.org/pypi/seamm_manager
   :alt: Release version

Features
--------

* **One environment, all from PyPI.** SEAMM and every plug-in are installed into a
  Python virtual environment under the SEAMM root (``~/SEAMM/venv``) with `uv`_,
  constrained to a published lock file, so every installation gets the same
  known-good set of versions and installs in seconds.
* **The interpreter comes with it.** ``uv`` installs Python (with Tk for the
  graphical editor); no conda, no system Python needed for SEAMM itself.
* **Conda only for the codes.** External programs (MOPAC, Psi4, DFTB+, LAMMPS, ...)
  are installed by their plug-ins into their own conda environments, exactly as
  before; conda is only needed if you install one of those plug-ins.
* Services (the JobServer and the web interface), desktop apps, and the datastore are
  set up and kept current by the same tool.

Getting started
---------------

.. code-block:: bash

    curl -LsSf https://astral.sh/uv/install.sh | sh    # once, if you do not have uv
    uv tool install seamm-manager
    seamm-manager install --all

That creates ``~/SEAMM``, the environment inside it, and installs SEAMM with all the
MolSSI plug-ins. ``seamm-manager update --all`` keeps everything current; without any
arguments ``seamm-manager`` opens a graphical installer.

Coming from seamm-installer
---------------------------

``seamm-manager`` replaces ``seamm-installer``, which managed a conda environment.
Existing conda-based installations keep working but no longer receive updates. To
move: run the three lines above, then ``seamm-manager services create`` and
``seamm-manager apps create`` to point the JobServer, web interface and desktop apps
at the new environment. Your jobs, configuration files and the codes' own conda
environments are untouched. Remove the old conda environment when you are happy.

.. _uv: https://docs.astral.sh/uv/

Acknowledgements
----------------

This package is based on ``seamm-installer``, and was developed by the Molecular
Sciences Software Institute (MolSSI_), which receives funding from the `National
Science Foundation`_ under awards OAC-1547580 and CHE-2136142.

.. _MolSSI: https://www.molssi.org
.. _`National Science Foundation`: https://www.nsf.gov


=======
History
=======
2026.9.27.6 -- A trial installation cannot change production's codes
    * Each installation now has a code-environment policy for the external codes'
      conda environments, kept in ``<root>/installation.ini``. ``own`` (always the case
      for ``~/SEAMM``) creates and updates them as before. ``shared``, the default for
      any other installation, uses ``~/SEAMM``'s: installing a plug-in copies its
      ``<code>.ini`` from ``~/SEAMM``, and installing, updating or uninstalling never
      touches a conda environment, only reports. ``prefixed`` gives the installation its
      own copies named ``seamm-<name>-<code>``. ``install --code-environments`` chooses
      it and ``environment show`` shows it.
    * Before, installing plug-ins in a second installation recreated the shared
      environments, which is how a test on 2026-09-27 replaced the codes' environments
      on one machine.
    * The policy is applied by the seamm-manager in the installation's own
      environment. If that copy is too old to know about it, the manager now skips the
      plug-ins' install, update and uninstall steps in a non-default installation
      instead of letting them run.

2026.9.27.5 -- Several installations side by side; update --latest fixed
    * The services, desktop apps and macOS service bundles of an installation other
      than ``~/SEAMM`` now carry its name, which is the root's directory name unless
      the new ``--name`` option gives another: ``jobserver-SEAMM_NEW``,
      ``SEAMM (SEAMM_NEW)``, ``SEAMM-JobServer-SEAMM_NEW``. Before, any root other than
      ``~/SEAMM`` and ``~/SEAMM_DEV`` used the same names as ``~/SEAMM``, so creating
      its services replaced production's. ``~/SEAMM_DEV`` now follows the same rule
      (``jobserver-SEAMM_DEV`` rather than ``dev_jobserver``).
    * ``services create`` stops and replaces any other SEAMM service of the same kind
      started with the same root, whatever its name, so two JobServers never share one
      datastore. It gives the web interface the service's existing port, or else the
      first free port from 55055, so a second installation's web interface does not
      clash with the first's.
    * ``services status --all`` and ``services show --all`` list every installation's
      services, with their roots. The manager's window shows which installation it is
      working on, and its Services tab can now create the web interface service.
    * The root defaults to ``$SEAMM_ROOT`` when set.
    * ``update --latest`` asked PyPI's JSON API, which could return a stale copy
      shortly after a release; it now asks the simple index that uv installs from.
    * Bugfix: after installing seamm-jobserver, the manager restarted a service named
      after the package, which never exists, so the JobServer was not restarted.

2026.9.27.4 -- Bugfix: plug-in installers use the installation being worked on
    * The plug-ins' installers always wrote their code's ``.ini`` file (``mopac.ini``,
      ``lammps.ini``, ...) into ``~/SEAMM``, even for ``seamm-manager --root X`` or
      ``--development``. The manager now tells them its root, so the files go into the
      installation being installed or updated.
    * An installer run by hand from an installation's environment
      (``<root>/venv/bin/<plug-in>-installer``) works on that installation. ``root`` in
      the per-user ``seamm.ini`` is still honoured but deprecated, as it is shared by
      every installation.

2026.9.27.3 -- Bugfix: services restart now restarts the services
    * ``seamm-manager services restart`` did nothing: it ran the start command, which
      reported that the service was already running. It now stops and starts each
      service, on macOS and Linux. (The restart that ``update`` does after upgrading the
      JobServer was not affected.)
    * When starting, stopping or restarting a service failed, the command and the
      manager's Services tab crashed with an AttributeError instead of showing what
      went wrong. They now print the error.

2026.9.27.2 -- The Mac services show up by name, with the SEAMM icon
    * On macOS the JobServer and the web interface showed up in Activity Monitor and
      ``ps`` as ``python3.12``. They now run as ``SEAMM-JobServer`` and ``SEAMM-WebUI``
      with the SEAMM icon: ``services create`` puts the environment's Python
      interpreter in a small background app under ``~/SEAMM/services`` (a hard link,
      so no extra disk space) and runs the service with it. Jobs are started exactly as
      before.
    * Existing services keep working as they are. ``seamm-manager update`` says how to
      convert them (``seamm-manager services create --force jobserver webui``, when no
      jobs are running), and keeps the bundles' interpreter in step with the
      environment.
    * ``services create --force`` sometimes left the new service stopped, without any
      message: launchd was still removing the old one when it was started. Stopping a
      service now waits until launchd has finished.

2026.9.27.1 -- Bugfix: the Mac apps no longer ask for Rosetta
    * On an Apple Silicon Mac without Rosetta, starting SEAMM or SEAMM-Manager from its
      app showed a dialog asking to install Rosetta. The app's executable was a shell
      script, which carries no architecture, so macOS assumed it might need Intel code.
      The apps now use a small compiled launcher, built for both Apple Silicon and
      Intel, which runs the same script from the app's Resources folder. Nothing in
      SEAMM needs Rosetta.
    * ``seamm-manager update`` converts existing apps automatically (and keeps their
      version current); ``seamm-manager apps update`` does the same on its own.
    * The app's process is now SEAMM itself rather than a shell waiting on it.

2026.9.27 -- update --latest picks up a same-day release from PyPI
    * ``seamm-manager update`` takes the available version of each package from the
      package list published nightly, so a release made today was reported as
      "Everything is up to date" until the next day, and ``--no-constraints`` did not
      help. The new ``--latest`` option asks PyPI for each package's newest release,
      pins it exactly when it is newer than the list's, and updates without the lock
      file (which would pin yesterday's version). If PyPI cannot be reached the
      package list is used as before.

2026.9.26.6 -- Bugfix: environment files no longer upgrade a machine's torch
    * Applying a plug-in's environment file to an existing conda environment no
      longer upgrades bare pip requirements. Conda runs a file's ``pip:`` section
      with ``pip install -U``, so ``torch`` in xnn_step's file was upgraded, in the
      ``seamm-lammps`` environment that xnn.ini on ChemAI shares with LAMMPS, to a
      CUDA 13 build the driver cannot run. Now a bare name is installed only if
      missing, while a requirement with a version specifier (``xnns>=0.3.0``,
      ``e3nn==0.4.4``) is kept current within it. The plug-in that adds the MLFF
      engine to LAMMPS's environment keeps doing so; the machine's driver-matched
      torch is left alone.

2026.9.26.5 -- Bugfix: the manager's release was only synced alongside other updates
    * The step added in 2026.9.26.4 that puts the running manager's release into the
      environment ran only when some other package was being installed or updated, so
      an environment with nothing else to update kept the older manager. It now runs
      every time.

2026.9.26.4 -- The environment keeps the manager's own release; manual codes
    * After installing or updating, the manager puts its own release into the
      environment if the package list still names an older one. The list is refreshed
      nightly, so for up to a day after a manager release the environment -- and with it
      the plug-ins' installers -- used to get the previous version.
    * A plug-in installer for a code that is not installed automatically (ORCA,
      Gaussian, VASP) now says so when asked to install, instead of failing with an
      AttributeError about a missing environment file.

2026.9.26.3 -- Bugfixes from the first Linux migration (ChemAI)
    * ``update --all`` upgrades the manager itself with a forced, index-refreshing
      reinstall; ``uv tool upgrade`` could report "Nothing to upgrade" minutes after a
      release because uv reused its cached view of PyPI.
    * The datastore version check ran ``alembic`` from the PATH, which the
      manager's own tool environment does not have; it now runs the environment's
      alembic, like the migration itself. On ChemAI this made a fresh install end
      in "updated to version unknown, but it should be None".
    * ``services create`` on Linux crashed after deleting the old unit and before
      writing the new one (the executable path is now a ``Path``), leaving no
      service. Found on ChemAI; the unit was restored by hand.

2026.9.26.2 -- Bugfixes from a first installation on a brand-new Mac
    * On a fresh Mac ``uv tool install seamm-manager`` built the manager on the
      system Python 3.9, because nothing declared a minimum version. The package now
      requires Python 3.12 or later, so uv installs one if needed.
    * A plug-in's own installer that fails (for instance because conda is not
      installed) now reports what went wrong, instead of leaving the code silently
      uninstalled.
    * The datastore is created at installation, and before a service is started,
      rather than by the web interface's first start; a JobServer created first
      used to crash-loop on the missing database.

2026.9.26.1 -- Bugfixes from the first real migration
    * Conda could not be found by a manager or plug-in installer launched from the
      Dock or as a service, whose PATH is minimal, so the GUI showed a traceback in
      each plug-in's description. Conda is now found through ``$CONDA_EXE``, the PATH,
      or the usual installation directories, and its directory is passed on to
      sub-processes. With no conda environment active the base installation is taken
      from ``root_prefix`` rather than the (empty) active prefix.
    * The services and datastore commands used the raw ``--root`` option, which is
      empty when the default root applies; the post-install step crashed. They now
      use the resolved root.
    * A plug-in installer writing a fresh ``<code>.ini`` crashed serializing an empty
      configuration.
    * The manager's desktop app is ``SEAMM-Manager``, running ``seamm-manager``.
    * ``install`` runs the per-package steps (datastore update, the plug-ins' own
      installers) for the packages it installed or updated; ``--rerun-installers``
      runs them for every requested package, which recovers an interrupted install.

2026.9.26 -- First release of seamm-manager
    * seamm-manager replaces seamm-installer. It manages a SEAMM installation in a
      uv-managed Python virtual environment under the SEAMM root (``~/SEAMM/venv``):
      every package comes from PyPI, resolved against the published lock file, so an
      installation is reproducible and takes seconds rather than minutes. Conda is
      used only for the external codes' own environments (MOPAC, Psi4, LAMMPS, ...).
    * ``seamm-manager install --all`` creates the environment (Python 3.12 via uv) and
      installs SEAMM with all the MolSSI plug-ins in one constrained step; ``update``
      keeps the manager and the packages current; a new ``environment`` command shows,
      creates, recreates or removes the environment. Services, desktop apps and the
      datastore migration use the environment's own executables.
    * seamm-installer stays available for existing conda-based installations, which
      keep working but no longer receive updates; see the migration guide in the
      installation documentation. A ``seamm_installer`` compatibility module keeps the
      plug-ins' own installers working inside the new environment.
