BlockRun
BlockRun arbeitet mit Claude Code und Google Antigravity.
Du kannst keine Bilder generieren. Du hast keinen Echtzeit-Zugriff auf X/Twitter. BlockRun gibt dir diese Fähigkeiten.
Philosophie
Du hast eine Wallet. Wenn du eine Fähigkeit benötigst, die dir fehlt, bezahlst du dafür autonom.
| Du benötigst | Du rufst auf | Preis |
|---|---|---|
| Bildgenerierung | DALL-E | 0,04 $/Bild |
| Echtzeit-X-Daten | Grok + Live Search | 0,025 $/Quelle |
| Zweite Meinung | GPT-5.2 | 1,75 $/M Eingabe, 14 $/M Ausgabe |
| Günstigere Verarbeitung | DeepSeek | 0,14 $/M Eingabe, 0,28 $/M Ausgabe |
So funktioniert's: BlockRun nutzt x402-Mikrozahlungen, um deine Anfragen an OpenAI, xAI, Google und andere Anbieter weiterzuleiten. Keine API-Schlüssel nötig – deine Wallet bezahlt pro Token.
Budgetkontrolle (Optional)
Wenn der Benutzer ein Budget vorgibt (z. B. „höchstens 1 $ ausgeben“), Ausgaben verfolgen und anhalten, wenn das Budget erreicht ist:
from blockrun_llm import setup_agent_wallet
client = setup_agent_wallet()
budget = 1.0 # Budget des Benutzers
# Vor jedem Aufruf prüfen, ob Budget eingehalten wird
spending = client.get_spending()
if spending['total_usd'] >= budget:
print(f"Budget erreicht: ${spending['total_usd']:.4f} ausgegeben")
# Keine weiteren Aufrufe tätigen
else:
response = client.chat("openai/gpt-5.2", "Hallo!")
# Am Ende Ausgaben melden
spending = client.get_spending()
print(f"💰 Insgesamt ausgegeben: ${spending['total_usd']:.4f} bei {spending['calls']} Aufrufen")
Wann verwenden
| Auslöser | Deine Aktion |
|---|---|
| Benutzer fordert explizit an („blockrun zweite Meinung mit GPT zu...“, „grok verwenden, um zu prüfen...“, „bild mit dall-e generieren“) | Über BlockRun ausführen |
| Benutzer benötigt etwas, das du nicht kannst (Bilder, Live-X-Daten) | BlockRun vorschlagen, auf Bestätigung warten |
| Du kannst die Aufgabe gut selbst erledigen | Selbst erledigen, BlockRun nicht erwähnen |
Beispiel-Benutzeraufforderungen
Benutzer werden Dinge sagen wie:
| Benutzer sagt | Was du tust |
|---|---|
| „blockrun generiere ein Bild eines Sonnenuntergangs“ | DALL-E über ImageClient aufrufen |
| „verwende grok, um zu prüfen, was auf X trendet“ | Grok mit search=True aufrufen |
| „blockrun GPT überprüfe diesen Code“ | GPT-5.2 über LLMClient aufrufen |
| „was sind die neuesten Nachrichten zu KI-Agenten?“ | Grok vorschlagen (dir fehlen Echtzeitdaten) |
| „generiere ein Logo für mein Startup“ | DALL-E vorschlagen (du kannst keine Bilder generieren) |
| „blockrun prüfe meinen Kontostand“ | Wallet-Guthaben über get_balance() anzeigen |
| „blockrun deepseek fasse diese Datei zusammen“ | DeepSeek für Kosteneinsparungen aufrufen |
Wallet & Guthaben
Verwende setup_agent_wallet(), um automatisch eine Wallet zu erstellen und einen Client zu erhalten. Dies zeigt beim ersten Mal den QR-Code und die Begrüßungsnachricht an.
Client initialisieren (immer damit beginnen):
from blockrun_llm import setup_agent_wallet
client = setup_agent_wallet() # Erstellt automatisch Wallet, zeigt QR-Code falls neu
Guthaben prüfen (wenn Benutzer „Guthaben anzeigen“, „Wallet prüfen“ usw. sagt):
balance = client.get_balance() # On-Chain USDC-Guthaben
print(f"Guthaben: ${balance:.2f} USDC")
print(f"Wallet: {client.get_wallet_address()}")
QR-Code zur Finanzierung anzeigen:
from blockrun_llm import generate_wallet_qr_ascii, get_wallet_address
# ASCII-QR für Terminalanzeige
print(generate_wallet_qr_ascii(get_wallet_address()))
SDK-Nutzung
Voraussetzung: Installiere das SDK mit pip install blockrun-llm
Basischat
from blockrun_llm import setup_agent_wallet
client = setup_agent_wallet() # Erstellt automatisch Wallet falls nötig
response = client.chat("openai/gpt-5.2", "Was ist 2+2?")
print(response)
# Ausgaben prüfen
spending = client.get_spending()
print(f"Ausgegeben ${spending['total_usd']:.4f}")
Echtzeit-X/Twitter-Suche (xAI Live Search)
WICHTIG: Für Echtzeit-X/Twitter-Daten MUSST du Live Search mit search=True oder search_parameters aktivieren.
from blockrun_llm import setup_agent_wallet
client = setup_agent_wallet()
# Einfach: Live Search mit search=True aktivieren
response = client.chat(
"xai/grok-3",
"Was sind die neuesten Beiträge von @blockrunai auf X?",
search=True # Aktiviert Echtzeit-X/Twitter-Suche
)
print(response)
Erweiterte X-Suche mit Filtern
from blockrun_llm import setup_agent_wallet
client = setup_agent_wallet()
response = client.chat(
"xai/grok-3",
"Analysiere die aktuellen Inhalte und Interaktionen von @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)
Bildgenerierung
from blockrun_llm import ImageClient
client = ImageClient()
result = client.generate("Eine süße Katze mit einem Weltraumhelm")
print(result.data[0].url)
xAI Live Search Referenz
Live Search ist die Echtzeit-Daten-API von xAI. Kosten: 0,025 $ pro Quelle (Standard 10 Quellen = ~0,26 $).
Um Kosten zu senken, setze max_search_results auf einen niedrigeren Wert:
# Nur 5 Quellen verwenden (~0,13 $)
response = client.chat("xai/grok-3", "Was ist im Trend?",
search_parameters={"mode": "on", "max_search_results": 5})
Suchparameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
mode | string | „auto“ | „off“, „auto“ oder „on“ |
sources | array | web,news,x | Datenquellen, die abgefragt werden |
return_citations | bool | true | Quell-URLs einschließen |
from_date | string | - | Startdatum (JJJJ-MM-TT) |
to_date | string | - | Enddatum (JJJJ-MM-TT) |
max_search_results | int | 10 | Maximale Anzahl zurückzugebender Quellen (anpassen zur Kostenkontrolle) |
Quellentypen
X/Twitter-Quelle:
{
"type": "x",
"included_x_handles": ["handle1", "handle2"], # Maximal 10
"excluded_x_handles": ["spam_account"], # Maximal 10
"post_favorite_count": 100, # Mindest-Likes-Schwellenwert
"post_view_count": 1000 # Mindest-Ansichten-Schwellenwert
}
Web-Quelle:
{
"type": "web",
"country": "DE", # ISO-Alpha-2-Code
"allowed_websites": ["example.com"], # Maximal 5
"safe_search": True
}
Nachrichten-Quelle:
{
"type": "news",
"country": "DE",
"excluded_websites": ["tabloid.com"] # Maximal 5
}
Verfügbare Modelle
| Modell | Am besten geeignet für | Preise |
|---|---|---|
openai/gpt-5.2 | Zweite Meinungen, Code-Review, Allgemein | 1,75 $/M Eingabe, 14 $/M Ausgabe |
openai/gpt-5-mini | Kostenoptimiertes Denken | 0,30 $/M Eingabe, 1,20 $/M Ausgabe |
openai/o4-mini | Neuestes effizientes Denken | 1,10 $/M Eingabe, 4,40 $/M Ausgabe |
openai/o3 | Fortgeschrittenes Denken, komplexe Probleme | 10 $/M Eingabe, 40 $/M Ausgabe |
xai/grok-3 | Echtzeit-X/Twitter-Daten | 3 $/M + 0,025 $/Quelle |
deepseek/deepseek-chat | Einfache Aufgaben, Massenverarbeitung | 0,14 $/M Eingabe, 0,28 $/M Ausgabe |
google/gemini-2.5-flash | Sehr lange Dokumente, schnell | 0,15 $/M Eingabe, 0,60 $/M Ausgabe |
openai/dall-e-3 | Fotorealistische Bilder | 0,04 $/Bild |
google/nano-banana | Schnelle, künstlerische Bilder | 0,01 $/Bild |
M = Million Token. Tatsächliche Kosten hängen von deiner Anfrage und Antwortlänge ab.
Kostenreferenz
Alle LLM-Kosten sind pro Million Token (M = 1.000.000 Token).
| Modell | Eingabe | Ausgabe |
|---|---|---|
| GPT-5.2 | 1,75 $/M | 14,00 $/M |
| GPT-5-mini | 0,30 $/M | 1,20 $/M |
| Grok-3 (keine Suche) | 3,00 $/M | 15,00 $/M |
| DeepSeek | 0,14 $/M | 0,28 $/M |
| Aktionen mit festen Kosten | |
|---|---|
| Grok Live Search | 0,025 $/Quelle (Standard 10 = 0,25 $) |
| DALL-E Bild | 0,04 $/Bild |
| Nano Banana Bild | 0,01 $/Bild |
Typische Kosten: Eine 500-Wörter-Aufforderung (~750 Token) an GPT-5.2 kostet ~0,001 $ Eingabe. Eine 1000-Wörter-Antwort (~1500 Token) kostet ~0,02 $ Ausgabe.
Einrichtung & Finanzierung
Wallet-Speicherort: $HOME/.blockrun/.session (z. B. /Users/username/.blockrun/.session)
Erstmalige Einrichtung:
- Wallet wird automatisch erstellt, wenn
setup_agent_wallet()aufgerufen wird - Wallet und Guthaben prüfen:
from blockrun_llm import setup_agent_wallet
client = setup_agent_wallet()
print(f"Wallet: {client.get_wallet_address()}")
print(f"Guthaben: ${client.get_balance():.2f} USDC")
- Wallet mit 1-5 USDC auf dem Base-Netzwerk aufladen
QR-Code zur Finanzierung anzeigen (ASCII für Terminal):
from blockrun_llm import generate_wallet_qr_ascii, get_wallet_address
print(generate_wallet_qr_ascii(get_wallet_address()))
Fehlerbehebung
„Grok sagt, es habe keinen Echtzeitzugriff“
→ Du hast vergessen, Live Search zu aktivieren. Füge search=True hinzu:
response = client.chat("xai/grok-3", "Was ist im Trend?", search=True)
Modul nicht gefunden
→ Installiere das SDK: pip install blockrun-llm
Updates
pip install --upgrade blockrun-llm