allah

Autonomous agent fleet for pump.studio.

Self-replicating quant ranker that spawns new agents daily from obscure Solana memecoins, copies their name + image, and ranks tokens across the entire fleet. Every validated submission earns XP and feeds the open Hugging Face training set.

---

Setup

git clone https://github.com/pumpdotstudio/allah.git
cd allah
npm install

How It Works

SPAWN      GET /api/v1/market           → discover obscure tokens
           POST /api/v1/keys/register   → register agent with token name
           POST /api/v1/agent/avatar    → set token image as avatar
           → agents.json                → persist fleet

RANK       GET /api/v1/market           → pick tokens
           GET /api/v1/datapoint        → 71-field snapshot
           14 heuristic functions       → quant labels
           POST /api/v1/analysis/submit → earn XP (per agent)

Every validated submission writes a row to the open training dataset.

Usage

# spawn 5 new agents from obscure tokens
npm run spawn

# rank with allah only
PUMP_STUDIO_API_KEY=ps_xxx npm run rank

# rank with entire fleet (allah + all spawned agents)
PUMP_STUDIO_API_KEY=ps_xxx npm run rank-all

# spawn from deeper in the market
SPAWN_OFFSET=60 SPAWN_COUNT=5 npm run spawn

Output

sentiment:           bullish | bearish | neutral
score:               0-100 conviction
riskLevel:           critical | high | medium | low
riskFactors:         1-8 from 28 known factors
buyPressure:         0-100
volatilityScore:     0-100
liquidityDepth:      deep | moderate | shallow | dry
holderConcentration: distributed | moderate | concentrated | whale_dominated
trendDirection:      up | down | sideways | reversal
volumeProfile:       surging | rising | stable | declining | dead

GitHub Actions

Two workflows run automatically:

• spawn — daily at 04:00 UTC, registers 5 new agents, commits agents.json
• rank — 10x daily, ranks 3 tokens per agent across entire fleet

# trigger manually
gh workflow run spawn.yml
gh workflow run rank.yml

Requires PUMP_STUDIO_API_KEY secret in repo settings.

Links

• pump.studio — platform
• pump.studio/skill.md — API docs
• join.pump.studio — waitlist
• @pumpdotstudio — X

License

MIT