freebuild-pi

Freebuild sponsored model provider and sponsor panel for Pi

Packages

Package details

extension

Install freebuild-pi from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:freebuild-pi
Package
freebuild-pi
Version
0.0.1
Published
Nov 4, 2026
Downloads
359/mo · 359/wk
Author
2touch
License
SEE LICENSE IN LICENSE
Types
extension
Size
27.1 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

Freebuild for Pi

Pi extension that connects Pi to the Freebuild broker and shows the sponsor panel during sponsored runs.

This is the Pi spike. It is not published to npm yet.

Install locally

# From the repository root:
pi install "$(pwd)/pi-extension"

Restart Pi, then:

/freebuild-license

Paste a Freebuild license key, or pass it directly:

/freebuild-license fb_...

The command verifies the key against the broker, saves it to ~/.config/freebuild/credentials.json, and selects the Freebuild model.

Use

/model

Choose:

freebuild/deepseek-flash

The extension registers the provider as freebuild and sends:

  • Authorization: Bearer <license key>
  • X-Freebuild-Install: <install id>
  • X-Freebuild-Client: pi/0.0.1
  • X-Freebuild-Client: pi/0.0.1-headless in print and JSON modes

Sponsor panel

The panel appears above the editor while a sponsored run is active.

  • SPONSORED for sold and affiliate campaigns
  • FREEBUILD for house inventory

Print and JSON modes do not render the panel and do not record impressions. That avoids counting an ad the user could not see.

Open the sponsor with alt+o or:

/freebuild-sponsor

The plugin records open and close events for each run and uses the tracked click endpoint when possible. Image-only campaigns always render the SPONSORED label, the brand, and the open hint, so Pi never shows a terminal panel with only an image.

Commands

/freebuild-license [key]  Save and verify a license
/freebuild-sponsor        Open the current sponsor
/freebuild-status         Show license, model, install, and broker

Environment

FREEBUILD_CREDENTIALS   Override the credentials file path
FREEBUILD_API_URL       Override the web origin
FREEBUILD_BROKER_URL    Override the broker URL
FREEBUILD_SPONSOR_URL   Override the sponsor panel URL
FREEBUILD_LICENSE_KEY   Override the stored license key

Development

Load the extension without installing it:

pi --no-extensions -e ./pi-extension --list-models freebuild

The package has no build step. Pi loads TypeScript through jiti.

License

Proprietary. Copyright (c) 2026 Freebuild. All rights reserved.

This package is licensed under the Freebuild Proprietary License. See LICENSE.