Metadata-Version: 2.5
Name: xyz17711-emoji-match
Version: 0.1.0
Summary: Typed Python client for the 17711.xyz Emoji Match API: pay-per-call, settled in USDC via x402.
Project-URL: Homepage, https://api.17711.xyz
Project-URL: Repository, https://github.com/17711-services/clients
Project-URL: Documentation, https://github.com/17711-services/clients/tree/main/python/packages/emoji-match#readme
Project-URL: Issues, https://github.com/17711-services/clients/issues
Author: 17711 Services
License: MIT
Keywords: ai-agents,api-client,emoji-match,langchain,mcp,pay-per-call,usdc,x402
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.9
Requires-Dist: xyz17711>=0.1.0
Provides-Extra: langchain
Requires-Dist: langchain-core<2.0,>=1.2; extra == 'langchain'
Provides-Extra: test
Requires-Dist: pytest>=8; extra == 'test'
Description-Content-Type: text/markdown

# xyz17711-emoji-match

[![Publish](https://github.com/17711-services/clients/actions/workflows/publish-python.yml/badge.svg)](https://github.com/17711-services/clients/actions/workflows/publish-python.yml)
[![PyPI](https://img.shields.io/pypi/v/xyz17711-emoji-match)](https://pypi.org/project/xyz17711-emoji-match/)
[![Python versions](https://img.shields.io/pypi/pyversions/xyz17711-emoji-match)](https://pypi.org/project/xyz17711-emoji-match/)
[![License](https://img.shields.io/pypi/l/xyz17711-emoji-match)](https://github.com/17711-services/clients/blob/main/LICENSE)

Typed Python client for **emoji-match-service**, part of the
[17711.xyz](https://api.17711.xyz) microservice fleet -- pay-per-call APIs settled in USDC via
[x402](https://x402.org), listed on [x402scan](https://www.x402scan.com/server/f1c7b972-3405-4b75-8b4f-d1bfbd6305ff). See the
[Python family README](https://github.com/17711-services/clients/blob/main/python/README.md)
for the full guide (payment configuration, LangChain integration, logging, error handling) -- this
page only covers what's specific to this one package.

## Install

```bash
pip install "xyz17711[emoji-match]"
```

## Methods

| Method | Description |
| --- | --- |
| `suggest_emojis` | Emoji suggestion API: text in 18 languages in, the 1 to 5 best matching emoji out, deterministic and fast ($0.002, x402) |

Every method above has both a sync form and an async form (the `a`-prefixed sibling, e.g.
`asuggest_emojis` next to `suggest_emojis`), sharing one underlying client.

## Quickstart

```python
from xyz17711_emoji_match import Client

client = Client()  # talks to https://api.17711.xyz/registry/emoji-match-service by default
# see the Methods table above for every available call and its request/response model
```

Pass another base URL (self-hosted instance, test server) as the first argument:
`Client("https://my-host.example/registry/emoji-match-service")`.

## LangChain

```bash
pip install "xyz17711-emoji-match[langchain]"
```

```python
from xyz17711_emoji_match import Client
from xyz17711_emoji_match.langchain_tools import EmojiMatchToolkit

client = Client()
tools = EmojiMatchToolkit(client=client).get_tools()
```

## License

MIT -- see the repository's own `LICENSE`.
