Metadata-Version: 2.4
Name: crewai-oris
Version: 0.1.1
Summary: CrewAI 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,crewai,kya,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: crewai>=0.80
Requires-Dist: oris-sdk>=0.1.0
Requires-Dist: pydantic>=2.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# crewai-oris

CrewAI 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 crewai-oris
```

## Requirements

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

## Quick start

Set your credentials as environment variables:

```bash
export ORIS_API_KEY="oris_sk_live_..."
export ORIS_API_SECRET="your_api_secret"
export ORIS_AGENT_ID="your_agent_uuid"
```

Add Oris tools to a CrewAI agent:

```python
from crewai import Agent, Task, Crew
from oris_crewai import OrisPaymentTool, OrisCheckBalanceTool

finance_agent = Agent(
    role="Finance Agent",
    goal="Execute compliant payments on behalf of the crew",
    backstory="You handle all financial transactions with built-in KYA compliance.",
    tools=[OrisPaymentTool(), OrisCheckBalanceTool()],
    verbose=True,
)

payment_task = Task(
    description="Pay 25 USDC to 0xABC... for the API subscription renewal.",
    expected_output="Payment confirmation with transaction hash",
    agent=finance_agent,
)

crew = Crew(agents=[finance_agent], tasks=[payment_task])
result = crew.kickoff()
```

## Available tools

| Tool | Description |
|------|-------------|
| `OrisPaymentTool` | Execute a compliant stablecoin payment |
| `OrisCheckBalanceTool` | Retrieve wallet balances |
| `OrisGetSpendingTool` | Get payment and spending history |
| `OrisGetTierInfoTool` | Get KYA compliance tier and limits |

## Credential override

Credentials can also be passed directly to each tool:

```python
tool = OrisPaymentTool(
    api_key="oris_sk_live_...",
    api_secret="your_api_secret",
    agent_id="your_agent_uuid",
)
```

## Links

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

## License

MIT
