A Pokémon GO companion that decides, instead of just showing numbers.
There are enough calculators already. You attach the appraisal screenshot, "96.4%" shows up, and the real question is still unanswered: so what? Worth powering up? Worth evolving? Can I transfer it without regretting it?
TrainerKit answers that — and shows its work.
Installable PWA, offline-first. No account, no server, nothing leaving your device.
It's a website, so there is nothing to download.
iPhone / iPad — open it in Safari, tap Share, then Add to Home Screen.
On iOS this isn't optional. Safari erases the storage of any site left untouched for 7 days, and that would take your collection with it. Added to the Home Screen, it stays.
Android — open it in Chrome, menu ⋮, then Install app.
Computer — Chrome, Edge and Brave show an install icon in the address bar.
Follows the system's light/dark theme automatically.
| Appraisal scan | The three bars are geometry, not text — the app counts filled segments and returns the exact IV. Not OCR, so there is no "almost right": either it read them, or it says it couldn't. Validated against 26 real screenshots, 240p to 4K. |
| Verdict | Power up, evolve, keep or transfer, with a one-line reason and a confidence bar that is literally how much the rules agree with each other. When two pull opposite ways it drops, as it should. |
| The trace | Every verdict opens into named rules with weights. The engine was built to be explainable — an app that asks you to trust it without checking is just another app. |
| Raids | DPS, TDO and an efficiency rating per moveset, plus the best counters from your own collection. If it says you need three people, you need three people. |
| PvP | Stat product under each league's CP cap, and best movesets per league. Labelled as what it is: stat product, not a tier list. |
| Gyms | Who actually holds one: defense × stamina, divided by what the type chart lets it take. |
| Pokédex mode | The device. Point the camera, hear the entry read out loud, ask questions about what's on screen. |
| 10 languages | pt-BR, English, Spanish (Spain and LatAm), French, German, Italian, Japanese, Korean, Russian — interface, Pokémon names and move names. |
- Max CP at level 40 with perfect IVs, for species whose value is public (Machamp 3056, Dragonite 3792, Tyranitar 3834, Rhydon 3179).
- Base stats are validated through an independent path — the conversion Pokémon GO makes from the main series (
baseStamina = floor(1.75 × HP + 50)). Without it, an ETL bug would go unnoticed by staying internally consistent. - Level cap is 55, not 50. The CPM table has 55 entries and ends at
0.8653; half levels come from a quadratic mean, not an arithmetic one. - Raid boss CP reproduces the game's: tier 5 Mewtwo gives 54,148.
Game data comes from alexelgt/game_masters, which mirrors the real GAME_MASTER every 1–3 days. The better-known PokeMiners mirror is months behind — using it would have meant an app that looks fine while giving stale verdicts.
The 18.8 MB raw file is processed in CI, never on your phone, and ships as one compact JSON. You can also point the app at a different gamedata.json in Settings, so it isn't tied to me: if I stop updating, you switch the source and carry on.
DATA.md documents where each piece comes from, including what this project deliberately does not redistribute.
Your collection lives in your browser (IndexedDB). It is never uploaded. No analytics, no tracking cookie, no account.
Something only leaves the device when you use the AI or the voice — and the in-app privacy screen names every service and exactly what it receives. Both can be turned off, and both have an on-device option that needs no internet at all.
The app also ships no Pokémon artwork. By default each species shows a badge in its type colour with two initials; images are an optional source you point at yourself.
- Node 22 or later
- pnpm 11
git clone https://github.com/NspxMiguel/TrainerKit.git # download the source
cd TrainerKit
pnpm install # install dependencies
pnpm --filter @trainerkit/dataset refresh # download GAME_MASTER and build the dataset (~15s, needs network)
pnpm dev # start the dev server on http://localhost:5273The dev server also listens on the local network, so you can open it on your phone using the machine's IP — which is the only way to test the camera and the screenshot reader properly.
| Command | What it does |
|---|---|
pnpm -r test |
209 tests |
pnpm -r typecheck |
TypeScript across all three packages |
pnpm --filter ./apps/web build |
Production build + bundle audit |
The dataset step is separate on purpose: it hits the network and takes a while, and nothing else in the repo depends on it being fresh.
packages/
├── core/ # pure TypeScript, zero DOM — every number in the app
│ ├── cp.ts # CP formula and the CPM table (up to level 55)
│ ├── iv.ts # IV solver: species + CP + HP + appraisal -> combinations
│ ├── scan.ts # reads the appraisal bars off a screenshot
│ ├── verdict.ts # the decision engine: named rules, weights, trace
│ ├── raid.ts # DPS, TDO, efficiency rating
│ ├── pvp.ts # stat product per league
│ ├── gym.ts # defender bulk against the type chart
│ ├── counters.ts # best counters from your own collection
│ └── moves.ts # best moveset per context (raid, PvP, Rocket)
└── dataset/ # CI-only ETL: GAME_MASTER -> compact JSON + rankings
apps/
└── web/ # the PWA (Vite + React 19)
└── src/ai/ # AI and voice: prompts, topic filter, quota, TTS engines
api/ # Vercel edge functions (shared AI key, voice)
packages/core imports no React, no window and no fetch. It takes data and returns results — that's what makes it genuinely testable, and what lets the math survive a change of platform.
It also writes no text: it returns a translation key plus the numbers. The interface builds the sentence, because the interface knows the language. Ten languages, and the compiler breaks the build if one of them forgets a key.
TrainerKit is an independent fan-made app, not affiliated with, sponsored or endorsed by Scopely Explore (formerly Niantic), The Pokémon Company, Nintendo, Creatures Inc. or GAME FREAK. Pokémon, Pokémon GO and character names are trademarks of their respective owners.
It works exclusively from screenshots you provide, and does not access, modify or communicate with the game's servers. It is not monetised.
MIT — see LICENSE. The license covers this repository's code; game data and Pokémon names belong to their respective owners.
Made by @NspxMiguel