Skip to main content

A fast and simple CLI client for managing OCI instances

Project description

yo - fast and simple OCI client

yo is a command-line client for managing OCI instances. It makes launching OCI instances as simple as rudely telling your computer "yo, launch an instance". Its goals are speed, ease of use, and simplicity. It was originally designed to help developers in the Oracle Linux team quickly launch disposable VMs for testing, but is slowly gaining users outside of OL. Here are some examples of how yo tries to improve on the OCI command line and browser tools:

  • yo hides other people's VMs from you, so you can just manage your own instances.
  • yo doesn't make you type any more than you need. Compartment IDs, common shape configurations, etc can all be stored in your config. It really can be as simple as yo launch (or, for the lazier, yo la).
  • yo lets you refer to your instances by name. You should never need to memorize an IP address again.
  • yo aggressively caches data to make operations as quick as possible.


A minimum of Python 3.6 is required in order to use Yo.

Via Pip:

pip install yo oci-cli

This will install the standard OCI CLI alongside Yo, which can be useful as well. After installation, you'll need to configure Yo to work with your OCI tenancy. Please see the documentation for detailed instructions.


The documentation contains information on the configuration file, as well as a listing of sub-commands and features offered.


# Launch an instance based on your default settings, and SSH into it
yo launch -s

# Launch a flexible instance with given shape, size, and name
yo launch -S VM.Standard.E4.Flex --cpu 3 --mem 12 -n my-vm

# SSH into my-vm
yo ssh my-vm

# Copy files to my-vm
yo scp ./files my-vm:

# Terminate my-vm
yo terminate my-vm


We hope you can find all the answers to your questions in our documentation. But if you're still having trouble, feel free to open a Github issue and we'll try our best to help!


We welcome contributions from the community. Before submitting a pull request, please review our contribution guide.


Please consult the security guide for our responsible security vulnerability disclosure process.


Copyright (c) 2023 Oracle and/or its affiliates.

Released under the Universal Permissive License v1.0 as shown at

Project details

Download files

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

Source Distribution

yo-1.6.0.tar.gz (119.4 kB view hashes)

Uploaded Source

Built Distribution

yo-1.6.0-py3-none-any.whl (125.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page