Skip to content

Rascalsz/mimo-alpha

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MiMo Alpha

AI-powered airdrop intelligence platform that scores and ranks DeFi airdrop opportunities using Xiaomi MiMo v2.5 Pro.

Python 3.11+ License: MIT MiMo v2.5 Pro

MiMo Alpha is a CLI-first toolkit for serious airdrop hunters. It discovers fresh L2, DeFi, and new-chain opportunities, scores each one with Xiaomi MiMo v2.5 Pro across funding, team, tokenomics, historical analogs, and eligibility, and produces a transparent Alpha Score (0-100). Track your wallets, watch your eligibility progress, and get alerted the moment a high-conviction drop appears.


Architecture

+----------------------------------------------------------------------------+
|                        MiMo Alpha - 6-Stage Pipeline                        |
+----------------------------------------------------------------------------+

   [1] SCOUT          [2] EVALUATE        [3] FILTER         [4] TRACK
   +----------+       +-----------+       +----------+       +-----------+
   | Discover |  -->  | MiMo v2.5 |  -->  | Rank by  |  -->  | Wallet &  |
   | sources  |       | Pro scorer|       | Alpha    |       | progress  |
   | (L2/DeFi |       | 5-factor  |       | Score    |       | tracker   |
   |  /chains)|       | analysis  |       | + tags   |       |           |
   +----------+       +-----------+       +----------+       +-----------+
        |                  |                  |                   |
        v                  v                  v                   v
   sources.yml       funding,team,        watchlist          eligibility
   on-chain APIs     tokenomics,          buckets            checks,
   crypto news       analogs,             (S/A/B/C)          tx history
                     eligibility
                                                                  |
                                                                  v
                                                +-----------+   +-----------+
                                                | [6] REPORT |<--| [5] ALERT |
                                                | Dashboard  |   | Telegram, |
                                                | + CSV/JSON |   | webhook,  |
                                                | exports    |   | desktop   |
                                                +-----------+   +-----------+

                  +--------------------------------------+
                  |  SQLite store  |  httpx async I/O    |
                  |  FastAPI (web) |  MiMo client cache  |
                  +--------------------------------------+

The flow is linear and inspectable: Scout -> Evaluate -> Filter -> Track -> Alert -> Report. Each stage writes to a local SQLite store so any step can be replayed without re-spending MiMo tokens.


Features

  • Multi-source scout — L2s (Linea, Scroll, zkSync, Base, Taiko), DeFi protocols, fresh app-chains, and testnet campaigns.
  • MiMo v2.5 Pro scorer — five-factor analysis: funding status, team credibility, tokenomics design, historical analog comparison, eligibility difficulty.
  • Alpha Score 0-100 — single transparent number with full reasoning trace.
  • Progress tracking — per-wallet eligibility checklist (txs, volume, bridges, days active).
  • Alerts — Telegram, generic webhook, and desktop notifications when a new opportunity crosses your threshold.
  • Watchlists & portfolios — group opportunities, tag wallets, export to CSV/JSON.
  • Local-first — SQLite + httpx, no SaaS lock-in. Optional FastAPI web dashboard.

Quick Start

pip install mimo-alpha

# one-time config
mimo-alpha init
mimo-alpha config set mimo.api_key "$MIMO_API_KEY"
mimo-alpha config set wallet.add 0xYourWallet

# run the pipeline
mimo-alpha scout            # discover new opportunities
mimo-alpha evaluate --top 25
mimo-alpha report           # ranked dashboard in terminal

Need the web dashboard?

mimo-alpha serve --port 8000
# open http://localhost:8000

Python SDK Usage

from mimo_alpha import AlphaEngine, Opportunity

engine = AlphaEngine(api_key="mimo_xxx")

# discover and score
opportunities = engine.scout(sources=["l2", "defi", "new_chains"])
scored = engine.evaluate(opportunities, model="mimo-v2.5-pro")

# filter and report
top = engine.filter(scored, min_score=80, tags=["zk", "no-vc"])
for opp in top:
    print(f"{opp.name:25s}  Alpha={opp.alpha_score:5.1f}  {opp.bucket}")
    print(f"  reasoning: {opp.reasoning[:120]}...")

# track a wallet against an opportunity
status = engine.track(wallet="0xabc...", opportunity_id=top[0].id)
print(status.checklist)   # {'bridge_tx': True, 'swap_volume_usd': 412.7, 'days_active': 18}

# subscribe to high-score alerts
engine.alerts.subscribe(min_score=85, channel="telegram")

MiMo Token Consumption

MiMo Alpha caches aggressively, but here is what a typical run costs against MiMo v2.5 Pro.

Operation Avg input tokens Avg output tokens Approx cost / call
Scout (per source) 1,200 400 very low
Evaluate (per opportunity) 3,800 900 low
Eligibility check (per wallet x opp) 1,500 250 very low
Alert reasoning summary 600 200 negligible
Weekly portfolio report 8,000 2,200 low
Deep-dive analog comparison 6,500 1,800 medium

A daily run over 50 opportunities and 3 wallets typically stays under ~250k tokens thanks to the SQLite cache and incremental scout.


MiMo Alpha vs the Alternatives

Capability MiMo Alpha Manual research Generic alpha bots
Discovery across L2 / DeFi / new chains Automatic, daily Manual, ad-hoc Partial
Quantified score (0-100) Yes, MiMo v2.5 Pro No Heuristic only
Reasoning trace per score Yes N/A Rare
Eligibility tracking per wallet Yes Spreadsheet No
Historical analog comparisons Yes Memory-based No
Local-first / self-hosted Yes N/A No
Alerts (TG / webhook / desktop) Yes No TG only
Cost MiMo tokens only Your time $20-100 / mo

Tech Stack

  • Python 3.11+
  • MiMo v2.5 Pro for reasoning and scoring
  • FastAPI for the optional web dashboard
  • SQLite for the local store
  • httpx for async I/O against on-chain RPCs and data sources

Roadmap

  • CLI pipeline (Scout -> Report)
  • MiMo v2.5 Pro scorer with 5-factor reasoning
  • SQLite cache and replay
  • Telegram + webhook alerts
  • Web dashboard (FastAPI + HTMX)
  • Multi-wallet portfolio view with PnL projection
  • On-chain eligibility prover (zkProof of activity)
  • Community-shared watchlists
  • Browser extension for opportunity injection

Project Layout

mimo-alpha/
├── src/mimo_alpha/
│   ├── __init__.py
│   ├── cli.py             # Typer CLI entry
│   ├── engine.py          # AlphaEngine orchestrator
│   ├── scout.py           # discovery sources
│   ├── evaluator.py       # MiMo scoring
│   ├── filter.py          # ranking + buckets
│   ├── tracker.py         # wallet eligibility
│   ├── alerts.py          # notifications
│   ├── report.py          # terminal + export
│   ├── mimo_client.py     # MiMo v2.5 Pro client
│   ├── store.py           # SQLite layer
│   ├── models.py          # dataclasses
│   └── config.py
├── tests/
├── pyproject.toml
├── LICENSE
└── README.md

License

MIT - see LICENSE.

Author

Rascalsz - akashi.fahrengart@gmail.com GitHub: https://github.com/Rascalsz/mimo-alpha

About

AI-powered airdrop intelligence platform — scores DeFi opportunities with Xiaomi MiMo v2.5 Pro

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages