Humanod Python SDK

The official Python client for Humanod – the API that allows AI Agents and developers to seamlessly hire humans for physical tasks in the real world.

Installation

pip install humanod

Quick Start

Delegate a physical task to a human with just a few lines of code.

from humanod import HumanodClient, CreateTaskRequest, TaskCategory

client = HumanodClient(api_key="your_api_key_here")

# 1. Define the mission
task_spec = CreateTaskRequest(
    title="Take a photo of the Eiffel Tower",
    description="I need a vertical photo of the Eiffel Tower right now for an article.",
    price=15.0,  # EUR
    category=TaskCategory.MEDIA,
    location_name="Paris, France",
    deliverables="1 clear high-res photo",
    validation_criteria="The tower must be centered and fully visible.",
    skills_required=["photography"]
)

# 2. Deploy to the real world
task = client.hire_human(task_spec)
print(f"Mission deployed! View task ID: {task.task_id}")

Core Methods

• hire_human(task_spec): Creates a new task.
• check_task_status(task_id): Gets the current status of the task.
• get_submissions(task_id): Retrieves all proofs of work submitted by humans.
• review_submission(application_id, validation): Approve or reject work.
• cancel_task(task_id): Cancels the mission and refunds the budget.

Standardized Agent-to-Human Schema

This SDK enforces the open "Agent-to-Human" standard JSON schema via statically typed Pydantic models (e.g., CreateTaskRequest, ValidationRequest).