omp packages

freebuild-pi0.0.1

Freebuild sponsored model provider and sponsor panel for Pi

2touch Published 9 days ago SEE LICENSE IN LICENSE ~359 downloads/mo

Untested on omp

This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.

Did it work for you?

Result

One report per person. A new report replaces your old one.

Reports 0

No reports yet.

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.