README.md

metadata

title: OPTCG Deck Builder
colorFrom: red
colorTo: blue
sdk: gradio
sdk_version: 5.49.1
python_version: '3.12'
app_file: app.py
pinned: false
license: mit
short_description: Auto-build legal 50-card One Piece TCG decks

OPTCG Deck Builder

Pick any Leader from the optcg-en-card-embeddings dataset and the Space generates a legal 50-card OPTCG deck around it. The ranker layers OPTCG deckbuilding rules on top of the Qwen3-Embedding-derived synergy score:

• Color legality - every card shares at least one color with the Leader.
• Family bonus - cards in the Leader's family (Straw Hat Crew, Marines, etc.) get a +0.10 synergy boost so they outrank merely-similar off-archetype options.
• Copy cap - each card appears at most 4 times (the OPTCG standard).
• Cost curve targeting - one of three style presets shapes how slots are distributed across costs.

Sister Space: OPTCG Card Explorer - semantic search, UMAP scatter, similar-cards browser.

Style presets

Each preset is a target distribution that sums to 50 cards. The builder fills cost buckets in order, and any deficit at the end spills into a backfill pass over remaining top-synergy cards (so the total is always 50).

Cost	aggro	midrange	control
1	4	0	0
2	12	6	4
3	12	10	8
4	8	10	8
5	6	8	8
6	4	8	8
7	2	4	6
8+	2	4	8

What the Space does not do

• No archetype/strategy detection (it does not know that, say, "Monkey.D.Luffy / OP01-001" is the aggro leader).
• No banlist or meta awareness.
• No card art (this is a structured-data / text-only project by design - see parent project for the IP rationale).
• The result is a sketch you tweak, not a tournament-ready list.

Configuration

• HF_TOKEN (Space secret) - required only while the source dataset stays private.

Development

pip install -r requirements.txt
export HF_TOKEN=hf_...   # only if the source dataset is private
python app.py

pytest -v        # 21 hermetic tests

License

MIT. Card data via the vegapull scraper. Not affiliated with Bandai or the One Piece Card Game.