Pinokio
FeedAppsRemoteCreate
Download Pinokio
Sign inCreate accountJoin
Sign inCreate accountJoin

Build a 1-Click Launcher

Turn any open-source project into a 1-click app you can install and run with Pinokio.

App or launcher@cocktailpeanut

Prompt

Showing the original instructions. Complete the fields to preview your answers.

Build a fully functional, cross-platform Pinokio 1-click launcher for the following open-source project:

{{project_url}}

First, understand the project.

Read its repository, documentation, and installation instructions. Figure out how to install, configure, and run it locally.

Then, build the launcher.

  • Follow the official Pinokio documentation and existing launcher conventions.
  • Provide one-click Install, Start, Update, and Reset actions.
  • Automatically handle dependencies, environment setup, and platform-specific requirements.
  • Support Windows, macOS, and Linux wherever the project supports them.
  • For web apps, automatically expose the running URL in Pinokio. For CLI tools, provide a usable terminal interface.
  • Keep everything minimal. Use Pinokio's built-in APIs whenever possible. Avoid unnecessary code, abstractions, and modifications to the original project.
  • Test the installation and launch process, fix any issues, and clearly explain anything that couldn't be verified.

Finally, offer to publish it.

Once the launcher works, ask if I'd like to publish it to GitHub so others can install it through Pinokio.

If I agree, create a GitHub repository containing the launcher, a README, the standard Pinokio install badge, and a one-click install link.

If I say yes:

  1. Help me choose a repository name and description.
  2. Create a GitHub repository under my account, with my approval.
  3. Include the complete source code, Pinokio launcher, README, installation instructions, and appropriate license.
  4. Make sure the repository is ready for others to clone, install, and launch through Pinokio.
  5. Commit and push everything to GitHub, after confirming the repository's visibility and contents with me.
  6. Give me the published repository URL.

Include an install badge in the README.md.

Add the following badge near the top of README.md, replacing OWNER/REPO with the actual GitHub repository:

