hashgraph / hashgraph/hedera-agent-kit-py

Developer Experience: Python 3.14 Compatibility Constraints & LangGraph Deprecation Warnings

Open
#314 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
11
Forks
10
PR merge metrics
No merged PRs in 30d

Description

### Problem

While integrating the hedera-agent-kit Python SDK into Hackathon project (LoveLedger), I gathered the following high-value observations and developer feedback to improve developer experience (DX) and library longevity:

### Solution

1. Strict Python Version Constraints on PyPI (Requires-Python >=3.10,<3.14)
Observation: The current package release has a strict version boundary that blocks installation on modern developer environments running the latest Python version (Python 3.14.x). Running a standard pip install hedera-agent-kit fails with: ERROR: Ignored the following versions that require a different python version: ... Requires-Python >=3.10,<3.14
Impact: Developers running modern python runtimes are forced to bypass checks using the --ignore-requires-python flag.
Recommendation: Expand the PyPI package definition to support <3.15. I verified that all core library elements, SDK dependencies, and the test suite run flawlessly on Python 3.14.4 under standard workloads!
2. LangGraph create_react_agent Deprecation Warnings
Observation: When importing and creating agents using the default template examples, the library raises deprecation notices from LangGraph: LangGraphDeprecatedSinceV10: create_react_agent has been moved to langchain.agents. Please update your import to from langchain.agents import create_agent
Recommendation: Update the toolkit default templates and documentation examples to target the modern LangChain API wrappers, ensuring deprecation-free console outputs.
3. Real-Time HCS Audit Trail Hook Utility
Observation: The HcsAuditTrailHook is a phenomenal feature for developer accountability and real-time on-chain audits!
Recommendation: I recommend elevating this hook's prominence in the getting started guide and developer examples. Logging tool calls directly to an HCS topic in real-time is a powerful on-chain logging best practice that more developers should be encouraged to utilize.

### Alternatives

_No response_

Contributor guide

Open the contributing guide

Research direction

Start by checking the package metadata that defines the Python version constraint, then locate the default templates and documentation examples that use the deprecated LangGraph API. Review the getting started guide for HcsAuditTrailHook coverage. Done means Python 3.14 installation works, deprecation-free examples use the recommended API, and the hook is more prominent in onboarding material.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
developer-experience, documentation
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.