_____ _
/ ____| (_)
| | __ _ _ __ __ _ _ __ _ _ _ _ __ ___
| | / _` | '_ \ / _` | '__| | | | | '_ ` _ \
| |___| (_| | | | | (_| | | | | |_| | | | | | |
\_____\__,_|_| |_|\__,_|_| |_|\__,_|_| |_| |_|
caniarun 🚀
Not sure if your rig can handle that shiny new AI model? That's exactly what this tool is for!
caniarun checks out your hardware (GPU, CPU, and RAM) and tells you straight up which open-source AI models will actually run on your machine. Instead of throwing confusing metrics at you, it gives you a fun, easy-to-understand vibe check for over 80 models across different compression levels.
You'll get ratings like:
- 🧈 Smooth as butter
- 🔥 Dope run
- 😐 Meh usable
- 🐌 Laggy vibes
- 🗑️ Trash mode
Note: This project is a fork from the original canirun.ai, simplified into a script that anyone can easily run directly from their terminal.
Installation
Getting started is super easy. Just drop this in your terminal:
pip install caniarun
(Optional) If you're rocking an NVIDIA GPU and want more precise detection, use this instead:
pip install caniarun[nvidia]
How to Use
Just type this in and hit enter. We'll handle the rest!
caniarun
🌟 Check out the source code & contribute:
github.com/netssv/can_ia_run
1 maintainer
Metadata
1 maintainer
Release files for caniarun 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| caniarun-0.2.0.tar.gz | 173.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| caniarun-0.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 245.8 kB
Release files / caniarun-0.2.0.tar.gz
| Download URL | caniarun-0.2.0.tar.gz |
|---|---|
| Size | 173.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
107aeb240bb650c1a0c8505f9de6c747d301894d8b3ba9e258283b2a8a06e348
|
|
BLAKE2b-256 checksum How to use checksums |
9fefc81082b862ac0c22cd12613749b91668c9352ef7a1ec2ab9f7a6f10abbd9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 6, 2026.
Transparency logRelease files / caniarun-0.2.0-py3-none-any.whl
| Download URL | caniarun-0.2.0-py3-none-any.whl |
|---|---|
| Size | 72.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
477e054bf82d9a4e5118b69f181c2767d40295a074abaa0e42f0f643b6e3b103
|
|
BLAKE2b-256 checksum How to use checksums |
4e7c1c827383aa9150276e0f4064685c010b2caa4c1d6e9e409aab81ce0e1ad8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 6, 2026.
Transparency log