[![Install with Pinokio](https://badges.pinokio.co/install.svg)](https://pinokio.co/resolve?url=https://github.com/OWNER/REPO)

After publishing the GitHub repository, give the user the https://pinokio.co/resolve?url=https://github.com/OWNER/REPO install link and ask them to open it to add the project if prompted, signing in if needed.

Prioritize simplicity, portability, and a working one-click experience.

Make it yours

Enter Project URL.

Your answers are not published on the registry. Your selected agent may use an external provider. Execution uses that agent’s permissions.

Exact message sent to Pinokio

Complete the fields to see the message.

The agent receives the template link and your answers, then reads and applies the template. Its interpretation can differ from this preview.

Inspect the full template

Published instructions cannot be edited. Linked resources can still change. Review the instructions before running an agent.

Original instructions

Build a fully functional, cross-platform Pinokio 1-click launcher for the following open-source project:

**{{project_url}}**

**First, understand the project.**

Read its repository, documentation, and installation instructions. Figure out how to install, configure, and run it locally.

**Then, build the launcher.**

- Follow the [official Pinokio documentation](https://desktop.pinokio.co/docs/) and existing launcher conventions.
- Provide one-click Install, Start, Update, and Reset actions.
- Automatically handle dependencies, environment setup, and platform-specific requirements.
- Support Windows, macOS, and Linux wherever the project supports them.
- For web apps, automatically expose the running URL in Pinokio. For CLI tools, provide a usable terminal interface.
- Keep everything minimal. Use Pinokio's built-in APIs whenever possible. Avoid unnecessary code, abstractions, and modifications to the original project.
- Test the installation and launch process, fix any issues, and clearly explain anything that couldn't be verified.

**Finally, offer to publish it.**

Once the launcher works, ask if I'd like to publish it to GitHub so others can install it through Pinokio.

If I agree, create a GitHub repository containing the launcher, a README, the standard Pinokio install badge, and a one-click install link.

If I say yes:

1. Help me choose a repository name and description.
2. Create a GitHub repository under my account, with my approval.
3. Include the complete source code, Pinokio launcher, README, installation instructions, and appropriate license.
4. Make sure the repository is ready for others to clone, install, and launch through Pinokio.
5. Commit and push everything to GitHub, after confirming the repository's visibility and contents with me.
6. Give me the published repository URL.

**Include an install badge in the README.md.**

Add the following badge near the top of README.md, replacing OWNER/REPO with the actual GitHub repository:

```
[![Install with Pinokio](https://badges.pinokio.co/install.svg)](https://pinokio.co/resolve?url=https://github.com/OWNER/REPO)
```

After publishing the GitHub repository, give the user the https://pinokio.co/resolve?url=https://github.com/OWNER/REPO install link and ask them to open it to add the project if prompted, signing in if needed.


**Prioritize simplicity, portability, and a working one-click experience.**

Complete definition

{
  "title": "Build a 1-Click Launcher",
  "description": "Turn any open-source project into a 1-click app you can install and run with Pinokio.",
  "instructions": "Build a fully functional, cross-platform Pinokio 1-click launcher for the following open-source project:\n\n**{{project_url}}**\n\n**First, understand the project.**\n\nRead its repository, documentation, and installation instructions. Figure out how to install, configure, and run it locally.\n\n**Then, build the launcher.**\n\n- Follow the [official Pinokio documentation](https://desktop.pinokio.co/docs/) and existing launcher conventions.\n- Provide one-click Install, Start, Update, and Reset actions.\n- Automatically handle dependencies, environment setup, and platform-specific requirements.\n- Support Windows, macOS, and Linux wherever the project supports them.\n- For web apps, automatically expose the running URL in Pinokio. For CLI tools, provide a usable terminal interface.\n- Keep everything minimal. Use Pinokio's built-in APIs whenever possible. Avoid unnecessary code, abstractions, and modifications to the original project.\n- Test the installation and launch process, fix any issues, and clearly explain anything that couldn't be verified.\n\n**Finally, offer to publish it.**\n\nOnce the launcher works, ask if I'd like to publish it to GitHub so others can install it through Pinokio.\n\nIf I agree, create a GitHub repository containing the launcher, a README, the standard Pinokio install badge, and a one-click install link.\n\nIf I say yes:\n\n1. Help me choose a repository name and description.\n2. Create a GitHub repository under my account, with my approval.\n3. Include the complete source code, Pinokio launcher, README, installation instructions, and appropriate license.\n4. Make sure the repository is ready for others to clone, install, and launch through Pinokio.\n5. Commit and push everything to GitHub, after confirming the repository's visibility and contents with me.\n6. Give me the published repository URL.\n\n**Include an install badge in the README.md.**\n\nAdd the following badge near the top of README.md, replacing OWNER/REPO with the actual GitHub repository:\n\n```\n[![Install with Pinokio](https://badges.pinokio.co/install.svg)](https://pinokio.co/resolve?url=https://github.com/OWNER/REPO)\n```\n\nAfter publishing the GitHub repository, give the user the https://pinokio.co/resolve?url=https://github.com/OWNER/REPO install link and ask them to open it to add the project if prompted, signing in if needed.\n\n\n**Prioritize simplicity, portability, and a working one-click experience.**",
  "intent": "create_app",
  "fields": [
    {
      "name": "project_url",
      "type": "text",
      "required": true,
      "label": "Project URL",
      "help": "",
      "defaultValue": ""
    }
  ],
  "id": "01m76q98cej8vfnkc2kccjj7d1",
  "coverUrl": "https://api.pinokio.co/template-covers/01m76q98cej8vfnkc2kccjj7d1/1d989290-a29b-413d-a249-4434ef984cff.webp",
  "publishedAt": "2026-11-12T01:53:50.569Z",
  "unlistedAt": "2026-11-12T01:52:15.246Z",
  "updatedAt": "2026-11-12T01:53:17.421Z",
  "author": {
    "username": "cocktailpeanut",
    "name": "cocktailpeanut",
    "avatarUrl": "https://assets.pinokio.co/avatars/optimized/1778687712237-wo1ws2elp6o.webp"
  },
  "substitutionRules": "Replace every original {{name}} occurrence in one pass. Whitespace around names is allowed. An odd backslash before {{...}} escapes a literal token; each preceding backslash pair emits one backslash. Other backslashes are unchanged. Never expand inserted answers or interpret replacement-string syntax. Defaults initialize answers; optional blanks are empty strings."
}

Machine-readable definition

cocktailpeanut@cocktailpeanut·2d
Have an open source project you want to package up for 1-click launch? Just use this starter kit. Enter the GitHub URL and open on your pinokio desktop, select your favorite AI agent, and it will take care of everything from building, packaging, publishing to github, and listing automatically on pinokio.co
Loading conversation…

Replies

Pinokio
PrivacyTerms
FeedAppsCreateRemote