Improve the getting started instructions
@@ -17,17 +17,63 @@ permalink: /getting-started
---
-`PowerfulSeal` is available to install through pip:
+## Local installation
+
+`PowerfulSeal` is available to install through [pip](https://pypi.org/project/powerfulseal/).
+
+### Prerequisites
+
+You're going to need [`python`](https://www.python.org/downloads/) 3.7+.
+
+```sh
+python --version
+Python 3.7.6
+```
+
+#### Setting up a virtualenv
+
+A good practice is to always use [virtualenv](https://virtualenv.pypa.io/en/stable/). You can create and activate one like this:
+
+```sh
+python -m virtualenv env
+source env/bin/activate
+```
+
+### Installing through pip
```sh
pip install powerfulseal
-powerfulseal --help # or seal --help
```
-To start the web interface, use flags `--server --server-host [HOST] --server-port [PORT]` when starting PowerfulSeal in autonomous mode and visit the web server at `http://HOST:PORT/`.
+### Starting the Seal
+
+To see the syntax of the commands, you can always run:
-Python 3.7 and Python 3.8 are supported.
+```sh
+powerfulseal --help
+```
+
+If you have a [`kubeconfig`](https://kubernetes.io/docs/concepts/configuration/organize-cluster-access-kubeconfig/) file ready (for example in `~/.kube/config`) and working with `kubernetes`, you can start the seal on defaults:
+
+```sh
+powerfulseal interactive
+```
+
+This will start a command line, interactive CLI, just like the following:
+
+```sh
+$ powerfulseal interactive
+(...)
+(seal) $
+```
+
+Try listing pods from the `kube-system` namespace:
+
+```sh
+(seal) $ pods kube-system
+```
+For help, just type `help`. For more information about the modes, see our [docs on modes](/modes).
## Docker
