Pipkin guide

Pipkin is an AI coding agent that runs on your Android phone. Tell it what to build or fix, and it reads your code, runs commands, edits files, and checks its own work. There’s no laptop or cloud server doing the work somewhere else: the agent, your files, and every command stay on the phone.

How it fits together

Pipkin has three parts. You install the app and Termux, and setup installs Pi for you:

• The Pipkin app is what you see and tap: chats, files, code changes, terminals, and settings.
• Termux is a Linux-like environment for Android. The agent works there, so it can install and run real tools with pkg, the same way it would on a computer.
• Pi is the open-source agent that does the work. Pipkin installs it in Termux, starts one Pi process for each chat, and shows what it does in the app.

The thinking happens at the AI model you connect, such as Claude or OpenAI, so you need a network connection while a chat is working.

Where to go next

• Get started: install Pipkin and Termux, walk through setup, and start your first chat.
• Connect a model: sign in with a Claude or OpenAI subscription, add a Gemini, Z.ai or Kimi API key, or add any OpenAI-compatible API.
• Configure the agent: find Pi’s configuration in Termux and change how the agent behaves.
• Extensions: add Pi extensions, skills, and prompt templates, and see which ones Pipkin bundles.
• Run in the background: how Pipkin keeps chats working while you’re away, and what Android can still stop.

Pipkin is in early development, so screens and settings may change between versions.