Hiero SDK in Python

A Python SDK for interacting with the Hedera Hashgraph platform.

Quick Start

Installing from PyPI

pip install --upgrade pip
pip install hiero-sdk-python

Environment Configuration

Create a .env file in your project root with your Hedera testnet credentials.

Full setup instructions: Setup Guide

Don't have testnet credentials? Get them free at Hedera Portal

A sample file is provided: .env.example

Basic Usage

from hiero_sdk_python import Client, AccountBalanceQuery

# Connect to testnet
client = Client.for_testnet()
client.set_operator(account_id, private_key)

# Query account balance
balance = AccountBalanceQuery(account_id=account_id).execute(client)
print(f"Balance: {balance.hbars} HBAR")

---

Documentation

For SDK Users

• Running Examples - Complete guide to all SDK operations with code examples
• Examples Directory - Ready-to-run example scripts

For SDK Developers

• Contributing Guide - Start here!
• Setup Guide - First-time environment setup
• Workflow Guide - Day-to-day development workflow
• Signing Guide - GPG and DCO commit signing (required)
• Changelog Guide - How to write changelog entries
• Rebasing Guide - Keep your branch up-to-date
• Merge Conflicts Guide - Resolve conflicts
• Typing Guide - Python type hints
• Linting Guide - Code quality tools

Hedera Network Resources

• Hedera Documentation
• Hedera Protobufs
• Get Testnet Account - Free testnet credentials
• Hedera Testnet Guide

Other SDKs

• Hiero JavaScript SDK
• Hiero Java SDK
• Hiero Go SDK

---

Running Tests

uv run pytest

For contributors: Tests run automatically via Hiero Solo Action when you push to a branch.

Learn more:

• Testing with Hiero Solo

---

Community & Support

Get Help

• Discord: - Linux Foundation Decentralized Trust Discord (signed in users can use this direct link to the Python SDK Channel)
• General Hedera Support: - Hedera Developer Discord
• Issues: GitHub Issues

Stay Updated

• Blog: Hiero Blog
• Videos: LFDT YouTube Channel
• Community Calls: Hiero Calendar (Wednesdays, 2pm UTC)

---

⭐ Follow Us

If you find the Hiero Python SDK useful, here are three ways you can support the project and stay up-to-date on the official repository page: hiero-ledger/hiero-sdk-python.

• Star the Repository: Click Star to bookmark the project and show your support.
• Watch for Activity: Click Watch to set your notification level, ensuring you stay updated on new features and releases.
• Fork the Project: Click Fork to create your own copy, the first step for contributions.

---

Contributions

We welcome contributions! Whether you're:

• 🐛 Reporting bugs
• 💡 Suggesting features
• 📝 Improving documentation
• 💻 Writing code

Start here: CONTRIBUTING.md

---

License

This project is licensed under the Apache License 2.0.

---

Latest release: Check PyPI or GitHub Releases