PokéDex Scanner¶

An AI-powered web application for scanning and managing your Pokémon TCG card collection, with multi-provider AI image recognition, an offline card database, and full collection management.

Features¶

📷 AI Card Recognition

• Scan cards with your camera or by uploading an image — AI identifies the card automatically
• Supports multiple AI providers: GitHub Models, OpenAI, Groq, Ollama, Azure OpenAI, and Anthropic Claude
• Manual entry fallback for cards you prefer to add without scanning

📦 Collection Management

• Organise cards into named custom collections
• Duplicate tracking with quantity counts
• Estimated collection value (EUR pricing)
• Import / export your collection as JSON

🔍 Search & Filter

• Search by card name, set, type, and rarity
• Real-time filtering across the full card database

🗄️ Offline Database

• Downloads the full Pokémon TCG card database locally for accurate lookups and artwork
• SQLite-backed server storage — survives restarts and Docker container reuse

🔐 Optional API Protection

• Shared-secret session cookie auth for mutating endpoints (API_SECRET)
• HTTPS support with auto-generated self-signed certificate

Quick Links¶

• Getting Started — New here? Start with the introduction
• Quick Start — Be up and running in minutes
• Installation — Detailed setup guide
• AI Providers — Switch between AI backends
• Docker Deployment — Run with Docker or Docker Compose

Architecture Overview¶

graph TB
    subgraph app["PokéDex Scanner"]
        direction TB

        subgraph frontend["Frontend (React + Vite)"]
            ui["UI Components<br/>• Card Grid<br/>• Scanner Dialog<br/>• Collection Manager"]
            cam["Camera / Image Upload"]
        end

        subgraph server["Node.js Server"]
            api["REST API<br/>• /api/ai/chat<br/>• /api/db<br/>• /api/collections"]
            aiProxy["AI Proxy<br/>• GitHub Models<br/>• OpenAI / Groq<br/>• Ollama / Azure / Anthropic"]
            db[("SQLite Database<br/>(pokedex.db)")]
        end

        frontend -->|HTTP/HTTPS| server
        cam -->|image| api
        api --> aiProxy
        api --> db
    end

    style app fill:none,stroke:#7c3aed,stroke-width:3px
    style frontend fill:none,stroke:#f59e0b,stroke-width:2px
    style server fill:none,stroke:#7c3aed,stroke-width:2px

Getting Started¶

git clone https://github.com/pacorreia/pokemon-card-scanner.git
cd pokemon-card-scanner
npm install
# Using the default GitHub Models provider
export AI_PROVIDER=github
export GITHUB_MODELS_TOKEN="<your_github_pat>"
npm run dev:full

# Using the default GitHub Models provider
docker run -d \
  --name pokedex-scanner \
  -e AI_PROVIDER=github \
  -e GITHUB_MODELS_TOKEN="<your_github_pat>" \
  -v pokedex-data:/data \
  -p 8787:8787 \
  ghcr.io/pacorreia/pokemon-card-scanner:latest

Download the Card Database¶

On first launch the app will prompt you to download the Pokémon TCG database (card artwork, set info, and pricing). Click Download and wait for it to complete — typically only needed once per data directory.

Support¶

• 🐛 Report Issues
• 💡 Request Features
• ⭐ Star the repo if you find it useful!

License¶

MIT — Copyright GitHub, Inc.