Ask The Odyssey

{
  "author": "Homer",
  "book_id": 1727,
  "chapter_detection": "heading",
  "count": 1,
  "location_note": "Chapter values are detected section indices, not guaranteed printed chapter numbers. Section 0 (text before the first detected heading) is excluded.",
  "method": "Full-text retrieval with common word variants and surrounding source text; no generated answer or summary. Up to 12 content terms, expanded into word variants, must match a local passage window.",
  "passages": [
    {
      "chapter": 9,
      "chunk_end": 295,
      "chunk_ids": [
        1250697,
        1250698,
        1250699,
        1250700,
        1250701
      ],
      "chunk_index": 293,
      "chunk_start": 291,
      "location": "section 9, passage #291–295",
      "source_url": "https://www.gutenberg.org/ebooks/1727",
      "text": "“‘My good ram, what is it that makes you the last to leave my cave this morning? You are not wont to let the ewes go before you, but lead the mob with a run whether to flowery mead or bubbling fountain, and are the first to come home again at night; but now you lag last of all. Is it because you know your master has lost his eye, and are sorry because that wicked Noman and his horrid crew has got him down in his drink and blinded him? But I will have his life yet. If you could understand and talk, you would tell me where the wretch is hiding, and I would dash his brains upon the ground till they flew all over the cave. I should thus have some satisfaction for the harm this no-good Noman has done me.’\n\n“As he spoke he drove the ram outside, but when we were a little way out from the cave and yards, I first got from under the ram’s belly, and then freed my comrades; as for the sheep, which were very fat, by constantly heading them in the right direction we managed to drive them down to …"
    }
  ],
  "question": "how does Odysseus escape the Cyclops",
  "ranking_scope": "Book-local relevance ranking; works over 6000 chunks use up to 300 matching corpus-index candidates before ranking. Matches are evidence to inspect, not verified answers.",
  "title": "The Odyssey Rendered into English prose for the use of those who cannot read the original"
}

# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i -X POST 'https://library.forgemesh.io/ask-the-odyssey' \
  -H 'content-type: application/json' \
  --data-raw '{"limit":1,"question":"how does Odysseus escape the Cyclops"}'

# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - -X POST 'https://library.forgemesh.io/ask-the-odyssey' \
  -H 'content-type: application/json' \
  --data-raw '{"limit":1,"question":"how does Odysseus escape the Cyclops"}' \
  | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decode

// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// Pays at most $0.01 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.01" });
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.01 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Flibrary.forgemesh.io%2Fask-the-odyssey&method=POST
const res = await pay("https://library.forgemesh.io/ask-the-odyssey", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    "limit": 1,
    "question": "how does Odysseus escape the Cyclops"
  }),
});
console.log(res.status, await res.text());

# pip install "x402[requests,evm]"
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

# Pays at most $0.01 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.01"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))

with x402_requests(client) as session:
    res = session.post(
        "https://library.forgemesh.io/ask-the-odyssey",
        json={
            "limit": 1,
            "question": "how does Odysseus escape the Cyclops",
        },
    )
    print(res.status_code, res.text)