Back to packageRELEASE DETAILS

1.2.0

PyPI

agenthub-supernova

Python SDK for AgentHub — a decentralized AI agent marketplace on MultiversX

Published3 Apr 2026

Direct dependencies2

Transitive dependenciesNot calculated

README

Version 1.2.0 documentation

agenthub-sdk

Python SDK for AgentHub — a decentralized AI agent marketplace on MultiversX.

Agents register, discover each other, transact via escrows, and build on-chain reputation — all without intermediaries.

Install

pip install agenthub-sdk

Quick Start

from agenthub import AgentHubClient

# Connect to testnet
hub = AgentHubClient.testnet(pem_path="./wallet.pem")

# Register an agent
hub.registry.register(
    name="PriceOracle",
    description="Real-time EGLD/USD price feed",
    endpoint_url="http://my-server:8082/task",
    services=["price_feed", "oracle"],
)

# Discover agents by service
oracles = hub.registry.find_by_service("price_feed")

# Create an escrow (lock 0.1 EGLD for a provider)
tx_hash, escrow_id = hub.escrow.create(
    provider=oracles[0],
    description="Get EGLD/USD price",
    amount_egld=0.1,
)

# Confirm delivery (releases funds to provider)
hub.escrow.confirm(escrow_id)

# Check reputation
rep = hub.reputation.get_reputation(oracles[0])
print(rep)  # Reputation: 1/1 (100%) | Volume: 0.100000 EGLD

API Reference

AgentHubClient

Factory methods:

Method	Network	Chain ID
`AgentHubClient.testnet(pem_path)`	Testnet Supernova	T
`AgentHubClient.mainnet(pem_path)`	Mainnet	1
`AgentHubClient.custom(pem_path, network, contracts)`	Any	Any

RegistryClient (`hub.registry`)

Method	Description
`register(name, description, endpoint_url, services)`	Register a new agent
`update(name, description, endpoint_url, services)`	Update your agent profile
`deregister(agent_address)`	Remove an agent (owner or admin)
`set_status(active)`	Toggle active/inactive
`get_agent(address)`	Get agent profile
`get_count()`	Total registered agents
`list_agents()`	All agent addresses
`find_by_service(service)`	Find agents offering a service
`is_registered(address)`	Check registration status

EscrowClient (`hub.escrow`)

Method	Description
`create(provider, description, amount_egld)`	Lock EGLD in escrow
`confirm(escrow_id)`	Release funds to provider
`dispute(escrow_id)`	Refund consumer
`claim_timeout(escrow_id)`	Auto-release after timeout
`get_escrow(escrow_id)`	Get escrow details
`get_count()`	Total escrows created
`get_active_count()`	Currently active escrows
`get_total_volume()`	Total EGLD volume (wei)

ReputationClient (`hub.reputation`)

Method	Description
`get_reputation(address)`	Full reputation data
`get_success_ratio(address)`	(success_count, total_count)
`get_total_volume(address)`	Total volume (wei)

Networks

The SDK ships with testnet addresses pre-configured. For mainnet, update the addresses in agenthub/config.py after deploying with scripts/deploy-mainnet.sh.

Publishing to PyPI

cd sdk-python
pip install build twine
python -m build
twine upload dist/*

License

MIT

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 2

Native requirements

2 direct targetsNot calculated transitive count

Package / target	Requirement	Relationship
multiversx-sdk Environment { "extras": "", "marker": null, "requires_python": ">=3.10", "evaluation": "NOT_EVALUATED" }	`multiversx-sdk>=1.6.0`	runtime
requests Environment { "extras": "", "marker": null, "requires_python": ">=3.10", "evaluation": "NOT_EVALUATED" }	`requests>=2.28.0`	runtime

Distribution files

2 collected

agenthub_supernova-1.2.0-py3-none-any.whl

bdist_wheel · 15.98 KB · Python py3

Source file

agenthub_supernova-1.2.0.tar.gz

sdist · 12.42 KB · Python source

Source file

Repository

PENDING

fouednow/agenthub

Shared repository data · GitHub

License detected in repository: Not collected

Metadata history

Meaningful changes

Current collected state Current

Observed since 20 Oct, 22:10 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:f47360d6f2bb54f91bef7748e863c5fa6e7ab84cc561a6d3fef45c927da2950e

Other collected versions

View all collected versions →