Paychain 🔗💰

Build AI agents that can send real money using natural language with LangChain and Payman. Paychain combines the power of LLMs with Payman's secure payment infrastructure to enable conversational financial transactions.

Why Paychain?

• 🤖 Natural Language Payments: Let AI agents process payments through simple conversations
• 🔒 Built on Payman: Leverage Payman's enterprise-grade payment infrastructure
• 🚀 Quick Integration: Get started in minutes with our Python SDK
• 💡 Flexible Tools: Rich set of Payman payment operations including sending, requesting, and managing payees
• 🛠️ Built with LangChain: Leverage the power of the LangChain ecosystem

Quick Start 🚀

1. Get your API keys:

   • Go to app.paymanai.com to get your Payman API key
   • Sign up takes just a few seconds and lets you send real money with Payman
   • Get your OpenAI API key from platform.openai.com

2. Clone the repository:

git clone <repository-url>
cd paychain-examples

3. Create and activate virtual environment:

python -m venv .venv
source .venv/bin/activate  # On Windows use: .venv\Scripts\activate

4. Install dependencies:

pip install -r requirements.txt

5. Create a .env file in the root directory:

PAYMAN_API_SECRET=your_payman_api_secret  # From app.paymanai.com
OPENAI_API_KEY=your_openai_api_key
PAYMAN_ENVIRONMENT=sandbox  # or production

6. Run the tests:

# Test basic payment functionality
python examples/test_payment.py

# Test AI agent with all payment tools
python examples/test_agent.py

Features ✨

• Direct payment processing
• AI agent with natural language payment processing
• Multiple payment tools:
  • Send payments
  • Search payees
  • Add new payees
  • Request money
  • Check balances

Project Structure 📁

paychain-examples/
├── .env                 # Environment variables (not in git)
├── .gitignore          # Git ignore file
├── requirements.txt    # Project dependencies
└── examples/           # Test examples
    ├── __init__.py
    └── test_agent.py   # AI agent test

Security 🔒

• Never commit your .env file
• Keep your API keys secure
• Use sandbox environment for testing

Contributing 🤝

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

License 📄

MIT