Autonomous Solanatrading agent

Tracks smart money, browses any website, searches Google, runs shell commands, learns from performance, trades on autopilot. Terminal + Telegram.

90sSuggestion cycle
7Architecture layers
8Browser steps per task
24/7Autonomous engine
Capabilities

Most tools show you data.
KOWL tells you what to do.

suggest01

Smart Trade Suggestions

Every 90 seconds, scans smart money DEX trades, detects convergence (2+ wallets buying same token), evaluates with KOWL Score, and sends actionable suggestions with one-tap execution.

scan02

Token Scanner (KOWL Score)

Send any token address for full analysis. KOWL Score evaluates 8 factors: smart money presence, holder concentration, liquidity depth, trader behavior, buy/sell pressure, mint authority, volume trends, and token maturity.

auto03

Auto Mode

Fully autonomous trading. Max trade size configurable (default 0.05 SOL), min KOWL Score 40, min liquidity $5K. Auto TP at +100% (sells 50%), SL at -50% (sells all). Turn off anytime.

browser04

Browser Agent

Controls a real Chrome browser like a human. Opens DexScreener, PumpFun, X/Twitter, Google -- clicks, types, scrolls, extracts data. AI decides every step. Up to 8 steps per task.

portfolio05

Portfolio & PnL

Watches open positions every 5 minutes against entry price. Take profit at +50%, stop loss at -30%. In auto mode, sells 50% at +100%, closes at -50%. Commands: holdings, pnl, stats, wallet.

learn06

Self-Learning Engine

Analyzes closed trades every 30 minutes. Tracks win rates by signal type (convergence, high score, low score), adjusts behavior based on what actually works for you.

briefing07

Daily Briefing

Every morning at 9 AM: wallet balance, portfolio value, smart money activity overnight, convergence alerts, and an AI market take to start your day.

skills08

Skill Registry

Modular skill system. Create your own or install community skills. Three modes: prompt (no code), script (handler.js with full gateway API access), or hybrid. Lives in ~/.kowl/skills/.

Live Demo

One tap.
That's it.

No rigid commands. KOWL suggests, you decide. Or enable auto mode and let it handle everything autonomously.

kowl
How It Works

From zero to trading
in sixty seconds.

01git clone && npm start

Clone & Launch

One command. Setup wizard walks you through: AI provider (Anthropic recommended, OpenAI, or Gemini), wallet (import or generate), Telegram bot token, and auto mode toggle.

02Instant Setup

Connect Telegram

Create a bot via @BotFather, paste the token, send one message -- KOWL auto-connects. No manual chat ID needed. Everything works from Telegram and terminal simultaneously.

03Autonomous Engine

KOWL Watches

Three autonomous systems run 24/7: smart trade suggestions every 90s, portfolio monitoring every 5 min, and self-learning every 30 min. Plus a daily briefing at 9 AM.

04One Tap Trading

You Decide

In suggest mode, reply 'y' to execute. Or enable auto mode and let KOWL trade autonomously with configurable safety rails -- max trade size, min score, TP/SL limits.

Architecture

Seven layers.
Zero complexity.

Everything runs locally on your machine. Seven layers working together -- from AI reasoning to on-chain data aggregation. SQLite memory persists across restarts. Terminal and Telegram run simultaneously.

AI

AI Brain

Adaptive personality + natural language. Anthropic, OpenAI, or Gemini.

AE

Autonomous Engine

Suggestions (90s) | TP/SL (5m) | Learning (30m) | Auto mode | Daily briefing.

BR

Browser Agent

AI-driven Chrome control. DexScreener, PumpFun, X, Google, any URL. Shell exec.

SK

Skill Registry

scan | track | swap | alerts | holdings | user-created via prompt, script, or hybrid.

DB

SQLite Memory

Trades, tokens, SM wallets, user profile, browser snapshots. Prune + compact.

Layer 01AI Brain

Adaptive personality + natural language

AnthropicOpenAIGemini
Layer 02Autonomous Engine

Background loops that never stop

SuggestionsTP/SLLearningAuto ModeBriefing
Layer 03Browser Agent

snapshot -> AI -> action loop, any website

ChromePuppeteerShell Exec
Layer 04Skill Registry

Modular capabilities, create your own

scantrackswapalertsholdings
Layer 05SQLite Memory

