A Web3 workflow automation platform (forked from vercel-labs/workflow-builder-template) that enables users and Agents to create, manage, and execute blockchain automation workflows and tasks. Supports smart contract monitoring, token transfers, DeFi operations, and integrations with Discord, SendGrid, webhooks and more.
Users and Agents can build and deploy Web3 automation workflows through a visual builder or via the MCP server without writing code.
Quick setup (no install needed):
claude mcp add --transport http keeperhub https://app.keeperhub.com/mcpThen run /mcp inside Claude Code to authorize via browser. That's it.
Try asking Claude to "create a workflow that monitors a wallet".
Alternative: install the Claude Code plugin for skills and slash commands:
/plugin marketplace add KeeperHub/claude-plugins
/plugin install keeperhub@keeperhub-plugins
/keeperhub:loginRestart Claude Code after setup. Plugin source code.
- Visual Workflow Builder: Drag-and-drop interface for building blockchain automations
- Smart Contract Interactions: Read and write to smart contracts without writing code
- Multi-Chain Support: Ethereum Mainnet, Sepolia, Base, Arbitrum, and more
- Secure Wallet Management: Para-integrated MPC wallets with no private key exposure
- Notifications: Email, Discord, Slack, and webhook integrations
- Scheduling: Cron-based, event-driven, webhook, or manual triggers
- AI-Assisted Building: Describe automations in plain language
- Scheduled: Run at intervals (every 5 minutes, hourly, daily, custom cron)
- Webhook: Execute when external services call your workflow URL
- Event: React to blockchain events (token transfers, contract state changes)
- Manual: On-demand execution via UI or API
- Web3: Check Balance, Read Contract, Write Contract, Transfer Funds, Transfer Tokens
- Notifications: Send Email, Discord Message, Slack Message, Telegram Message
- Integrations: Send Webhook, custom HTTP requests
- Low balance detection
- Value comparisons
- Custom logic with AND/OR operators
- Node.js 18+
- PostgreSQL database
- pnpm package manager
Create a .env.local file:
# Database
DATABASE_URL=postgresql://user:password@localhost:5432/keeperhub
# Authentication
BETTER_AUTH_SECRET=your-secret-key
BETTER_AUTH_URL=http://localhost:3000
# AI (choose one)
OPENAI_API_KEY=your-openai-api-key
AI_MODEL=gpt-4o
# Para Wallet
PARA_API_KEY=your-para-api-key
PARA_ENVIRONMENT=beta
# Encryption
WALLET_ENCRYPTION_KEY=your-wallet-encryption-key
INTEGRATION_ENCRYPTION_KEY=your-integration-encryption-keypnpm install
pnpm db:push
pnpm devVisit http://localhost:3000 to get started.
For UI/API development without Docker:
pnpm install
pnpm db:push
pnpm devFull development stack with scheduled workflow execution:
make dev-setup # First time (starts services + migrations)
make dev-up # Subsequent starts
make dev-logs # View logs
make dev-down # Stop servicesServices: PostgreSQL (5433), LocalStack SQS (4566), Redis (6379), KeeperHub App (3000), Scheduler, Block Dispatcher, Event Tracker, Executor
For testing workflow execution in isolated K8s Job containers:
make hybrid-setup # Full setup
make hybrid-status # View status
make hybrid-down # Teardown# Development
pnpm dev # Start dev server
pnpm build # Production build
pnpm type-check # TypeScript check
pnpm check # Run linter
pnpm fix # Fix linting issues
# Database
pnpm db:push # Push schema changes
pnpm db:studio # Open Drizzle Studio
pnpm db:seed # Seed chain data
# Plugins
pnpm discover-plugins # Scan and register plugins
pnpm create-plugin # Create new plugin
# Testing
pnpm test # Run all tests
pnpm test:e2e # E2E tests| Service | Description | Source |
|---|---|---|
| App | Next.js application with workflow builder UI and API | app/, keeperhub/ |
| Scheduler | Evaluates cron schedules every minute, dispatches matching workflows to SQS | keeperhub-scheduler/schedule-dispatcher/ |
| Block | Monitors blockchain blocks via WebSocket, dispatches matching workflows to SQS | keeperhub-scheduler/block-dispatcher/ |
| Event | Monitors blockchain events and routes to SQS | keeperhub-events/event-tracker/ |
| Executor | Polls SQS for all trigger types, executes workflows in-process or as K8s Jobs | keeperhub-executor/ |
| Workflow Runner | Isolated container for executing web3 write workflows in K8s Jobs | keeperhub-executor/workflow-runner.ts |
All trigger services (scheduler, block, event) send messages to a shared SQS queue. The executor consumes from this queue and runs workflows in isolated K8s Job containers using the workflow-runner image. The execution mode is configurable via EXECUTION_MODE: isolated (default, all workflows in K8s Jobs), complex (K8s Jobs for web3 writes, in-process for everything else), or process (all in-process, no K8s).
- Framework: Next.js 16 (App Router) with React 19
- Language: TypeScript 5
- UI: shadcn/ui, Radix UI, Tailwind CSS 4
- Database: PostgreSQL with Drizzle ORM
- Workflow Engine: Workflow DevKit
- Authentication: Better Auth
- AI: Vercel AI SDK (OpenAI/Anthropic)
- Wallets: Para MPC integration
Plugins extend workflow capabilities. Located in keeperhub/plugins/:
web3- Blockchain operations (balance, transfers, contract calls)discord- Discord notificationssendgrid- Email via SendGridwebhook- HTTP integrationstelegram- Telegram notifications
Base URL: https://app.keeperhub.com/api
| Resource | Description |
|---|---|
/api/workflows |
CRUD for workflows |
/api/workflows/{id}/execute |
Execute a workflow |
/api/workflows/{id}/executions |
Execution history |
/api/integrations |
Manage connections |
/api/chains |
Supported networks |
See API Documentation for full reference.
Prometheus metrics exposed at /api/metrics:
- Workflow execution performance
- API latency
- Plugin action metrics
- User and organization stats
See Metrics Reference for details.
Full documentation available at docs.keeperhub.com or in the docs/ directory:
Apache 2.0