Skip to content
,

How to Use Pinokio: 1-Click Installer for Local AI Apps (2026 Guide)

7–11 minutes
Excited woman holding a Pinokio card with the text 1-click AI apps, for a guide to the Pinokio local AI app installer

Want to try a new open-source AI app from GitHub without fighting Python versions, CUDA errors and long install guides? That is exactly what Pinokio is for.

Pinokio is a free “1-click launcher” for open-source apps. You pick an app from its catalogue, click install, and Pinokio downloads the code and every dependency into its own isolated folder, then gives you Start, Update and Reinstall buttons.

This guide explains how Pinokio works, how to install it, how to find, run, update and remove apps, how to save disk space with Disk Saver, how to stay safe with scripts, and how to fix common problems. It is based on Pinokio’s official manual, website and GitHub security policy, checked in November 2026.

TL;DR

  • What: a free, open-source launcher for Windows, Mac and Linux that installs AI apps (image, video, voice, chat) in one click.
  • Get it: desktop.pinokio.co (source on GitHub: pinokiocomputer/pinokio).
  • Isolated: apps live in ~/pinokio/api, tools in ~/pinokio/bin, each Python app in its own venv.
  • Find apps: pinokio.co/apps, filter by platform (Windows, macOS, Linux) and GPU (NVIDIA, AMD, Apple).
  • Safety: scripts can run any command. Prefer verified apps from the Discover page and read the script source for others.
  • Disk: AI apps are huge. Disk Saver deduplicates identical files; Empty Trash removes unused data.
  • Stuck? Logs page > Get Help builds a report you can send to Ask AI or the community.

What Is Pinokio?

Pinokio describes itself as a 1-click launcher for any open-source project. Think of it as a terminal with a friendly interface: each app comes with a script (written in JSON) that tells Pinokio how to download, install and start it.

Pinokio bundles the tools those scripts need, depending on your platform: Python, Node.js, Bun, Git, uv, Conda, Homebrew, FFmpeg, Caddy and tmux (Mac/Linux). That is why you do not have to install them yourself.

Part Where What it holds
Home folder Your chosen Pinokio home (often ~/pinokio) Everything Pinokio manages
Apps ~/pinokio/api Each installed app in its own folder
Tools ~/pinokio/bin Python, Node, Git and other binaries
Python packages ~/pinokio/api/APP/venv App-only virtual environment
Logs logs/api, logs/dev, logs/shell Install and run logs

What Pinokio Is Good (and Not Good) For

Great for Less ideal for
Trying new image, video, voice and music apps quickly Running one app in production on a server
Beginners who don’t want to use the terminal People who need full control of every dependency
Keeping many AI apps separated so they don’t break each other Low-disk PCs (each app can take many GB)
Updating apps with one click Apps not yet packaged as Pinokio scripts

For a single app you use every day, a dedicated install can be leaner. For example, our ComfyUI install guide covers the official Desktop and Portable builds, and our Ollama guide is simpler for chat models.

Step 1: Install Pinokio

  1. Go to desktop.pinokio.co and click Download. Builds exist for Windows, macOS and Linux.
  2. Run the installer. On Windows, SmartScreen may warn about a new app; on Mac, you may need to allow it in System Settings > Privacy & Security. Only do this for the file you downloaded from the official site.
  3. Open Pinokio and choose a home folder. Pick a drive with plenty of free space (100 GB+ if you plan to try several AI apps). A short path without spaces, like D:\pinokio, avoids problems with some app scripts.
  4. Let it set up its tools. The first time an app needs Python, Git or Conda, Pinokio installs them into its own folder.

Check that your GPU has enough memory for the apps you want. Our VRAM guide for AI has a quick chart.

Step 2: Find an App

  • Browse pinokio.co/apps or the Discover page in the app.
  • Use the tabs: Featured, Announced, Popular, New and Updated.
  • Filter by platform (Any, macOS, Windows, Linux) and GPU (Any, NVIDIA, AMD, Apple) so you only see apps that will run on your PC.
  • Filter by topic tags such as #tts, #image-generation or #video-generation.
  • Check install counts and recent updates; popular, recently updated apps tend to work best.
  • Radar lets you follow projects and get notified when they gain attention.

Step 3: Install, Start and Stop Apps

  1. Open the app page and click Download or Install. Pinokio shows where the script comes from (its GitHub repository) before running it.
  2. Wait for the install. It can take a while: AI apps often download several GB of packages and models. Watch progress in the built-in terminal.
  3. Click Start in the app’s sidebar menu once installed.
  4. Open the web UI. Most AI apps open a local page in Pinokio’s browser view or your normal browser.
  5. Stop the app with the stop button at the top of the page when you’re done, to free up VRAM.
  6. Optional: use Autolaunch to start chosen apps when Pinokio opens, and set dependencies so one app waits for another.

Each project also has an ENVIRONMENT file you can edit under Configure, for settings like ports or API keys.

