Skip to content

Installation

This guide covers how to install the Nevermined Payments Python SDK.

Overview

The Nevermined Payments Python SDK (payments-py) is a Python library that provides tools for integrating AI agent monetization and access control into your applications. It supports:

  • Payment plans (credits-based and time-based)
  • AI agent registration and management
  • X402 payment protocol
  • MCP (Model Context Protocol) integration
  • A2A (Agent-to-Agent) protocol support

Prerequisites

Before installing the SDK, ensure you have:

  • Python 3.10 or higher - The SDK requires Python 3.10+
  • pip or Poetry - Package manager for installation
  • Nevermined API Key - Obtain from the Nevermined App

Installation Steps

Using pip

pip install payments-py

Using Poetry

poetry add payments-py

With Optional Dependencies

For FastAPI/x402 middleware support:

# Using pip
pip install payments-py[fastapi]

# Using Poetry
poetry add payments-py -E fastapi

Verify Installation

After installation, verify the SDK is working:

from payments_py import Payments, PaymentOptions

# Check version
import payments_py
print(f"payments-py installed successfully")

Environment Setup

Create a .env file or set environment variables:

# Required
NVM_API_KEY=nvm:your-api-key-here

# Optional (for custom environments)
NVM_BACKEND_URL=https://api.sandbox.nevermined.app
NVM_PROXY_URL=https://proxy.sandbox.nevermined.app

Next Steps

Once installed, proceed to Initializing the Library to configure the SDK.