![\"Vizzor\"](\"vizzor_logodarkicon.png\")
\n \n \n
\n See the future of crypto before it happens.
\n AI-powered price predictions with real dollar targets across every chain, token, and timeframe.\n
\n ![\"CI\"](\"https://github.com/7ayLabs/vizzor/actions/workflows/ci.yml/badge.svg\"){kind=icon}
\n ![\"npm\"](\"https://img.shields.io/npm/v/@vizzor/cli\")
![\"License\"](\"https://img.shields.io/badge/License-BUSL--1.1-blue.svg\"){kind=icon}
\n
\n Get Started •\n Features •\n Agents •\n Dashboard •\n API •\n Chains •\n ChronoVisor •\n Config\n
\n\n---\n\nVizzor turns raw market data into actionable crypto predictions. It pulls live feeds from 15+ exchanges, runs technical analysis on real candles, reads derivatives positioning, tracks on-chain activity, and synthesizes everything into price predictions with actual dollar targets — from 5-minute scalps to 3-month outlooks.\n\nAsk about any coin, any token, any chain. Vizzor fetches the data, computes the signals, and gives you numbers — not opinions.\n\n```\nvizzor\n> predict ETH at 16:00 today\n\nETH at $2,112 | Bullish | Confidence: Medium-High\n At 4:00 PM: $2,128 (+0.8%) bull / $2,104 (-0.4%) bear\n 1 day: $2,156 (+2.1%) bull / $2,068 (-2.1%) bear\n 7 days: $2,295 (+8.7%) bull / $1,985 (-6.0%) bear\n 1 month: $2,560 (+21%) bull / $1,840 (-13%) bear\n Support: $2,005 / $1,900 | Resistance: $2,220 / $2,340\n```\n\n---\n\n## What's new in v0.15.1 — Polaris\n\n> [Full release notes →](https://github.com/7ayLabs/vizzor/releases/tag/v0.15.1)\n\n- **Four new free-tier signal sources** — Deribit options term structure + 25-delta skew, Hyperliquid DEX positioning vs CEX funding divergence, Reddit + 4chan retail-sentiment NLP with contrarian top/bottom flags, and a 30-day funding-rate z-score from a new history table.\n- **Closed-loop WR observability** — every signal records its vote + outcome, the auditor classifies each signal as INVERT / DAMPEN / WATCH / KEEP from rolling WR, and a polarity registry applies sign + magnitude overrides BEFORE CF combination. New `/wr-diagnose` + `/signal-override` commands.\n- **Adversarial signal-conflict gate** — when onChain CF and logicRules CF disagree by >0.6 magnitude in opposite directions, the prediction is reframed as RANGE instead of emitting low-conviction directional noise.\n- **Calibration acceleration** — regime-bucketed Platt shards per (family, regime), cross-symbol per-family prior inheritance, confidence-weighted SGD, calibrator bootstrap from a 30-day rolling window.\n- **Production-grade auto-deploy** — merging to `main` auto-SSHes to the VPS, pulls the new image from GHCR, and rolls the docker stack in ~3-5 min. Health-gated, concurrency-protected.\n- **Per-user accuracy correctness** — `user_id` persisted at `logPrediction` insert time closes the long-standing bug where every operator on the same bot saw a shared WR.\n- **Session-scoped DM delivery + orphan re-guard** — old DMs from previous sessions never deliver, mid-session deletes suppress queued DMs.\n- **Env-aware data dir** (`VIZZOR_DATA_DIR`) — dev and prod can now run on the same machine without thrashing shared SQLite state.\n- **Sentry, Prometheus `/metrics`, bearer-auth `/health`** — observability for unattended 24/7 operation.\n\n---\n\n## Why Vizzor?\n\nMost crypto tools show you what already happened. Vizzor shows you what's likely to happen next.\n\n- **Not a chart tool** — it's a prediction engine that synthesizes 6 independent signal types into one composite forecast\n- **Not a news aggregator** — it processes sentiment, derivatives, on-chain data, and technical indicators simultaneously\n- **Not a chatbot wrapper** — every prediction is backed by real market data from 15 exchanges, with traceable reasoning and confidence scores\n- **Works with everything** — BTC, ETH, SOL, meme coins, new DEX launches, tokens by contract address — if it has a price, Vizzor can predict it\n\n---\n\n## Get Started in 60 Seconds\n\n```bash\nnpm install -g @vizzor/cli\nvizzor\n```\n\nThat's it. Vizzor launches a guided setup wizard that walks you through:\n- Choosing your AI provider (Claude, GPT-4, Gemini, or local Ollama)\n- Setting up API keys\n- Picking your default chain\n- Optionally installing the ChronoVisor ML engine on first run\n- Learning the first commands\n\n### Start predicting\n\n```\n> predict BTC price next week\n> analyze $PEPE security and price outlook\n> what's trending in crypto right now\n> full microstructure analysis for ETH\n> track wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\n> audit contract 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984\n```\n\n### Better prediction accuracy\n\nAfter setup, follow these tips for the best results:\n- Enable the ChronoVisor engine during setup, or run `vizzor chronovisor setup` later\n- Run `/cosmos on` for stricter tracked-only qualification and fewer low-edge setups\n- For intraday: focus on `BTC`, `ETH`, and `SOL` with `2h`, `3h`, `4h`, `6h` horizons\n- For scalping: focus on `BTC` and `ETH` with exact short horizons like `10m`, `20m`, `45m`\n- For long-range: ask for `7d`, `30d`, `90d`, or `1y` scenario ranges\n- Use `/precisions` to check tracked accuracy and `/playbook` for the full operating workflow\n\n### Alternative setups\n\n\n Built by 7ayLabs\n
\n","readmeFilename":"README.md"}