Persistent state, search, prune, compact

TradesTokensSM WalletsProfileBrowser
Layer 06Gateway API

On-chain data from multiple providers

BirdeyeHeliusNansenPumpPortal
Layer 07Terminal + Telegram

Simultaneous dual interface

CLIBotAlerts
Telegram

Everything works
from your phone.

Terminal and Telegram run simultaneously. No commands to memorize -- just type naturally. Create a bot via @BotFather, paste the token, send one message, and KOWL auto-connects.

Automatic (no commands needed)

Trade suggestions every 90s
TP/SL monitoring every 5 min
Self-learning every 30 min
Daily briefing at 9 AM
Commands
Token addressScan with KOWL Score
holdingsPortfolio with values
pnlProfit / loss breakdown
smart moneySM trade feed
buy 0.1 sol of [addr]Buy with preview
sell all [addr]Sell with preview
statsTrading performance
auto mode on/offToggle autonomous trading
auto max 0.1Set max trade size
skillsList installed skills
helpAll commands
Adaptive Personality

No two KOWLs
behave the same.

KOWL adapts to each user. Degen users get CT slang, cautious users get detailed analysis, Turkish users get Turkish responses. Memory persists across restarts.

Default Mode

Bloomberg terminal vibes

Data-driven, precise, no fluff. Clinical analysis with actionable suggestions.

KOWL output
KOWL Suggestion

I think you should consider buying $KARYNA

Score: 62/100
Price: $0.00032
MCap: $320K | Liq: $45K

Why:
- 3 SM wallets bought $466 total
- Mint disabled
- Decent liquidity ratio

Three wallets converging on a fresh token.
Suggested: Buy 0.05 SOL. Reply y to execute.
Security

Trust nothing.
Verify everything.

01

Keys Stay Local

Your private key never leaves ~/.kowl/wallet.json on your machine. KOWL signs transactions locally. No cloud, no servers.

02

No Trade Without Confirmation

Every trade shows a full preview and requires explicit 'y' to execute. Unless you explicitly enable auto mode, nothing happens without your approval.

03

Private Telegram Bot

Your bot only responds to your chat ID. No one else can send commands or receive your data. Auto-connected on first message.

04

Auto Mode Safety Rails

Max trade size configurable (default 0.05 SOL). Only buys KOWL Score 40+ with $5K+ liquidity. Auto TP at +100%, SL at -50%. Turn off anytime.

05

Open Source

MIT licensed. Read every line of code. Verify everything. The community watches, just like KOWL does.

Configuration

One directory.
Everything persists.

~/.kowl/
config.jsonAI, wallet, telegram, auto mode settings
wallet.jsonKeypair (local only, never leaves your machine)
memory.dbSQLite -- trades, tokens, SM wallets, user profile, browser history
browser-profile/Dedicated Chrome profile (cookies, extensions, sessions)
skills/User-created skills (prompt, script, or hybrid)
Roadmap

Built in public.
Always evolving.

17 of 25 shipped68%
Token Scanning with KOWL ScoreShipped
Smart Money Tracking with ConvergenceShipped
Natural Language AI (3 providers)Shipped
PumpPortal Swap Integration (all DEX + pump.fun)Shipped
Full Telegram BotShipped
Autonomous Trade Suggestions with One-TapShipped
Portfolio TP/SL MonitoringShipped
Self-Learning from Trade PerformanceShipped
Auto Mode (Fully Autonomous Trading)Shipped
PnL TrackerShipped
SQLite Persistent Memory with Search, Pruning, CompactionShipped
Adaptive Personality (Degen/Sensei/Default)Shipped
Modular Skill RegistryShipped
Daily BriefingShipped
Browser Agent (AI-Driven, Any Website, Google, Forms)Shipped
Shell Command Execution (npm, git, etc)Shipped
Bare Domain Navigation (google.com, pump.fun)Shipped
Copy Trading (Mirror SM Wallets)
Docker Sandbox
WebSocket Gateway
Cron Scheduler (Persistent Across Restarts)
Multi-Wallet Support
Web UI / Control Panel
Voice Commands
Community Skill Marketplace
KOWL

The chain never sleeps.

Neither should your edge.

Open source, MIT licensed, and free. Tracks smart money, browses any website, searches Google, runs shell commands, learns from performance, trades on autopilot. Terminal + Telegram.