explaingit

bentossell/pi-droid-sdk

12TypeScriptAudience · developerComplexity · 2/5Setup · moderate

TLDR

A plugin for the pi terminal AI coding assistant that connects it to Factory's model catalog, giving pi access to models from Anthropic, OpenAI, Gemini, and Factory through a local runtime called Droid.

Mindmap

mindmap
  root((pi-droid-sdk))
    What It Adds
      Factory model catalog
      Tool bridge
    Models Available
      Anthropic
      OpenAI
      Gemini
      Factory native
    Setup
      GitHub install
      Droid CLI
      Factory API key
    Use Cases
      Model comparison
      Coding tasks
      Terminal AI work
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 the extension in pi to access Factory's full model catalog, including models not built into pi by default

USE CASE 2

Switch between Anthropic, OpenAI, Gemini, and Factory-native models from pi's model picker without leaving the terminal

USE CASE 3

Use pi's built-in file-reading and command-running tools with any Factory model through the included tool bridge

USE CASE 4

Test a specific model like kimi-k2.5 in pi for a coding task by passing the model flag at startup

Tech stack

TypeScript

Getting it running

Difficulty · moderate Time to first run · 30min

Requires a Factory API key and the Factory Droid CLI, extension is not yet published to npm and must be installed directly from GitHub.

No license information was provided in the explanation.

In plain English

This is a plugin for a terminal-based AI coding assistant called pi. It connects pi to a platform called Factory, which provides access to a broad catalog of AI models from multiple providers including Anthropic, OpenAI, Gemini, and Factory's own models. Without this extension, pi works with its built-in model options. With it installed, pi gains access to Factory's full model library through a local runtime called Droid. The extension is designed to fit into pi's existing interface rather than replace it. You still use pi's model picker to switch between models, pi's thinking controls to adjust how much reasoning effort the model applies, and pi's session restore behavior. The extension just adds Factory's models to the list of available choices. Installing it requires a few steps: installing the extension itself from GitHub since it has not yet been published to npm, installing the Factory Droid command-line tool, and providing a Factory API key. Once set up, you can select a model using a flag when you start pi, for example choosing a model called kimi-k2.5 that Factory offers. The extension also includes a tool bridge. Pi has its own set of built-in tools for reading files, running commands, and similar tasks. This bridge makes those tools available to the Droid runtime, so models running through Factory can still call pi's tools in the normal way. A similar extension exists for Cursor models and is mentioned in the README as a reference point for the same design pattern. This project is a narrow developer-facing adapter, it is most useful to someone who already uses pi and wants to access Factory's model catalog through that same interface.

Copy-paste prompts

Prompt 1
Help me install the pi-droid-sdk extension in pi from GitHub and configure the Factory Droid CLI and API key so I can access Factory models from the terminal.
Prompt 2
Using pi-droid-sdk, help me write a pi session that uses a Factory-native model to review my codebase for security issues, with pi's file-reading tools available to the model.
Prompt 3
Explain what the tool bridge in pi-droid-sdk does and why it is needed when running Factory models inside pi rather than pi's default models.
Prompt 4
I want to compare responses from Claude Sonnet and a Factory-native model for the same coding task inside pi. Write the startup flags for each session using pi-droid-sdk.
Open on GitHub → Explain another repo

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

Verify against the repo before relying on details.