Step 4: Update, Reinstall and Roll Back

  • Update: most app menus have an Update item that pulls the latest code.
  • Reinstall: wipes and rebuilds the app’s environment, which fixes most broken installs.
  • Versions: Pinokio has Git built in, so you can save versions with one click and switch back to an earlier one if an update breaks something.
  • Install protection: app shells default to Protection On, which applies a 72-hour freshness delay to supported npm, uv and bun installs. That helps avoid brand-new, possibly compromised packages. You can change it per app with the terminal Protection toggle.

Step 5: Save Disk Space

AI apps are big: many ship their own copy of PyTorch, CUDA libraries and models. Pinokio has tools for this.

Tool What it does
Disk Saver Finds files with identical contents across apps and lets them share storage, while apps keep their own names and paths
Scan Read-only: it does not link, replace or delete anything
Make separate Gives a deduplicated file its own copy again
Trash / Empty Trash Shows unused managed data; Empty Trash permanently removes it after safety checks
Info bar Shows live disk, RAM, CPU and VRAM use where supported

To remove an app completely, use its delete option in Pinokio, then empty Trash. Deleting folders by hand can leave shared data behind.

Is Pinokio Safe?

Pinokio itself is open source, but be clear about what it does: scripts can run any command, just like a shell script. Safety depends on which scripts you run.

  • Verified apps: scripts featured on Discover go through Pinokio’s process. Publishers must be verified, the repo is transferred to and frozen in the official Pinokio Factory GitHub organisation, and the admin reviews and tests it before listing.
  • What reviewers check: that commands run inside the app’s own folder, that Python packages install into the app’s venv, and that third-party packages stay inside Pinokio’s environment.
  • Open source scripts: every script comes from a public Git repo and is human-readable JSON, so you can read it before running.
  • Isolation: by default apps run under ~/pinokio/api and tools under ~/pinokio/bin, not system-wide.

Good habits: prefer verified apps, read the script and repo for anything else, avoid scripts from random links, and keep your antivirus on.

Handy Extras

  • Background mode: in Settings, run Pinokio as a menubar item and open it at http://localhost:42000.
  • Remote: pinokio.co/connect lets you reach your Pinokio from another device.
  • Create: a newer feature that uses your AI agent to package a GitHub project as a 1-click launcher and publish it.
  • Write your own scripts: the manual covers building launchers, tasks, plugins and the Pinokio API.

Windows user who also wants Linux-only tools? Pair Pinokio with our WSL2 local AI setup.

Troubleshooting

Problem Fix
Install fails partway Open Logs > Get Help to see the error; try Reinstall
App installs but won’t start Check GPU/platform filters matched your PC; read logs/api; update the app
Out of disk space Run Disk Saver, empty Trash, delete apps you no longer use, or move Pinokio home to a bigger drive
CUDA or “out of memory” errors Stop other apps to free VRAM; choose lighter models or settings in the app
Strange errors with paths Use a short Pinokio home path without spaces or special characters
Update broke the app Switch back to a saved version with the built-in Git versions
Port already in use Stop the other app or change the port in the app’s ENVIRONMENT settings
Need help from the community Logs > Get Help builds a report (with a privacy review) for Ask AI, the Pinokio Community, or a zip

My Take

Pinokio is the fastest way to try the flood of new open-source AI apps without breaking your PC. The isolation, one-click updates and Git versions make experimenting safe, and Disk Saver keeps the storage cost in check.

Treat it like any tool that runs code: stick to verified apps when you can, and keep a big drive free. For the one or two apps you use daily, a dedicated install may still be cleaner.

FAQ

Is Pinokio free?

Yes. Pinokio is free and its source is on GitHub.

Is Pinokio safe to use?

Pinokio isolates apps in its own folder, and featured scripts are reviewed. But scripts can run any command, so prefer verified apps and read unknown scripts first.

Where does Pinokio install apps?

In the api folder of your Pinokio home, for example ~/pinokio/api/app-name.

Does Pinokio work on Mac and Linux?

Yes. It runs on Windows, macOS and Linux. Each app lists which platforms and GPUs it supports.

Does Pinokio need a GPU?

Pinokio doesn’t, but many AI apps do. Use the GPU filter to find apps for NVIDIA, AMD or Apple chips.

Why does Pinokio use so much disk space?

Each app has its own Python environment, libraries and models. Use Disk Saver and Empty Trash to reclaim space.

How do I uninstall an app in Pinokio?

Delete it from inside Pinokio, then empty Trash to remove leftover managed data.

Sources

Free weekly email

Get new AI guides every week

One short weekly email with our newest local AI, ComfyUI and AI tool guides. No spam, no pop-ups, just the good stuff.

Free. Unsubscribe anytime in one click. We only use your email to send this newsletter. See our privacy policy.

Excited woman holding a Pinokio card with the text 1-click AI apps, for a guide to the Pinokio local AI app installer