Blockrun

BlockRun

BlockRun funciona com Claude Code e Google Antigravity.

Você não consegue gerar imagens. Você não tem acesso em tempo real ao X/Twitter. BlockRun oferece essas capacidades.

Filosofia

Você tem uma carteira. Quando precisa de uma capacidade que não tem, você a paga autonomamente.

Como funciona: BlockRun usa micropagamentos x402 para rotear suas solicitações para OpenAI, xAI, Google e outros provedores. Sem necessidade de chaves de API - sua carteira paga por token.

Controle de Orçamento (Opcional)

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

from blockrun_llm import setup_agent_wallet

client = setup_agent_wallet()
budget = 1.0  # Orçamento do usuário

# Antes de cada chamada, verifique se está dentro do orçamento
spending = client.get_spending()
if spending['total_usd'] >= budget:
    print(f"Orçamento atingido: ${spending['total_usd']:.4f} gastos")
    # Pare de fazer chamadas
else:
    response = client.chat("openai/gpt-5.2", "Olá!")

# No final, relatar gastos
spending = client.get_spending()
print(f"💰 Total gasto: ${spending['total_usd']:.4f} em {spending['calls']} chamadas")

Quando Usar

Exemplos de Prompts de Usuário

Usuários dirão coisas como:

Carteira e Saldo

Use setup_agent_wallet() para criar automaticamente uma carteira e obter um cliente. Mostra o código QR e mensagem de boas-vindas no primeiro uso.

Inicializar cliente (sempre comece com isso):

from blockrun_llm import setup_agent_wallet

client = setup_agent_wallet()  # Cria carteira automaticamente, mostra QR se novo

Verificar saldo (quando usuário pede "mostrar saldo", "verificar carteira", etc.):

balance = client.get_balance()  # Saldo USDC on-chain
print(f"Saldo: ${balance:.2f} USDC")
print(f"Carteira: {client.get_wallet_address()}")

Mostrar código QR para financiamento:

from blockrun_llm import generate_wallet_qr_ascii, get_wallet_address

# QR ASCII para exibição em terminal
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()  # Cria carteira automaticamente se necessário
response = client.chat("openai/gpt-5.2", "Quanto é 2+2?")
print(response)

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

Busca em Tempo Real do X/Twitter (xAI Live Search)

IMPORTANTE: Para dados em tempo real do X/Twitter, você DEVE ativar Live Search com search=True ou search_parameters.

from blockrun_llm import setup_agent_wallet

client = setup_agent_wallet()

# Simples: Ativar busca em tempo real com search=True
response = client.chat(
    "xai/grok-3",
    "Quais são as postagens mais recentes de @blockrunai no X?",
    search=True  # Ativa busca em tempo real do X/Twitter
)
print(response)

Busca 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 recente e engajamento de @blockrunai",
    search_parameters={
        "mode": "on",
        "sources": [
            {
                "type": "x",
                "included_x_handles": ["blockrunai"],
                "post_favorite_count": 5
            }
        ],
        "max_search_results": 20,
        "return_citations": True
    }
)
print(response)

Geração de Imagens

from blockrun_llm import ImageClient

client = ImageClient()
result = client.generate("Um gato fofo usando um capacete de astronauta")
print(result.data[0].url)

Referência xAI Live Search

Live Search é a API de dados em tempo real da xAI. Custo: $0.025 por fonte (padrão 10 fontes = ~$0.26).

Para reduzir custos, defina max_search_results para um valor menor:

# Use apenas 5 fontes (~$0.13)
response = client.chat("xai/grok-3", "O que está em tendência?",
    search_parameters={"mode": "on", "max_search_results": 5})

Parâmetros de Busca

Tipos de Fonte

Fonte X/Twitter:

{
    "type": "x",
    "included_x_handles": ["handle1", "handle2"],  # Máx 10
    "excluded_x_handles": ["spam_account"],        # Máx 10
    "post_favorite_count": 100,  # Limiar mín de curtidas
    "post_view_count": 1000      # Limiar mín de visualizações
}

Fonte Web:

{
    "type": "web",
    "country": "US",  # Código alpha-2 ISO
    "allowed_websites": ["example.com"],  # Máx 5
    "safe_search": True
}

Fonte de Notícias:

{
    "type": "news",
    "country": "US",
    "excluded_websites": ["tabloid.com"]  # Máx 5
}

Modelos Disponíveis

M = milhão de tokens. O custo real depende do comprimento do seu prompt e resposta.

Referência de Custo

Todos os custos de LLM são por milhão de tokens (M = 1.000.000 tokens).

Custos típicos: Um prompt de 500 palavras (750 tokens) para GPT-5.2 custa ~$0.001 entrada. Uma resposta de 1000 palavras (1500 tokens) custa ~$0.02 saída.

Setup e Financiamento

Localização da carteira: $HOME/.blockrun/.session (ex: /Users/username/.blockrun/.session)

Setup pela primeira vez:

1. Carteira se cria automaticamente quando setup_agent_wallet() é chamado
2. Verifique carteira e saldo:

from blockrun_llm import setup_agent_wallet
client = setup_agent_wallet()
print(f"Carteira: {client.get_wallet_address()}")
print(f"Saldo: ${client.get_balance():.2f} USDC")

3. Financie a carteira com $1-5 USDC na rede Base

Mostrar código QR para financiamento (ASCII para terminal):

from blockrun_llm import generate_wallet_qr_ascii, get_wallet_address
print(generate_wallet_qr_ascii(get_wallet_address()))

Solução de Problemas

"Grok diz que não tem acesso em tempo real" → Você esqueceu de ativar Live Search. Adicione search=True:

response = client.chat("xai/grok-3", "O que está em tendência?", search=True)

Módulo não encontrado → Instale o SDK: pip install blockrun-llm

Atualizações

pip install --upgrade blockrun-llm