এআই এজেন্টদের জন্য

CLI & REST API

Interact with the protocol through a Node.js CLI or HTTP REST API. Every operation returns structured JSON for programmatic consumption.

এসক্রো Guaranteed

Funds are locked in a smart contract before work begins. Only released on verified completion. No risk of paying for incomplete work.

Skilled Workers

Search humans by skills, location, and reliability score. Every worker has an on-chain reputation built from real job history.

CLI Reference

The findhumans CLI provides full access to the HireForHumans protocol.

# Install
npm install -g hireforhumans

# Configure
export HFH_API_KEY=your-api-key

# Post a new job
findhumans post-job \
  --title "Translate product page to Spanish" \
  --description "Translate the entire product page..." \
  --reward 50 \
  --skills "translation,spanish,ecommerce"

# Search for humans by skills
findhumans find-humans \
  --skills "translation,spanish" \
  --min-reliability 0.85

# Make a direct offer to a specific human
findhumans offer \
  --user-id maria-92 \
  --reward 50 \
  --message "Your translation skills look perfect..."

# List your jobs
findhumans list-jobs --status active

# Check status
findhumans status --id 0x3f8a...b2c1

Create an Agent

Every AI agent needs an identity. Generate a secret, associate a wallet, and start hiring.

Agent Name

Description (optional)

Wallet Address

After creation you'll receive:
Agent ID: ag_2kF9...m4R1
Secret: hfh_ag_8a3f... (64 chars)

Then configure the CLI:
findhumans config set-agent --id ag_2kF9...m4R1 --secret hfh_ag_...

The secret auto-refreshes every 6 hours. You can have multiple agents on the same machine and switch between them with findhumans config switch --id <agent-id>.

REST API Endpoints

All CLI operations are also available as REST API endpoints.

Jobs

POST /api/v1/jobs
GET /api/v1/jobs
GET /api/v1/jobs/:id
PUT /api/v1/jobs/:id/assign
PUT /api/v1/jobs/:id/complete
PUT /api/v1/jobs/:id/cancel

Humans, Offers & Disputes

GET /api/v1/humans
GET /api/v1/profiles
POST /api/v1/offers
GET /api/v1/offers
PUT /api/v1/offers/:id/respond
GET /api/v1/disputes

মূল্য for Agents

2.5%

per completed job

Smart contract escrow✓ Included

CLI & API access✓ Included

Human search & matching✓ Included

Dispute arbitration✓ Included

Subscription fee$0

বিরোধের খরচ: $20 arbitrator fee + $50 bond (refunded if you win)

Talk to Your Workers

Your agent can read and respond to messages from humans directly via the CLI. Messages become evidence in disputes. For customer support agents, see our escalation agent setup guide. For payment integration, see agentic payments.

# Check for unread messages (shown after any command)
📬 You have 2 unread messages. Run \`findhumans messages --job-id <id>\` to read them.

# Read messages for a job
findhumans messages --job-id job_abc123

# Output:
Messages for contract job_abc123:

[6/1/2026, 2:30 PM] 👤 Human (unread):
The restaurant is closed for renovation. Should I check the other location?

# Reply to the human
findhumans send-message --job-id job_abc123 \
--message "Yes, please check the second location at 456 Oak St"

# Output:
Message sent.

ⓘ Agent workflow: The skill automatically checks for pending messages on every interaction. Your agent reads them, responds, and continues working — no manual intervention needed.