explaingit

pinokiocomputer/pinokio

7,444JavaScriptAudience · vibe coderComplexity · 2/5Setup · easy

TLDR

A desktop app that installs and runs open-source AI tools with a single click, handling all the command-line setup for you inside a safe, isolated environment on your computer.

Mindmap

mindmap
  root((pinokio))
    What it does
      One-click AI installer
      Isolated environments
      Script runner
    Script format
      Plain JSON
      Human readable
      path and venv controls
    Safety model
      Sandboxed folder
      Python venv isolation
      Reviewed Discover scripts
    Audience
      Non-technical users
      AI hobbyists
      Vibe coders
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Install a local AI image generator or language model on your computer without touching the command line.

USE CASE 2

Browse and install community-reviewed AI tools from the Discover page in one click, knowing each script has been tested and sandboxed.

USE CASE 3

Write a custom Pinokio JSON script to automate downloading, installing, and launching your own AI workflow.

USE CASE 4

Run multiple open-source AI tools side by side, each isolated in its own folder so they don't conflict with each other.

Tech stack

JavaScriptJSON

Getting it running

Difficulty · easy Time to first run · 5min

In plain English

Pinokio is a desktop application that lets you install and run open-source AI tools with a single click. Think of it as a terminal wrapped in a friendly graphical interface: instead of typing commands to download and configure software, you click a button and Pinokio handles the rest. It stores everything it installs in a dedicated folder on your computer, keeping it separated from the rest of your system. There are two ways to use scripts in Pinokio. You can write your own, the same way you would write shell scripts in a terminal. Or you can browse the Discover page, which lists scripts that have been reviewed and approved by the Pinokio team. Scripts on the Discover page are stored under an official GitHub organization, which means they are publicly visible and frozen in place so they cannot be silently modified after approval. The verification process for featured scripts is thorough. Script authors must first be personally verified, then invited to the official GitHub organization. They transfer their repository there before any review begins. The Pinokio admin reads through each script, tests it, and checks several specific things: that all commands run inside the app's own folder, that Python dependencies are installed in a virtual environment local to that app, and that any third-party packages stay within the isolated Pinokio environment. No script is approved until it has been tested personally. Security is also built into how the script format works. Scripts are written in plain JSON, which makes them easy to read before you run anything. A path attribute controls where each command executes, defaulting to the app's own folder. A venv attribute handles Python isolation automatically. When you install a script from an outside source, Pinokio shows a warning screen with a link to the original repository so you can inspect the code yourself before anything runs. The project is written in JavaScript and has over 7,000 stars on GitHub. It is aimed at people who want to run open-source AI tools locally without dealing with the command line.

Copy-paste prompts

Prompt 1
Write a Pinokio JSON script that downloads a Python-based AI image tool, installs its pip dependencies in a virtual environment, and launches the web UI automatically.
Prompt 2
I installed an AI tool via Pinokio but it fails to start, explain what the path and venv attributes in the script control and how I can debug the error.
Prompt 3
How do I add a custom script to Pinokio that isn't on the Discover page, and what should I check to make sure it's safe before running it?
Prompt 4
Create a Pinokio script that sets up a local Ollama instance, pulls the Llama 3 model, and opens a chat interface on startup.
Prompt 5
Explain how Pinokio's path sandboxing works so I can write a script that installs dependencies without touching system folders.
Open on GitHub → Explain another repo

← pinokiocomputer on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.