whatisgithub

What is base-agent?

bunnyos/base-agent — explained in plain English

Analysis updated 2026-05-18

113TypeScriptAudience · developerComplexity · 4/5Setup · hard

In one sentence

BunnyOS is an open source, self hosted AI agent for the Base blockchain that manages wallet chats, scheduled scanners, and DeFi tools without holding your private keys.

Mindmap

mindmap
  root((BunnyOS agent))
    What it does
      Wallet chat
      Background scanners
    Tech stack
      TypeScript
      PostgreSQL
      MCP
    Use cases
      DeFi monitoring
      Self hosted control
    Audience
      Developers
      Crypto users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Chat with an AI agent about your Base wallet and DeFi positions

USE CASE 2

Set up scheduled scanners that alert you to changes like a dropping yield

USE CASE 3

Connect to data providers like Moralis, CoinMarketCap, and DeFi Llama through MCP tools

USE CASE 4

Keep full control of private keys while approving transactions in the Base mobile app

What is it built with?

TypeScriptNode.jsPostgreSQLMCP

How does it compare?

bunnyos/base-agentamanayayatu-tech/alayafreestyle-voice/freestyle
Stars113113112
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardmoderateeasy
Complexity4/54/52/5
Audiencedeveloperpm foundergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires Node.js 24, pnpm, and PostgreSQL 18, plus running separate API and frontend processes.

Open source project, specific license terms are not detailed in the explanation.

So what is it?

BunnyOS is an open-source AI agent for the Base blockchain ecosystem. Base is a blockchain network built by Coinbase. The project describes itself as the first open-source agent built on top of Base MCP, which is a protocol that gives AI agents access to wallet and transaction tools on Base. The idea is that instead of using a proprietary service to interact with crypto on Base, users can run their own copy of the agent, inspect the code, and keep their private keys in their own hands. The agent has four main systems. The first handles chat and autonomous background scanners: users can have a conversation with the agent about their wallet and DeFi positions, and separately configure scheduled scanners that run automatically on intervals from one minute to twenty-four hours. Scanners generate either alerts (informational notices like a yield dropping) or recommendations (suggested actions with a button to execute them). The second system is a tab-based terminal interface where each tab has its own isolated context. The third is a memory system based on a markdown file that holds the user's preferences, risk tolerance, and other context, which is fed to the agent before each interaction. The fourth is a tool system built on MCP that connects to data providers including Moralis for on-chain history, CoinMarketCap for price data, DeFi Llama for protocol yield data, and Morpho for lending market data. The security model is explicit about one point: the agent never holds private keys. Any transaction it proposes requires the user to approve it separately in the Base mobile app. API keys stored in the database are encrypted at rest using AES-256-GCM. Self-hosting requires Node.js 24, pnpm, and PostgreSQL 18. Two processes run separately: an API server and a frontend interface. Configuration is done through an environment file with three required variables. The README was written by the two founders and explains at length why they chose open source: they argue that autonomous agents handling real money cannot be trusted if the code is closed and the operator has financial incentives tied to transaction volume.

Copy-paste prompts

Prompt 1
Help me set up the environment file and required variables to self host this agent
Prompt 2
Explain how the scanner system decides between sending an alert and a recommendation
Prompt 3
Walk me through how transaction approval works between this agent and the Base mobile app
Prompt 4
What does the markdown memory system store and how is it used before each interaction?

Frequently asked questions

What is base-agent?

BunnyOS is an open source, self hosted AI agent for the Base blockchain that manages wallet chats, scheduled scanners, and DeFi tools without holding your private keys.

What language is base-agent written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, PostgreSQL.

What license does base-agent use?

Open source project, specific license terms are not detailed in the explanation.

How hard is base-agent to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is base-agent for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.