Installation

Zirzir offers two paths to getting started:

1. Developer CLI & Standalone Binary — manage local server, scaffolding, AI MCP, and backups.
2. Unified SDKs — integrate African payment rails directly into your TypeScript or Python applications.

---

⚡ 1. Developer CLI Installation

Install the pre-compiled standalone zirzir binary via our one-line installer:

curl -fsSL https://zirzir.dev/install.sh | sh

Verify your CLI installation:

zirzir --help
zirzir --version

---

📦 2. TypeScript / Node.js SDK

Install the @zirzir/sdk package via your preferred package manager:

# bun (recommended)
bun add @zirzir/sdk

# npm
npm install @zirzir/sdk

# pnpm
pnpm add @zirzir/sdk

TypeScript Usage

import { Zirzir } from '@zirzir/sdk';

const zirzir = new Zirzir({
  baseUrl: 'http://localhost:8080',
  apiKey: process.env.ZIRZIR_API_KEY!,
});

---

🐍 3. Python SDK

Install the official Python package via pip:

pip install zirzir

Python Usage

from zirzir import Zirzir

client = Zirzir(
    base_url="http://localhost:8080",
    api_key="zz_test_..."
)

---

Next Steps

• Configuration — set up your project and provider credentials
• Your First Payment — charge a customer in 10 lines of code
• Developer CLI — authenticate and test payments from terminal