Skip to content

Lubitzy/Kleos

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Kleos — NFT Agent for Bankr

Kleos — AI NFT Agent for Bankr

License: MIT Platform: Bankr Version: 1.0.0 SKILL.md compatible

κλέος — the Greek concept of eternal glory earned through heroic deeds.
Kleos hunts NFT glory — sweeping floors, sniping mints, managing portfolios, and claiming airdrops.

Kleos is a Bankr skill that transforms your AI agent into a full-stack NFT trading machine. It works on Telegram, X (Twitter), and the Bankr web terminal — all through natural language.

Kleos Mascot
A geometric owl — the all-seeing AI agent. Golden left eye tracks profit, purple right eye computes strategy. Hexagonal body represents the decentralized network it scans.


Features

Module What It Does
Floor Sweeper Buy cheapest NFTs from any collection — single or batch. Auto-list at profit targets. Stop-loss protection. Multi-collection sweep.
Mint Sniper Discover upcoming NFT drops. Research collections before minting. Auto-mint when live. Post-mint floor monitoring.
Portfolio Manager Track PnL per NFT & collection. Floor price alerts. Bulk listing/offer management. Portfolio rebalancing. Watchlist.
Airdrop Checker On-chain eligibility scanning via contract queries, OpenSea API, and Etherscan. Multi-wallet support. Merkle proof verification. Scam detection. No browser wallet connection needed.
Batch Transfers Send multiple NFTs at once. Transfer to ENS, addresses, or Twitter handles.

All activity is logged to persistent memory (/.memory/nft-activity.md) for long-term PnL tracking.


Quick Install

In your Bankr agent (bankr.bot, Telegram, or X):

install the skill at https://github.com/Lubitzy/kleos/tree/main

That's it. Kleos activates automatically whenever you talk about NFTs.

Verify Installation

Test that Kleos is working with these quick commands:

"kleos, show my NFTs"
"what's minting today?"
"check if I hold any Pudgy Penguins"

Usage Examples

Floor Sweeping

"kleos, sweep 3 floor Based Punks on base"
"buy the cheapest Noun and auto-list at 2x"
"set stop loss on my Pudgy Penguins — sell if floor drops 30%"

Mint Sniping

"kleos, what's minting today?"
"monitor the Doodles mint and auto-mint 2 when it goes live"
"research this collection before I mint"

Portfolio Management

"kleos, show my NFT portfolio"
"list all my Nouns at 10% above floor"
"accept all offers above 0.5 ETH on my NFTs"
"alert me if any collection in my portfolio pumps 50%"

Airdrop Checking

"kleos, am I eligible for any airdrops?"
"check which airdrop phases I qualify for in Optimism"
"monitor new community airdrops and alert me"

Automation Presets

Kleos comes with ready-to-use Bankr automation presets. See presets/ for one-click setups:

Preset Command
Floor Monitor "every hour, check floor of [collection] and alert me if it moves >5%"
Mint Watcher "every day at 9am, show me what's minting today"
Portfolio Pulse "every 6 hours, show my NFT portfolio PnL"
Airdrop Scout "every day at 10am, search for new airdrops and check my eligibility"

→ View all presets


Memory System

Kleos saves state to your Bankr agent's persistent filesystem:

File Purpose
/.memory/nft-activity.md Timestamped log of all buys, sells, mints, transfers
/.memory/nft-watchlist.md Collections you're monitoring
/.memory/nft-airdrops.md Airdrops you're tracking or have claimed
/.memory/nft-targets.md Profit targets and stop losses for holdings

Supported Chains

NFT operations are available on: Base, Ethereum, Polygon, Unichain

Prefer Base — gas is sponsored by Bankr. Ethereum mainnet gas can exceed NFT value.


Requirements

  • A Bankr account (free tier works, Bankr Club recommended for automations)
  • NFT operations require sufficient ETH/WETH balance on the target chain

Structure

kleos/
├── SKILL.md                    # Core skill instructions
├── assets/
│   ├── Banner.png              # Repo banner
│   ├── Logo.png                # Kleos logo (owl + hexagon)
│   └── Mascot.png              # Geometric owl character
├── references/                 # Detailed workflow docs (loaded on demand)
│   ├── floor-sweeper.md        # Floor sweeping strategies
│   ├── mint-sniper.md          # Mint sniping workflows
│   ├── portfolio-manager.md    # Portfolio tracking & PnL
│   └── airdrop-checker.md      # Airdrop eligibility checking
├── presets/                    # Copy-paste automation commands
│   ├── sweeper.md
│   ├── sniper.md
│   ├── portfolio.md
│   └── airdrop.md
├── .github/                     # Issue templates
│   └── ISSUE_TEMPLATE/
│       ├── bug_report.md
│       └── feature_request.md
├── CHANGELOG.md                 # Version history
├── CONTRIBUTING.md              # Contribution guide
└── LICENSE                      # MIT

License

MIT © 2026 Kleos — free to use, modify, and distribute.

About

AI NFT Agent for Bankr — floor sweeper, mint sniper, portfolio manager, airdrop checker

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors