BlockRun

Quick Start

Get started with BlockRun in under 5 minutes.

Prerequisites

  • An EVM wallet with USDC (Base network)
  • Python 3.8+ or Node.js 18+

Step 1: Install the SDK

{% tabs %} {% tab title="Python" %}

pip install blockrun-llm

{% endtab %}

{% tab title="TypeScript" %}

npm install @blockrun/llm
# or
pnpm add @blockrun/llm

{% endtab %} {% endtabs %}

Step 2: Set Your Wallet Key

Export your wallet's private key and set it as an environment variable:

export BLOCKRUN_WALLET_KEY=0x...your_private_key

{% hint style="info" %} Your private key never leaves your machine. It's only used to sign payment authorizations locally. {% endhint %}

Step 3: Make Your First Request

{% tabs %} {% tab title="Python" %}

from blockrun_llm import LLMClient

client = LLMClient()
response = client.chat("openai/gpt-4o", "What is the capital of France?")
print(response)
# Output: The capital of France is Paris.

{% endtab %}

{% tab title="TypeScript" %}

import { LLMClient } from '@blockrun/llm';

const client = new LLMClient({
  privateKey: process.env.BLOCKRUN_WALLET_KEY as `0x${string}`
});

const response = await client.chat('openai/gpt-4o', 'What is the capital of France?');
console.log(response);
// Output: The capital of France is Paris.

{% endtab %} {% endtabs %}

What Just Happened?

  1. Your request was sent to BlockRun's API
  2. BlockRun returned the price (a few cents in USDC)
  3. The SDK automatically signed a payment authorization
  4. The request was retried with the payment proof
  5. BlockRun called OpenAI and returned the response
  6. The USDC payment was settled on-chain

All of this happened automatically - you just wrote one line of code!

Next Steps