Skip to content

New Installation Guide#773

Merged
jkirk5 merged 23 commits intoOpenMDAO:mainfrom
jkirk5:installation_guide
May 29, 2025
Merged

New Installation Guide#773
jkirk5 merged 23 commits intoOpenMDAO:mainfrom
jkirk5:installation_guide

Conversation

@jkirk5
Copy link
Copy Markdown
Contributor

@jkirk5 jkirk5 commented May 20, 2025

Summary

Rewrote the installation guide to be as simple and flexible as possible with three installation types.

  • Quick Start: "bare" Aviary install from pypi, no pyoptsparse/optional packages
  • Detailed: latest version Aviary from github with pyoptsparse installation instructions
  • Developer: editable installation of Aviary, explanations for all optional packages (for testing, building docs, contributing code)

Tweaked optional-dependencies tags in pyproject based on experience with fresh minimal installations on Windows & Linux. Many old optional dependencies were themselves dependencies of other packages we need, so they were redundant. New tags better align with installation guide. New tags include:

  • [dev]: everything needed to run a successful testflo (assuming pyoptsparse is manually installed), plus pre-commit
  • [docs]: everything needed to successfully build the docs without error (also assumes pyoptsparse manually installed)
  • [all]: everything in [dev] and [docs]

Renamed some of the examples to be shorter and more clear what they actually are, and to help users better understand the interface levels intuitively, by picking the example with that level in the file name.

Comment thread aviary/docs/getting_started/installation.md Outdated
Comment thread aviary/docs/getting_started/installation.md Outdated
$ git clone git@github.com:OpenMDAO/OpenMDAO.git
```
#### Adding SNOPT
[SNOPT](http://ccom.ucsd.edu/~optimizers/solvers/snopt/) is a proprietary, high-performance optimizer that is very good at solving large nonlinear problems and is used by many OpenMDAO users. SNOPT is only supported on Linux.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Technically supported on macos unix as well.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I can acknowledge that and WSL too

$ git clone git@github.com:OpenMDAO/dymos.git
$ cd dymos
$ pip install -e .
subprocess.CalledProcessError: Command '['mamba', 'info', '--unsafe-channels']' returned non-zero exit status 109.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should try to collect our common installation errors (in all of our upcoming refreshes) to add to this database.

@jkirk5 jkirk5 merged commit c4f8518 into OpenMDAO:main May 29, 2025
6 checks passed
@jkirk5 jkirk5 deleted the installation_guide branch January 14, 2026 18:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants