Pokemon-Showdown-Battle-Assistant

A simple assistant to help you strategize during a Pokemon battle

This is a simple CLI app to help people who play Pokemon. I made this because I haven't played since Gen1 and I wanted a tool to help me keep track of all the new type matchups (e.g. what type is effective against or takes greater damage from some other type).

Deployment

Option 1: Streamlit Cloud (Easiest - Free)

1. Fork this repository on GitHub.
2. Go to share.streamlit.io.
3. Connect your GitHub account and select this repo.
4. Set the main file path to app.py.
5. Click Deploy!

Your app will be live at a public URL instantly.

Option 2: Local Deployment with Docker

1. Ensure you have Docker and Docker Compose installed.
2. Clone the repository:

   git clone https://github.com/Lito-Frito/Pokemon-Showdown-Battle-Assistant.git
   cd Pokemon-Showdown-Battle-Assistant

3. Run with Docker Compose:

   docker-compose up --build

4. Open http://localhost:8501 in your browser.

Option 3: Manual Local Run

pip install streamlit
streamlit run app.py

Option 4: Cloud Deployment with Docker

Deploy the Docker image to any cloud platform:

• Heroku: heroku container:push web && heroku container:release web
• AWS/GCP/Azure: Use their container services.
• Railway/DigitalOcean: Push the image directly.

CLI Version

For the original command-line tool:

python3 main.py

If you want to get back into Pokemon, or if you can never keep track of what beats what, this tool is for you. The "battle assistant" will ask you for two types. It will then return all the types that are strong/weak against the given types.

E.g. if you input "grass" and "ice" (shout out to Abomasnow; Snow is in the way), this is a snippet of what the output will look like:

*Grass is: Strong against: 2x => ['water', 'ground', 'rock']

Weak against: 0.5x => ['fire', 'grass', 'poison', 'flying', 'bug', 'dragon', 'steel']

*Ice is: Strong against: 2x => ['grass', 'ground', 'flying', 'dragon']

Weak against: 0.5x => ['fire', 'water', 'ice', 'steel']

This snippet is just the offensive analysis; it will also tell you the defensive analysis.

What This Includes

• main.py: The script that houses and calls all the other important scripts
• type_input.py: Respoonsible for determiming valid input and collecting potentially two types from the user
• offense_calculator.py & defense_calculator.py: Takes the inputs from type_input.py and runs an offensive and defensive analyses (see above for example)

Getting Started

Requirements

• Python3
• a CLI (if you're on Windows, this is the Command Prompt; for Linux and Mac, this is your terminal)

Quick Start

You can go to repl.it where I'm hosting the app in a personal repl.