# crobertsbmw/deckofcards

An API to simulate a deck of cards

Repository: https://github.com/crobertsbmw/deckofcards
Canonical: https://ross.abutalabs.com/products/deckofcards
Language: JavaScript
License: MIT
License Family: permissive
Last push: 2025-07-08T18:31:02+00:00

## Health v2 (maintenance only)
Score: 46/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 30, release rhythm 35, longevity 100
- inputs: {"age_days": 4144, "days_push": 421, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1425, forks 369 (observed 2026-08-28T04:04:41.532310+00:00)

## What it is
A REST API service that simulates drawing from one or more decks of playing cards, with shuffle, draw, and pile management endpoints. It is written in Python (Django) and can be self-hosted or used via the hosted instance at deckofcardsapi.com.

## Use cases
- simulate drawing cards for a card game backend
- shuffle a deck of cards via an API
- build a blackjack or poker prototype without implementing deck logic
- self-host a card deck API with Docker
- get random playing cards as JSON for a web app

## When to choose
- you need card deck simulation over HTTP without writing game logic
- you want a simple self-hostable REST API for card games
- you need deterministic deck state with pile management across requests

## When to avoid
- you need a full card game engine with rules and win detection
- you need offline/in-process card shuffling in your own language
- you need high-throughput game server logic beyond simple deck operations

## Facets
- artifact type: service
- maturity: stable
- function: http-server, api-framework, simulation
- domain: apis, gaming-tools, web-development
- platform: python, self-hosted
- tags: cards, deck-of-cards, rest-api, game-simulation, django, docker, web-server

## Member repositories
- crobertsbmw/deckofcards (main) score 46

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:41.532310+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:37:30.063979+00:00, confidence not recorded.
  - readme: https://github.com/crobertsbmw/deckofcards (fetched 2026-08-28T04:04:41.532310+00:00, sha d92540cac03e)
- Data as of 2026-08-30T08:39:29.467469+00:00.