Metadata-Version: 2.4
Name: langchain-oris
Version: 0.1.1
Summary: LangChain integration for Oris: Compliant payment rails and KYA infrastructure for autonomous AI agents.
Project-URL: Homepage, https://useoris.xyz
Project-URL: Documentation, https://docs.useoris.xyz
Project-URL: Repository, https://github.com/fluxaventures/oris
Project-URL: Bug Tracker, https://github.com/fluxaventures/oris/issues
Author-email: Fluxa Ventures LLC <engineering@fluxa.ventures>
License-Expression: MIT
Keywords: ai-agents,compliance,kya,langchain,oris,payments,stablecoin,web3
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.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: langchain-core<1,>=0.2
Requires-Dist: oris-sdk>=0.1.0
Requires-Dist: pydantic>=2.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# langchain-oris

LangChain integration for the [Oris](https://useoris.xyz) AI agent payment infrastructure.

Oris gives AI agents a verified financial identity, a non-custodial wallet, and programmable
spending policies enforced on every transaction before execution.

## Installation

```bash
pip install langchain-oris
```

## Requirements

- Python 3.10+
- `langchain-core >= 0.2`
- An Oris API key from [useoris.xyz](https://useoris.xyz)

## Quick start

```python
from oris_langchain import OrisToolkit

toolkit = OrisToolkit(
    api_key="oris_sk_live_...",
    api_secret="your_api_secret",
    agent_id="your_agent_uuid",
)

tools = toolkit.get_tools()
```

Pass `tools` to any LangChain agent or LangGraph node:

```python
from langchain_openai import ChatOpenAI
from langgraph.prebuilt import create_react_agent

llm = ChatOpenAI(model="gpt-4o")
agent = create_react_agent(llm, tools)

result = agent.invoke({
    "messages": [("user", "Pay 10 USDC to 0xABC... for the translation service.")]
})
```

## Available tools

| Tool | Description |
|------|-------------|
| `oris_pay` | Execute a compliant stablecoin payment |
| `oris_check_balance` | Retrieve wallet balances |
| `oris_get_spending` | Get payment and spending history |
| `oris_get_tier_info` | Get KYA compliance tier and limits |

## Individual tool usage

```python
from oris_langchain import OrisPayTool, OrisCheckBalanceTool

pay_tool = OrisPayTool(
    api_key="oris_sk_live_...",
    api_secret="your_api_secret",
    agent_id="your_agent_uuid",
)

result = pay_tool.run({
    "to": "0xRecipientAddress",
    "amount": 10.0,
    "stablecoin": "USDC",
    "chain": "base",
    "purpose": "vendor_payment",
})
```

## Links

- Documentation: [docs.useoris.xyz](https://docs.useoris.xyz)
- PyPI: [pypi.org/project/langchain-oris](https://pypi.org/project/langchain-oris)
- GitHub: [github.com/fluxaventures/oris](https://github.com/fluxaventures/oris)

## License

MIT
