athenaos-tech/athenaos-agent
FinanceA self-hosted multi-agent crypto desk that screens BSC tokens and LPs, then reports high-confidence calls for manual execution.
AthenaOS is an experimental, self-hosted trading assistant for BNB Smart Chain (chain ID 56). Five always-on scouts watch meme tokens, PancakeSwap V3 LP positions, BSC NFTs, narrative momentum and Hyperliquid whale flow; a desk chief called Athena only posts a call after a three-layer consensus (quant/liquidity, catalyst/sentiment, security audit) reaches at least 80% confidence. It is aimed at operators who want screening and audit trails with a human still deciding on trades.
What changes in the workflow
Screening and execution are deliberately separated. Signal cards are posted to Discord scout channels with links out to PancakeSwap, DexScreener, Krystal, OpenSea and BscScan, and there are no auto-buy buttons by default. DRY_RUN defaults to true and automated execution is off, so live swaps or transfers happen only after an explicit opt-in or through a manual /swap or /send. A position manager then tracks take-profit at 2x/3x, a −20% stop loss and trailing stops.
Each scout has published numeric gates, for example meme tokens need 24h volume ≥ $25k and liquidity ≥ $5k, while LP pools need TVL ≥ $10k, 24h volume ≥ $100k and a daily fee/TVL ratio ≥ 2%. Missing security data is treated as a failure, and one-click links replace trading buttons.
Ways to operate it
The same engine is controlled from several interfaces: a Discord command center with 22 slash commands and seven auto-created channels, a terminal TUI for audits and screening without Discord, a Telegram notification bridge, and an optional React web desk that reads the agent's REST API. A PM2 deployment path runs it as a 24/7 daemon with self-update and a doctor diagnostic.
Screening rules can be chosen at onboarding (a loosened default, a stricter standard, plain-English custom rules compiled to strategy modules) or edited per scout. The consensus floor and security audits are not lowered by those presets.
Requirements and limits
Running the agent needs Node.js ≥ 22.12 and a TypeScript build, on Windows, Linux or macOS. Practical use also means supplying keys and endpoints: Discord bot credentials, a BSC RPC URL, and API keys for the data sources (GMGN, Krystal Cloud, OpenSea, GoPlus), plus an LLM provider and keys. The X API token is optional and only feeds the narrative scout. Keys live in a local .env and a gitignored state file, and nothing is uploaded unless platform reporting is configured.
The author calls the software experimental research tooling, not financial advice: enabling live mode can still lose funds. Execution stays on BSC only; the Hyperliquid whale scout provides context rather than a trading venue. The README documents these constraints but does not report any live-performance validation, so the scoring thresholds should be read as configuration, not as evidence of returns. The project is MIT-licensed.
HotRepo's take
A new-repository board entry recorded 108 total stars on 2026-10-29. That is a single snapshot, not a measure of sustained interest, and there is no comparable daily history to judge momentum.
Written by AI from the project's README, updated October 29, 2026. The project's own docs are the source of truth.