Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -83,9 +83,9 @@ Hands-on workshops and guided learning experiences that take developers from fun

Notebooks and apps contributed by partners in the AI ecosystem. AI Developers can use these resources to understand how to use Oracle AI Database and OCI alongside tools such as LangChain, Galileo, LlamaIndex, and other popular AI/ML frameworks and platforms.

| Name | Description | Stack | Link |
| ------------- | ------------------------------------------------ | ----- | ---- |
| _Coming soon_ | Partner-contributed resources will be added here | - | - |
| Name | Description | Stack | Link |
| --- | --- | --- | --- |
| spraay_x402_payment_agents_oracle | Build payment-enabled AI agents with Oracle AI Database and Spraay x402 Gateway — cost-aware agents that pay for premium inference via USDC micropayments | Oracle AI Database, langchain-oracledb, LangChain, Spraay x402 | [Open Notebook](partners/spraay/spraay_x402_payment_agents_oracle.ipynb) |

## Getting Started

Expand Down
40 changes: 40 additions & 0 deletions partners/spraay/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
# Spraay Protocol — Payment-Enabled AI Agents

## About Spraay

[Spraay Protocol](https://spraay.app) is a multi-chain batch payment protocol deployed across **15 blockchains** and an [x402](https://www.x402.org) payment gateway with **88 pay-per-call endpoints** across **19 categories**. The [Spraay x402 Gateway](https://gateway.spraay.app) enables AI agents to pay for premium services — inference (200+ models), Bittensor decentralized AI, search/RAG, compute, storage, robotics, and more — using USDC micropayments over standard HTTP. No API keys required.

Spraay's batch payment tool is an official community tool in [Google's Agent Development Kit (ADK)](https://github.com/google/adk-python-community) — merged as PR #95.

## Notebook

| Name | Description | Stack |
| --- | --- | --- |
| `spraay_x402_payment_agents_oracle.ipynb` | Build a cost-aware AI agent that retrieves context from Oracle AI Database and pays for premium inference via Spraay's x402 gateway | Oracle AI Database, langchain-oracledb, LangChain, Spraay x402, httpx |

## What You'll Learn

- How to combine Oracle AI Vector Search with paid external services in a single agent loop
- Implementing the x402 payment protocol for autonomous machine-to-machine payments
- Building cost-aware agents that prefer free resources before escalating to paid ones
- Choosing between centralized AI (200+ models) and decentralized Bittensor inference (43+ models)
- Using Oracle's hybrid search (vector + SQL) for agent memory and context retrieval

## Prerequisites

- Python 3.9+
- Oracle Database 23ai or Oracle Autonomous Database with AI Vector Search
- Ethereum wallet with USDC on Base
- OpenAI API key

## Links

- [Spraay Protocol](https://spraay.app)
- [Spraay x402 Gateway Docs](https://docs.spraay.app) — 88 endpoints, 19 categories
- [Gateway](https://gateway.spraay.app)
- [MCP Server](https://smithery.ai/server/@plagtech/spraay-x402-mcp) — 60 tools for Claude Desktop, Cursor, Cline
- [Google ADK Community Tool](https://github.com/google/adk-python-community) — PR #95
- [x402 Protocol](https://www.x402.org)
- [GitHub](https://github.com/plagtech)
- [Twitter](https://twitter.com/Spraay_app)
- [Contract on Base](https://basescan.org/address/0x1646452F98E36A3c9Cfc3eDD8868221E207B5eEC)
Loading