Skip to content

Conversation

@AlexCuadron
Copy link
Contributor

This PR improves the installation documentation by adding clear instructions about SkyPilot prerequisites and cloud provider setup.

Changes

  • Add clear prerequisites section with SkyPilot installation instructions
  • Specify exact SkyPilot version requirements for each cloud provider (0.5.0)
  • Add note about Apple Silicon requirements and grpcio workaround
  • Include different installation options:
    • Basic installation (CLI and Python API)
    • Server installation
    • Development installation
  • Add Docker installation alternative
  • Link to official SkyPilot cloud setup guides
  • Update repository URL from michaelzhiluo/skyshift to sky-shift/skyshift
  • Add verification steps with sky check

Testing

  • Build docs locally and verify formatting
  • Follow installation steps in a fresh environment to verify accuracy

This change ensures that GCP dependencies are installed by default when installing skyshift.
Previously, users would encounter errors when trying to use GCP features without
explicitly installing the GCP dependencies.

Error fixed:
Failed to import dependencies for GCP. Try: pip install "skypilot[gcp]"
- Add clear prerequisites section with SkyPilot installation instructions
- Specify exact SkyPilot version requirements for each cloud provider
- Add note about Apple Silicon requirements
- Include different installation options (basic, server, dev)
- Add Docker installation alternative
- Link to official cloud setup guides
- Update repository URL to sky-shift/skyshift
- Add verification steps with sky check
- Remove Docker installation section as it's not yet available
- Remove version pinning from skypilot installation commands
For Macs, macOS >= 10.15 is required to install SkyShift. Apple Silicon-based devices (e.g. Apple M1) must run ``pip uninstall grpcio; conda install -c conda-forge grpcio=1.43.0`` prior to installing SkyShift.

To install SkyShift's python API and CLI, run:
Prerequisites
Copy link
Collaborator

Choose a reason for hiding this comment

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

This is not true right?

Copy link
Collaborator

Choose a reason for hiding this comment

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

This should be in cloud section; the mvp for skyshift is over K8s.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

This is true, they need to run sky check at least once. But you are right, it should be merged to the cloud branch

Copy link
Contributor Author

Choose a reason for hiding this comment

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

There is no cloud branch, must have been merged into the MVP

Prerequisites
------------

SkyShift requires SkyPilot to be installed and configured with at least one cloud provider. Follow these steps to set up your environment:
Copy link
Collaborator

Choose a reason for hiding this comment

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

It is not required if users only want to use onprem resources.

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.

2 participants