O Agente Econômico Autônomo

O agente de IA
com carteira.

Outros agentes escrevem código. Franklin escreve código e gasta dinheiro para entregar — modelos, dados, imagens, busca. Você define o orçamento. Ele executa.

Open source · MIT licensed · Built by the BlockRun team. Trusted by developers shipping autonomous agents on Base and Solana.

Built on USDC · Base · Solana · x402 · routes across 60+ frontier models from Anthropic, OpenAI, Google, DeepSeek, Moonshot and Z.AI.

See it run

Five tasks. Five runs. Five receipts.

A real Franklin Agent session. Each command spawns calls to a routed model, pays per call in USDC, and prints the cost.

~ franklin --trustLIVE
claude-opus-4.6·$4.80 USDC·esc para abortar
Quatro Capítulos

O que uma carteira
muda.

Inteligência de código é o básico. A diferença é poder de compra — e a disciplina silenciosa de um agente que precisa fechar o próprio caixa.

Chapter 01
A Carteira

Software que pode gastar dinheiro.

Franklin guarda USDC em Base ou Solana. Quando precisa de um modelo, um feed de dados ou uma imagem — ele assina o pagamento e leva. Não-custodial. Suas chaves ficam na sua máquina. Você define um teto; ele respeita.

USDC · BaseNon-Custodial
24.37USDC
0x8F3a · c92D · 1E4b · f70A · · · autonomy = $0.50 / session cap
▸ claude-sonnet-4.6 · refactor auth.ts−$0.041
▸ coingecko · BTC/USD signal−$0.002
▸ dall·e 3 · hero logo, 1024²−$0.040
▸ exa · neural web search (4)−$0.012
▸ kimi-k2.6 · context compaction−$0.004
◆ x402 · EIP-712Session: f3a · 18s
Chapter 02
Trading

Compra dados. Lê o tape. Decide.

Pergunte “como está o BTC?” e Franklin compra preços ao vivo, calcula RSI, MACD, Bollinger e volatilidade localmente, e devolve um sinal. Um único prompt. Sem cinco abas no navegador, sem espaguete de API key.

◆ BTC№ 04.20.26
Signal Report · Bitcoin
30-day window · bullish
$71,056▲ 2.3% · 24hMCAP $1.42T · VOL $29.6B
RSI (14)
53.2
neutral
MACD
339.21
bullish cross
Bollinger
mid-band
$64.5k — $73.8k
Volatility
35.3%
annualized
Bullish Momentum

Entry $65,000 · stop $63,200 (−2.8%) · risk $27.69 · target $70k · R/R 1:2.8 ✓

Authored · Franklin / Opus 4.8Cost · $0.031 USDC
Chapter 03
Smart Router

60+ modelos. Ele escolhe. Você economiza.

Nenhum modelo é o melhor em tudo. O router classifica cada requisição e roteia em menos de um milissegundo. Treinado em 2M+ requisições reais, pontuado por Elo continuamente, adapta-se aos seus overrides. Até 89% de economia vs. always-Opus.

Session Ledger · /cost23 reqs · 4 categories · saved 67%
refactor src/auth.ts to use the new jwt helper
CODING
kimi-k2.6
$0.0023
↓ 84%
what's the BTC outlook for the week?
TRADING
grok-4-1-fast
$0.0008
↓ 95%
prove this algorithm is O(n log n)
REASONING
claude-sonnet-4.6
$0.0312
priced
compare the top 5 AI agent pricing models
RESEARCH
gemini-2.5-flash
$0.0012
↓ 91%
Session total · $0.0847Saved vs. Opus-only · $0.174
Chapter 04
Aprende com você

Fica mais inteligente a cada sessão.

Claude Code esquece entre execuções. Franklin extrai preferências — linguagem, estilo, escolhas de modelo, workflow — e injeta na próxima sessão. Padrões confirmados ganham confiança. Os obsoletos decaem em 30 dias.

Learnings /learnings7 confirmed · 2 decaying
Primary Language
TypeScript · strict mode
confirmed · 42 sess
Commit Style
Conventional · no scope
confirmed · 38 sess
Preferred Coder
kimi-k2.6 over sonnet for refactors
confirmed · 19 sess
Test Runner
vitest · watch mode
confirmed · 24 sess
Reply Tone
terse · no apologies
confirmed · 51 sess
Trading Pair Focus
BTC, ETH, SOL
decaying · 6d silent
Preço · Instalação · Fundo

