> For the complete documentation index, see [llms.txt](https://docs.shimoku.com/dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shimoku.com/dev/building-web-app/environment/overview.md).

# Overview

Environments provide a controlled and isolated workspace for developing and running Python or other programming languages, allowing users to manage dependencies and package versions effectively.

It is suggested to use **Conda,** although any similar environment management system can work for that matter.

## **Install Conda**

Visit the [Conda page](https://conda.io/projects/conda/en/latest/user-guide/install/index.html) and install the version that suits your operating system. Follow the simple steps they provide to finally set up their tools. 

Ensure the installation has been successful by verifying the Conda version installed:

```bash
conda --version
```

## **Create a Conda E**nvironment

Isolate properties and manage dependencies effectively by creating a new environment.

```bash
    conda create -n your_shimoku_env_name python=3.9 ipython
    conda activate your_shimoku_env_name 
```

## **Install Shimoku SDK**

Install the Shimoku SDK or update it (> v.2.0.0) to access the latest features in the recently created environment.

```bash
pip install shimoku
```

Or update it if it is already installed.

```bash
pip install --upgrade shimoku
```

{% hint style="warning" %}
When using a Linux Windows Subsystem (WSL) to launch the environments, be aware that searching manually the [URL of the playground](https://shimoku.io/playground/) on a browser will be necessary. This is due to code editors, such as Visual Studio Code, launching the port without content.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.shimoku.com/dev/building-web-app/environment/overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.