---
sdk: streamlit
sdk_version: 1.25.0
app_file: "Middle_School_Card_Search.py"
---

# middleschool-cardlist

Composes a list of Magic cards legal in the Middle School format.

## List of Middle School legal cards

You can download the list of legal cards in the following formats:

- [JSON (Oracle IDs and card names only)](static/middleschool.json)
- [CSV (Oracle IDs and card names only)](static/middleschool.csv)
- [JSON (with additional columns)](static/middleschool_extra_fields.json)
- [CSV (with additional columns)](static/middleschool_extra_fields.csv)

The following versions of the list include banned cards with a `banned` column set to `True`:

- [JSON (Oracle IDs and card names only)](static/middleschool_with_banned.json)
- [CSV (Oracle IDs and card names only)](static/middleschool_with_banned.csv)
- [JSON (with additional columns)](static/middleschool_extra_fields_with_banned.json)
- [CSV (with additional columns)](static/middleschool_extra_fields_with_banned.csv)

## Composing the list

Feel free to take a look at [the Jupyter notebook](https://github.com/alecrem/middleschool-cardlist/blob/main/middleschool-cardlist.ipynb) for a quick idea of the process, but please keep in mind that it is outdated and still included only for quick reference purposes.

To actually compose the list, run the shell and python scripts in the `list_scripts` directory in order.

### Requirements

Command line utilities:

- [wget](https://www.gnu.org/software/wget/)
- [bzip2](https://sourceware.org/bzip2/)
- [jq](https://stedolan.github.io/jq/)

Python modules:

- json
- pandas
- requests_html

## Streamlit web interface

This repository also hosts a web app where users can search for Middle School legal cards or check the legality of cards in a list.

The app is deployed here: [alecrem-middleschool.hf.space](https://alecrem-middleschool.hf.space/).

To run the Streamlit app locally, install the [streamlit](https://docs.streamlit.io/library/get-started) module and run:

```sh
streamlit run Middle_School_Card_Search.py
```

## Next.js web interface (deprecated)

- [Repository](https://github.com/alecrem/middleschool-tutor)
- [Latest version deployed](https://middleschooltutor.vercel.app)