Pague pelo resultado,
nada além disso.

◆ HTTP◆ x402◆ EIP-712◆ USDC
402
You Only Pay Outcome · YOPO
Custo do provider + 5%, assinado por ação.

Sem assinatura (você não paga pelo acesso). Sem pay-per-call (você não paga por tentativa que falhou). O saldo da carteira é o teto duro. Quando zera, Franklin para. É todo o modelo de preço.

01

Instale

Um comando npm. Node 20+. macOS, Linux, WSL.

npm i -g @blockrun/franklin
02

Rode grátis

NVIDIA Nemotron e DeepSeek V4 Flash gratuitos de fábrica. Sem carteira.

franklin
03

Carregue ($5 já basta)

Gere uma carteira em Base ou Solana. Envie USDC. Libere todos os modelos de fronteira.

franklin setup base
04

Diga o resultado desejado

Codar, tradar, pesquisar, gerar — Franklin escolhe, paga, reporta, para.

franklin --trust
Slash Commands · 18 nativos
/model [name]
Seletor interativo ou troca direta
/plan · /execute
Planejamento somente-leitura, depois executa
/ultrathink <q>
Raciocínio profundo para problemas difíceis
/compact
Compressão estruturada de contexto
/search <q>
Busca no codebase
/session-search
Full-text em sessões anteriores
/history · /resume
Inspecione ou restaure qualquer sessão
/commit · /push · /pr
Helpers de workflow Git
/review · /fix · /test
Revisão, bugfix e testes em um comando
/cost · /wallet
Gasto da sessão + endereço + saldo
/insights [--days N]
Detalhamento de gastos e tendências
/learnings
O que Franklin já aprendeu
O Razão

Numa tabela,
para ficar claro.

Produtos de IA vendem acesso. Assinaturas entregam culpa mensal e rate limit. Pay-per-call cobra cada tentativa que falhou. Franklin liquida pelo resultado — uma vez, em USDC.

SaaS por assinaturaAPI pay-per-callFranklin — YOPO
Você paga porAcesso, usado ou nãoCada tentativa, inclusive becos sem saídaO resultado. Uma vez.
Mensalidade$20 — $200$0, mais o uso$0. Pague só o que gastar.
Rate limitsSim. Aperta justo quando você mais precisa.Cotas por chave, tiersNenhum. O saldo da carteira é o único teto.
IdentidadeE-mail + cartão de créditoConta no fornecedor, API keys por modeloUma carteira. Sem e-mail, sem KYC.
Escolha de modeloFornecedor únicoVocê malabaria 12 chaves60+ modelos por uma carteira · o router decide.
Queda do providerVocê parou.Você parou.Roteia para o próximo provider.
Risco de estouroRenovação automática silenciosaConta sem teto no fim do mêsNenhum. Carteira vazia ⇒ Franklin para.
Código-fonteFechadoSDK fechadoApache 2.0 · local-first.
O Comum · Apache 2.0

Você é dono de
tudo.

Seus dados
~/.blockrun/
Sua carteira
Chaves privadas · locais
Seus modelos
60+ · troca em 1 cmd
Sua licença
Apache 2.0
Seu uptime
Forke. Self-host.

Em ferramentas de IA fechadas, o fornecedor é dono dos seus dados de uso, das suas preferências, do seu histórico. Eles mudam os termos — você aceita. Sobem o preço — você paga. Caem — você para.

Franklin é Apache 2.0 e roda na sua máquina. Chaves da carteira, histórico de sessões, aprendizados — tudo fica em ~/.blockrun/. Zero telemetria. Nada liga pra casa.

Se a BlockRun sumir amanhã, seu USDC continua na sua carteira e seu agente continua rodando. É essa a ideia.

Leia cada linha: o loop completo do agente, as 16 ferramentas nativas, o SDK de plugins, o cliente x402, o router — está tudo no repo. Audite, forke, lance sua própria vertical.

Despachos

Direto da
bancada.

Notas sobre agentes de código multi-modelo, IA wallet-native e modelos de fronteira para devs sem cartão de crédito internacional.

