update install instructions to use uv

Author: richardblythman

docs/GettingStarted/InstallSDK.md

@@ -2,92 +2,73 @@
 
 The [Naptha SDK](https://github.com/NapthaAI/naptha-sdk) is a Python library that allows you to interact with the Naptha ecosystem, such as the Naptha Hub and Naptha Nodes (for deploying agents and other modules, and acessing inference and storage). It can be used in Naptha Modules, and other components with other agent frameworks like CrewAI. 
 
-You can install the SDK using PyPI or from source.
+## 🧩 Installing the SDK
 
-## Install using PyPI
+You can install the SDK using PyPI or from source. We recommend using `uv` as a package manager. Follow the installation instructions [here](https://docs.astral.sh/uv/getting-started/installation/) to install `uv`.
 
-```bash
-pip install naptha-sdk
-```
+### Install within an existing project
 
-## Create a User Account for using the Naptha Hub and Naptha Nodes
-
-You can create an account on the Naptha Hub (and generate your ```PRIVATE_KEY```) using the Naptha CLI:
+If you want to install the naptha-sdk as part of an existing project (e.g. [to deploy existing agents from third-party frameworks on the Web of Agents](https://docs.naptha.ai/Integrations/Decorators)), it is good practice to do so within a dedicated virtual environment. If you don't already have a virtual environment, create a new one using `uv`:
 
 ```bash
-naptha signup
+uv init --python ">=3.10,<3.13"
 ```
-:::info
-This command will prompt you to create an account by entering a username and password. It also automatically generates a private key and stores it in your .env file.
-:::
-
-## Configure Environmental Variables
 
-### Configure ```NODE_URL```
-Choose whether you want to interact with a *local* or *hosted* Naptha node.
-
-#### Local Node
-For a local node, set ```NODE_URL=http://localhost:7001``` in the .env file.
-
-#### Hosted Node
-To use a hosted node, set e.g. ```NODE_URL=https://node.naptha.ai``` or ```NODE_URL=https://node2.naptha.ai``` in the .env file.
-
-
-## Install from Source
-
-To install from source, follow these steps:
-
-1. Install Poetry with pipx
-2. Install Naptha SDK
-3. Setup dev environment
-
-### 1. Install Poetry with pipx
-
-Naptha uses a Python dependency management tool called Poetry. Learn more about Poetry in their official [docs](https://python-poetry.org/docs). Run this command:
+Then install the SDK:
 
 ```bash
-pipx install poetry
+uv add naptha-sdk
+source .venv/bin/activate
 ```
 
-> Poetry should always be installed in a dedicated virtual environment to isolate it from the rest of your system.
-
-### 2. Clone Naptha SDK
-
-Clone the Repository and navigate to the SDK directory:
+Alternatively, if you have an existing project that doesn't use `uv` you can also install using:
 
 ```bash
-git clone https://github.com/NapthaAI/naptha-sdk.git && cd naptha-sdk
+pip install naptha-sdk
 ```
 
-Install the dependencies using Poetry:
+### Install from source
 
-```bash
-poetry install
-```
-
-Activate the virtual environment:
+If you are a developer contributing to the Naptha SDK, you will want to install from source using:
 
 ```bash
+git clone https://github.com/NapthaAI/naptha-sdk.git
+cd naptha-sdk
+uv venv
 source .venv/bin/activate
+uv pip install .
 ```
 
-Next, create a copy of the .env file:
+## 🔥 Create a User Account for using the Naptha Hub and Naptha Nodes
 
-```bash
-cp .env.example .env
-```
+Your Naptha account is your identity on the Naptha platform. It allows you to:
 
-#### Configure Variables
+- Deploy and run agents, tools, environments and other modules on Naptha Nodes (via a public/private keypair)
+- Access and interact with the Naptha Hub's features and services (via a username and password)
 
-Choose whether you want to interact with a local Naptha node or a hosted Naptha node. For a local node, set ```NODE_URL=http://localhost:7001``` in the .env file. To use a hosted node, set ```NODE_URL=https://node.naptha.ai``` or ```NODE_URL=https://node1.naptha.ai```.
+The simplest way to create a new account is through the interactive CLI. Run the following command:
 
+```bash
+naptha signup
+```
+
+:::info
+This command will prompt you to create an account by entering a username and password. It also automatically generates a private key and stores it in your .env file.
+:::
 
-To check the installation, run:
+Or if you have already have set up an identity, edit your `.env` file with your desired credentials:
 
 ```bash
-naptha
+# .env file
+HUB_USERNAME=your_username
+HUB_PASSWORD=your_password
+PRIVATE_KEY=your_private_key  # Optional - will be generated if not provided
 ```
 
+## ⚙️ Configure Environmental Variables
+
+Choose whether you want to interact with a *local* or *hosted* Naptha node. For a local node, set ```NODE_URL=http://localhost:7001``` in the .env file. To use a hosted node, set e.g. ```NODE_URL=https://node.naptha.ai``` or ```NODE_URL=https://node2.naptha.ai``` in the .env file.
+
 ## Need Help?
 
 - Join our [Community](https://naptha.ai/naptha-community) and post in the #support channel