docs(getting-started): add Python tab to Create an Account tutorial (#170)

Signed-off-by: EMerchant90 <[email protected]>
Signed-off-by: Ejaz Merchant <[email protected]>
Co-authored-by: krystal <[email protected]>

Author: EMerchant90

.gitignore

@@ -1,4 +1,6 @@
 .env
 .env.example
 *.bak
-.idea
+.venv/
+__pycache__/
+.idea

getting-started-hedera-native-developers/create-a-token.md

@@ -165,6 +165,85 @@ go mod tidy
 ```
 {% endcode %}
 {% endtab %}
+
+{% tab title="Python" %}
+**Before you start:** Ensure you have Python 3.10+ installed on your machine. Run this command to verify.
+
+```bash
+python --version
+```
+
+If the `python --version` command is not found or shows a version lower than 3.10, install or upgrade Python from [Python Install](https://www.python.org/downloads/).
+
+**Note:** On some systems, you may need to use `python3` instead of `python` for initial setup commands. If `python --version` doesn't work, try `python3 --version` and use `python3` for the virtual environment creation. After activating the virtual environment, always use `python` for all commands.
+
+Open your terminal and create a working directory for your Hedera project. Then navigate into the new directory:
+
+```bash
+mkdir hedera-examples && cd hedera-examples
+```
+
+**Verify Python and pip:** Ensure you have Python 3.10+ and pip installed on your machine. Run these commands to check:
+
+```bash
+python --version
+```
+
+```bash
+python -m pip --version
+```
+
+Create a virtual environment to isolate your project dependencies (Python best practice):
+
+```bash
+python -m venv .venv
+```
+
+Activate the virtual environment to use the isolated Python installation:
+
+{% tabs %}
+{% tab title="Mac/Linux" %}
+```bash
+source .venv/bin/activate
+```
+{% endtab %}
+
+{% tab title="Windows" %}
+```bash
+.venv\Scripts\activate
+```
+{% endtab %}
+{% endtabs %}
+
+Upgrade pip to ensure you have the latest package installer (recommended):
+
+```bash
+python -m pip install --upgrade pip
+```
+
+Install the [Python SDK](https://github.com/hiero-ledger/hiero-sdk-python):
+
+```bash
+python -m pip install hiero_sdk_python
+```
+
+Create a file named `CreateTokenDemo.py` and add the following imports:
+
+```python
+import os
+import time
+import requests
+
+from hiero_sdk_python import (
+    Client,
+    AccountId,
+    PrivateKey,
+    TokenCreateTransaction,
+    TokenType,
+    SupplyType,
+)
+```
+{% endtab %}
 {% endtabs %}
 
 ***
@@ -221,6 +300,18 @@ client := hedera.ClientForTestnet()
 client.SetOperator(operatorId, operatorKey)
 ```
 {% endtab %}
+
+{% tab title="Python" %}
+```python
+# Load your operator credentials
+operatorId = AccountId.from_string(os.getenv("OPERATOR_ID", ""))
+operatorKey = PrivateKey.from_string(os.getenv("OPERATOR_KEY", ""))
+
+# Initialize your testnet client and set operator
+client = Client()
+client.set_operator(operatorId, operatorKey)
+```
+{% endtab %}
 {% endtabs %}
 
 ***
@@ -259,6 +350,14 @@ supplyKey, _ := hedera.PrivateKeyGenerateEcdsa() // can mint/burn
 adminKey := supplyKey // can update/delete (reuse for simplicity)
 ```
 {% endtab %}
+
+{% tab title="Python" %}
+```python
+# Generate keys that control your token
+supply_key = PrivateKey.generate_ecdsa()  # can mint/burn
+admin_key = supply_key  # can update/delete (reuse for simplicity)
+```
+{% endtab %}
 {% endtabs %}
 
 **‼️ Security reminder**: Keep your private keys secure - anyone with access can control your token.
@@ -347,6 +446,31 @@ tokenId := *receipt.TokenID
 fmt.Printf("Token created: %s\n", tokenId.String())
 ```
 {% endtab %}
+
+{% tab title="Python" %}
+```python
+# Build the transaction
+transaction = (
+    TokenCreateTransaction()
+    .set_token_name("Demo Token")
+    .set_token_symbol("DEMO")
+    .set_decimals(2)
+    .set_initial_supply(100_000)
+    .set_token_type(TokenType.FUNGIBLE_COMMON)
+    .set_supply_type(SupplyType.FINITE)
+    .set_max_supply(100_000)
+    .set_treasury_account_id(operatorId)
+    .freeze_with(client)
+)
+
+# Sign with the admin key and execute
+signed_tx = transaction.sign(admin_key)
+receipt = signed_tx.execute(client)
+token_id = receipt.token_id
+
+print(f"\nFungible token created: {token_id}")
+```
+{% endtab %}
 {% endtabs %}
 
 ## Step 4: Query the Treasury Balance Using Mirror Node API
@@ -394,6 +518,14 @@ mirrorNodeUrl := "https://testnet.mirrornode.hedera.com/api/v1/accounts/" + oper
 ```
 {% endcode %}
 {% endtab %}
+
+{% tab title="Python" %}
+{% code overflow="wrap" %}
+```python
+mirror_node_url = f"https://testnet.mirrornode.hedera.com/api/v1/accounts/{operatorId}/tokens?token.id={token_id}"
+```
+{% endcode %}
+{% endtab %}
 {% endtabs %}
 
 **Complete Implementation:**
@@ -483,6 +615,29 @@ if len(data.Tokens) > 0 {
 client.Close()
 ```
 {% endtab %}
+{% tab title="Python" %}
+```python
+# Wait for Mirror Node to populate data
+print("\nWaiting for Mirror Node to update...")
+time.sleep(3)
+
+# Query balance using Mirror Node
+mirror_node_url = f"https://testnet.mirrornode.hedera.com/api/v1/accounts/{operatorId}/tokens?token.id={token_id}"
+
+response = requests.get(mirror_node_url, timeout=10)
+response.raise_for_status()
+data = response.json()
+
+tokens = data.get("tokens", [])
+if tokens:
+    balance = tokens[0].get("balance", 0)
+    print(f"\nTreasury holds: {balance} DEMO\n")
+else:
+    print("Token balance not yet available in Mirror Node")
+
+client.close()
+```
+{% endtab %}
 {% endtabs %}
 
 ***
@@ -732,6 +887,81 @@ func main() {
 
 </details>
 
+<details>
+
+<summary><strong>Python</strong></summary>
+
+{% code overflow="wrap" %}
+```python
+import os
+import time
+import requests
+
+from hiero_sdk_python import (
+    Client,
+    AccountId,
+    PrivateKey,
+    TokenCreateTransaction,
+    TokenType,
+    SupplyType,
+)
+
+# Load your operator credentials
+operatorId = AccountId.from_string(os.getenv("OPERATOR_ID", ""))
+operatorKey = PrivateKey.from_string(os.getenv("OPERATOR_KEY", ""))
+
+# Initialize the client for testnet
+client = Client()
+client.set_operator(operatorId, operatorKey)
+
+# Generate token keys
+supply_key = PrivateKey.generate_ecdsa()
+admin_key = supply_key
+
+# Build & execute the token creation transaction
+transaction = (
+    TokenCreateTransaction()
+    .set_token_name("Demo Token")
+    .set_token_symbol("DEMO")
+    .set_decimals(2)
+    .set_initial_supply(100_000)
+    .set_token_type(TokenType.FUNGIBLE_COMMON)
+    .set_supply_type(SupplyType.FINITE)
+    .set_max_supply(100_000)
+    .set_treasury_account_id(operatorId)
+    .freeze_with(client)
+)
+
+signed_tx = transaction.sign(admin_key)
+receipt = signed_tx.execute(client)
+token_id = receipt.token_id
+
+print(f"\nFungible token created: {token_id}")
+
+# Wait for Mirror Node to populate data
+print("\nWaiting for Mirror Node to update...")
+time.sleep(3)
+
+# Query balance using Mirror Node
+mirror_node_url = f"https://testnet.mirrornode.hedera.com/api/v1/accounts/{operatorId}/tokens?token.id={token_id}"
+
+response = requests.get(mirror_node_url, timeout=10)
+response.raise_for_status()
+data = response.json()
+
+tokens = data.get("tokens", [])
+if tokens:
+    balance = tokens[0].get("balance", 0)
+    print(f"\nTreasury holds: {balance} DEMO\n")
+else:
+    print("Token balance not yet available in Mirror Node")
+
+client.close()
+```
+{% endcode %}
+
+</details>
+
 ***
 
 ## Run Your Project
@@ -766,6 +996,19 @@ mvn compile exec:java -Dexec.mainClass="com.example.CreateTokenDemo"
 ```bash
 go run create_token_demo.go
 ```
+{% endtab %}
+
+{% tab title="Python" %}
+```bash
+python CreateTokenDemo.py
+```
+
+**When finished, deactivate the virtual environment:**
+
+```bash
+deactivate
+```
+
 {% endtab %}
 {% endtabs %}