rencom 0.1.0

Official Python SDK for the Rencom API - unified search for x402 resources and UCP merchants

Rencom Python SDK

Official Python SDK for the Rencom API - unified search for x402 resources and UCP merchants.

Features

• 🔍 x402 Resource Search - Discover APIs that accept blockchain payments
• 🏪 UCP Merchant Discovery - Find merchants and products on the Universal Commerce Protocol
• 🔐 Multiple Auth Methods - API keys, JWT, x402 payments
• 📊 Built-in Analytics - Session tracking and click logging
• ⚡ Async First - Built on httpx with full async/await support
• 🛡️ Type Safe - Fully typed with Pydantic models
• 🔄 Auto-pagination - Iterate through large result sets effortlessly

Installation

pip install rencom

Optional Dependencies

# CLI tools
pip install rencom[cli]

# x402 payment support
pip install rencom[x402]

# Development dependencies
pip install rencom[dev]

Quick Start

import asyncio
from rencom import AsyncRencomClient

async def main():
    # Initialize client with API key
    async with AsyncRencomClient(api_key="rk_...") as client:
        # Search x402 resources
        results = await client.x402.search("weather api")
        for result in results.results:
            print(f"{result.resource}: {result.description}")

        # Search UCP merchants
        merchants = await client.ucp.merchants.search(industry="retail")
        for merchant in merchants.results:
            print(f"{merchant.name}: {merchant.domain}")

if __name__ == "__main__":
    asyncio.run(main())

Documentation

• Full Documentation
• API Reference
• Examples
• Changelog

Authentication

API Key (Recommended)

from rencom import AsyncRencomClient

client = AsyncRencomClient(api_key="rk_...")

Environment Variable

export RENCOM_API_KEY="rk_..."

client = AsyncRencomClient()  # Auto-loads from env

JWT Token

# After email verification
client = AsyncRencomClient(jwt_token="eyJ...")

Usage Examples

See the examples/ directory for full working examples.

Development

Setup

git clone https://github.com/rencom-ai/rencom-sdk-python.git
cd rencom-sdk-python

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install with dev dependencies
pip install -e ".[dev]"

# Install pre-commit hooks
pre-commit install

Testing

# Run all tests
pytest

# Run only unit tests (fast)
pytest -m unit

# Run with coverage
pytest --cov=rencom --cov-report=html

Code Generation

The SDK auto-generates code from the OpenAPI specification:

python scripts/generate.py

Important: Never edit files in rencom/_generated/ manually - they will be overwritten.

Contributing

Contributions are welcome! Please read CONTRIBUTING.md for guidelines.

License

MIT License - see LICENSE for details.

Support

• Documentation
• Issue Tracker
• Discussions