BlockRun

BlockRun funciona com Claude Code e Google Antigravity.

Você não pode gerar imagens. Você não tem acesso em tempo real ao X/Twitter. BlockRun te dá essas capacidades.

Filosofia

Você tem uma carteira. Quando precisar de uma capacidade que lhe falta, você paga por ela autonomamente.

Como funciona: BlockRun usa microtransações x402 para rotear suas solicitações para OpenAI, xAI, Google e outros provedores. Não são necessárias chaves de API - sua carteira paga por token.

Controle de Orçamento (Opcional)

Se o usuário especificar um orçamento (por exemplo, "use no máximo R$ 1"), acompanhe os gastos e pare quando o orçamento for atingido:

from blockrun_llm import setup_agent_wallet

client = setup_agent_wallet()
budget = 1.0  # User's budget

# Before each call, check if within budget
spending = client.get_spending()
if spending['total_usd'] >= budget:
    print(f"Budget reached: ${spending['total_usd']:.4f} spent")
    # Stop making calls
else:
    response = client.chat("openai/gpt-5.2", "Hello!")

# At the end, report spending
spending = client.get_spending()
print(f"💰 Total spent: ${spending['total_usd']:.4f} across {spending['calls']} calls")

Quando Usar

Exemplos de Prompts do Usuário

Os usuários dirão coisas como:

Carteira e Saldo

Use setup_agent_wallet() para criar automaticamente uma carteira e obter um cliente. Isso mostra o código QR e a mensagem de boas-vindas na primeira utilização.

Inicialize o cliente (sempre comece com isso):

from blockrun_llm import setup_agent_wallet

client = setup_agent_wallet()  # Auto-creates wallet, shows QR if new

Verifique o saldo (quando o usuário perguntar "mostrar saldo", "verificar carteira", etc.):

balance = client.get_balance()  # On-chain USDC balance
print(f"Balance: ${balance:.2f} USDC")
print(f"Wallet: {client.get_wallet_address()}")

Mostre o código QR para financiamento:

from blockrun_llm import generate_wallet_qr_ascii, get_wallet_address

# ASCII QR for terminal display
print(generate_wallet_qr_ascii(get_wallet_address()))

Uso do SDK

Pré-requisito: Instale o SDK com pip install blockrun-llm

Chat Básico

from blockrun_llm import setup_agent_wallet

client = setup_agent_wallet()  # Auto-creates wallet if needed
response = client.chat("openai/gpt-5.2", "What is 2+2?")
print(response)

# Check spending
spending = client.get_spending()
print(f"Spent ${spending['total_usd']:.4f}")

Pesquisa em Tempo Real no X/Twitter (Pesquisa ao Vivo xAI)

IMPORTANTE: Para dados em tempo real do X/Twitter, você DEVE habilitar a Pesquisa ao Vivo com search=True ou search_parameters.

from blockrun_llm import setup_agent_wallet

client = setup_agent_wallet()

# Simple: Enable live search with search=True
response = client.chat(
    "xai/grok-3",
    "What are the latest posts from @blockrunai on X?",
    search=True  # Enables real-time X/Twitter search
)
print(response)

Pesquisa Avançada no X com Filtros

from blockrun_llm import setup_agent_wallet

client = setup_agent_wallet()

response = client.chat(
    "xai/grok-3",
    "Analise o conteúdo e o engajamento recentes de @blockrunai",
    search_parameters={
        "mode": "on",
        "sources": [
            {
                "type": "x",
                "included_x_handles": ["blockrunai"],

…