iwantfyi-llamaindex
LlamaIndex tools for iwant.fyi — the reference implementation of the iwant.fyi demand-side protocol v1.1. Lets any LlamaIndex agent express structured purchase intent and receive matched supply across multiple sources.
pip install iwantfyi-llamaindex
Usage
from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.openai import OpenAI
from iwantfyi_llamaindex import get_iwant_tools
tools = get_iwant_tools(api_key="iwant_ak_...")
agent = FunctionAgent(
tools=tools,
llm=OpenAI(model="gpt-4o"),
system_prompt="You help users find and buy things via iwant.fyi.",
)
response = await agent.run("Find me waterproof running shoes under $120")
print(response)
Get a free API key by registering an agent: POST https://iwant.fyi/api/agents/register (or see /developers).
Tools
| Tool | What it does |
|---|---|
demand_create_want |
Create a buyer Want (structured purchase intent) and return matches. |
demand_search |
Find matched supply for a query without persisting a Want. |
demand_get_want |
Retrieve a Want by id with its current matches. |
demand_record_outcome |
Report viewed/clicked/purchased for attribution + match-quality learning. |
demand_list_verticals |
Discover supported verticals + spec keys. |
demand_list_constraints |
Discover the constraint vocabulary. |
demand_health |
Liveness + active supply sources. |
Options
get_iwant_tools(...):
api_key(required) —iwant_ak_...base_url— defaults tohttps://iwant.fyitransport—"mcp"(default) or"http"for the REST fallbackclient— reuse an existingIwantClient(testing / pooling)
License
Apache-2.0. Full protocol spec: iwant.fyi/protocol/v1.
1 maintainer
Metadata
1 maintainer
Release files for iwantfyi-llamaindex 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| iwantfyi_llamaindex-0.1.1.tar.gz | 7.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| iwantfyi_llamaindex-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 16.8 kB
Release files / iwantfyi_llamaindex-0.1.1.tar.gz
| Download URL | iwantfyi_llamaindex-0.1.1.tar.gz |
|---|---|
| Size | 7.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
dbfdc07351b59d5c93b76037b73a94e10ec46bf33e27b0122f9de8b8e9cc61ab
|
|
BLAKE2b-256 checksum How to use checksums |
c677a775c29740d5a8ab9de6c618c70f17d51693a32d149ed2de192f5fd7fb96
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.6
|
Release files / iwantfyi_llamaindex-0.1.1-py3-none-any.whl
| Download URL | iwantfyi_llamaindex-0.1.1-py3-none-any.whl |
|---|---|
| Size | 9.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
53673e32b1ee76d1f375ff0b78536ff4ac8ce47928e1b8dbf09b381404a22e0b
|
|
BLAKE2b-256 checksum How to use checksums |
3d81d1733e130b610bd54eb2b30ef25a07bec5aaca65b9fac7d47822b96b09da
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.6
|
