Installation


version 2.1.0

Requirements

Before installing PyPotteryInk, make sure you have:

  • Python 3.12 installed on your system
🚀 Easier Installation Available!

We recommend using the PyPottery Suite Launcher for a simplified installation experience. The launcher handles all dependencies automatically and lets you manage all PyPottery tools from a single interface.

Automated Installation

Automated installation is the quickest and easiest way to get PyPotteryInk running. The provided scripts will:

  • ✅ Create a Python virtual environment
  • ✅ Automatically install all dependencies
  • ✅ Start the application

Windows

Double click on the PyPotteryInk_WIN.bat file.

The script will automatically perform the following steps:

  • Check for Python on the system
  • Create the .venv virtual environment (if it doesn’t exist)
  • Activate the virtual environment
  • Install/upgrade pip
  • Install dependencies from requirements.txt
  • Start the Flask server at http://localhost:5003
💡 Tip

On first run, dependency installation may take a few minutes. Subsequent runs will be much faster!

Linux / macOS

  1. Open the Terminal in the project directory
  2. Make the script executable (first time only):
chmod +x PyPotteryInk_UNIX.sh
  1. Run the script:
./PyPotteryInk_UNIX.sh

The script will automatically:

  • Check for Python 3 on the system
  • Create the .venv virtual environment (if it doesn’t exist)
  • Activate the virtual environment
  • Install/upgrade pip
  • Install dependencies from requirements.txt
  • Start the Flask server at http://127.0.0.1:5003
📌 Note

To stop the server, press Ctrl+C in the terminal.

Manual Installation

If you prefer full control over the installation process, you can follow these manual steps:

1. Create a Virtual Environment

It is strongly recommended to use a virtual environment to isolate project dependencies:

python -m venv .venv
.venv\Scripts\activate
python3 -m venv .venv
source .venv/bin/activate

2. Upgrade pip

Upgrade pip to the latest available version:

python -m pip install --upgrade pip

3. Install Dependencies

Install all required dependencies from the requirements.txt file:

pip install -r requirements.txt
⚠️ Warning

Make sure you are in the project’s root directory where the requirements.txt file is located.

4. Start the Application

Once installation is complete, start the application with:

python app.py

The application will be available at:

🌐 Application URL

http://localhost:5003

Installation Verification

To verify that everything was installed correctly:

  1. The application should start without errors
  2. You should see a confirmation message in the terminal
  3. Opening your browser at http://localhost:5003 should display the PyPotteryInk interface

Troubleshooting

Python not found

If you receive an error indicating that Python is not installed:

  • Windows: Download Python from python.org and make sure to check “Add Python to PATH” during installation
  • Linux: Install Python using your distribution’s package manager (e.g., sudo apt install python3)
  • macOS: Install Python via Homebrew with brew install python3

Dependency installation errors

If dependency installation fails:

  1. Make sure you have an active internet connection
  2. Try upgrading pip: python -m pip install --upgrade pip
  3. Install dependencies one at a time to identify which package is causing issues

Port 5003 already in use

If port 5003 is already occupied by another application, you can:

  1. Close the application using the port
  2. Or modify the port in the app.py file

Updating

To update PyPotteryInk to the latest version:

  1. Download the latest version of the code
  2. Activate the virtual environment
  3. Update dependencies:
pip install -r requirements.txt --upgrade