Introduction

mirago catches the fake Python package names that AI coding tools make up — before you try to install them.

When you ask an AI tool (Copilot, Cursor, Claude, and others) to write Python code, it sometimes imports a package that doesn't actually exist — it invented the name. mirago reads your code, looks at every package it imports, and checks each one against PyPI, the official Python package index.

What it catches

mirago tells you about two kinds of problem:

1. Doesn't exist — the AI invented the name. This is an error.
2. Exists but looks risky — the name is real, but it was created very recently and is barely downloaded and isn't already used in your project. This is a warning — it could be a copycat ("slopsquat") package.

Quick start

pipx install mirago
mirago check your_file.py

If something's fake, you'll see exactly which import is the problem and why. If everything looks fine, mirago stays quiet with a short summary.

Head to Installation to set it up, then Usage for the day-to-day commands.

Note: A safety rule baked in from day one — if PyPI can't be reached, mirago assumes your packages are fine rather than raising a false alarm. It would rather miss occasionally than cry wolf.