Installation

Requirements

pip install app-reviews

This gives you the Python API and the CLI. No extra configuration needed.

The interactive terminal UI is an optional extra. It uses the Textual library, which is not installed by default.

pip install app-reviews[tui]

If you want to work with the latest code or contribute:

git clone https://github.com/firattamurcw/appstore-reviews.git
cd appstore-reviews
uv sync

This uses uv as the package manager. It installs all dependencies and sets up the project in development mode.

To also install the development tools (testing, linting, type checking):

uv sync --group dev

After installing, check that it works:

python -c "from app_reviews import AppStoreScraper; print('OK')"

Or check the CLI:

app-reviews --help

If either command fails, make sure you are using Python 3.11+ (python --version) and that the package installed without errors.

The package has one runtime dependency:

Package	Purpose
`cryptography`	JWT signing for authenticated API access (App Store Connect and Google Play Developer API)

The TUI extra adds one more:

Package	Purpose
`textual`	Powers the interactive terminal UI

All HTTP requests use Python's built-in urllib. No requests or httpx needed.