Todos os posts →
№ 04

Dei ao Franklin US$ 20 e um roteiro. Três horas depois eu tinha um vídeo.

A maioria dos agentes para no código. O Franklin não — ele compra o roteiro, gera o storyboard com gpt-image-2, renderiza os clipes no Seedance, dubla a narração e licencia a música, tudo de uma carteira só. Aqui está o recibo linha por linha e por que nenhum outro agente conseguiria produzir isso.

BlockRunRead
№ 03

Modelos de fronteira para a metade do mundo sem cartão de crédito

Se você mora na China, Rússia, Indonésia, Paquistão ou Arábia Saudita, seu acesso à IA de fronteira é barrado por uma Visa que você não pode obter. O Franklin é uma carteira USDC, 55+ modelos, sem cartão. A geografia da inferência, redesenhada.

6 minRead
№ 02

Multi-modelo ou morte: por que seu agente de código não deveria apostar em um só fornecedor

O Claude Code queimou 27% do limite semanal de um usuário em loops de retry com saída zero. O Cursor cai por horas. O Copilot não alcança o Grok. O Franklin é o agente open-source que roteia entre 55 modelos, começa grátis sem cadastro, e para de cobrar no momento em que não há nada para entregar.

5 minRead
№ 01

Seu agente de IA deveria pagar suas próprias contas

Assinaturas precificam de forma plana o que é volátil. API keys amarram identidade a fornecedores. A solução não é um dashboard melhor — é dar ao agente sua própria carteira, um teto duro, e as chaves de sua conta bancária.

BlockRunRead
Perguntas

Dúvidas,
respondidas.

O modelo do agente econômico autônomo em português claro. Sem rodeios.

Eles escrevem ótimo código. Não conseguem gastar dinheiro. Não compram dados de trading, chamadas de API, geração de imagem ou bill de busca web. Franklin consegue — porque carrega uma carteira USDC e paga por ação via x402. Inteligência de código é o básico; autonomia econômica é a categoria.

Franklin guarda USDC em Base ou Solana. Quando precisa de um modelo, um feed ou um serviço, assina um micropagamento EIP-712 e paga. Você define o orçamento; Franklin respeita. Cada centavo é rastreado em tempo real. Sem assinaturas, sem API keys, sem portal de billing.

60+ modelos de IA (Claude, GPT, Gemini, Grok, DeepSeek, Kimi, etc.), geração de imagem (GPT Image, Nano Banana, Grok Imagine), geração de vídeo, busca web neural Exa, dados de prediction markets (Polymarket, Kalshi), inteligência X/Twitter, geração de música. O Smart Router escolhe o melhor modelo por tarefa — até 89% de economia vs always-Opus.

YOPO — You Only Pay Outcome. Custo do provider + 5%, liquidado por chamada em USDC. Pergunta simples: ~$0,001. Sessão de código: $0,02–$0,10. Sessão profunda de 30 minutos: $0,10–$0,50. Sem assinatura, sem mensalidade, sem rate limit. Os modelos NVIDIA gratuitos estão sempre disponíveis a custo zero — sem precisar de carteira.

Aprende. Depois de cada sessão Franklin extrai preferências — linguagem, estilo, escolhas de modelo, workflow — e injeta na próxima execução. Preferências confirmadas ganham confiança. As obsoletas decaem em 30 dias. Rode /learnings para ver o que ele sabe.

Tudo fica local em ~/.blockrun/. Histórico de sessões, aprendizados, chaves da carteira — nada liga pra casa. Zero telemetria, zero crash report. Suas chaves privadas nunca saem da sua máquina. O código é Apache 2.0 — audite cada linha.

Pode. Os modelos NVIDIA gratuitos (Nemotron, DeepSeek V4 Flash) funcionam sem carteira, sem USDC, sem cadastro. Carregue a carteira só quando quiser Sonnet, Opus, GPT, Gemini, Grok ou ferramentas pagas.

Finalidade rápida, taxas irrisórias, suporte maduro a USDC e um ecossistema x402 real nas duas. Você escolhe na configuração e pode trocar quando quiser. Mesma UX de carteira, mesmos modelos, trilhos diferentes.

Franklin Agent

Run an Economic Agent.
Stop watching agents fail at money.

Install Franklin Agent