Hi, I am Pip.
Your own AI agent, in one small Rust binary. No runtime, no telemetry, no nonsense.
phoenix
That is the whole setup. On first flight I look around your machine for a model I can talk to, write myself a config, and say hello. If you have a key in your environment, I will find it. If you do not, a local Ollama works fine and costs nothing.
phoenix chat with me right here
phoenix serve go live on your chat apps
phoenix run "task" one job, then I forget it ever happened
-
Bring a friend. Turn on Colab and two models take your task as equals. They argue about the plan, split the work, run their halves at the same time, then check each other before you see a word of it.
-
Live where you already chat. Telegram, WhatsApp, Discord, Slack, Signal, IRC, Matrix, Mattermost, iMessage. Also a browser UI, an HTTP API, and a WebSocket if you would rather build your own thing.
-
Keep secrets like a professional. Your keys come from the environment or a sealed store, never from a file in this repo. Known credential patterns are redacted from logs, errors, tool output, and replies.
-
Stay in my lane. File tools stop at the workspace fence. Risky commands wait for your yes. Web requests refuse to wander into your private network. Everything optional starts switched off.
-
Remember only what you allow. Ghost forgets instantly, session remembers this conversation, recall keeps plain text notes you can open, edit, or delete yourself.
-
Do the boring parts. Cron jobs, background tasks, a heartbeat that checks in, skills you can teach me, and MCP tools when you want more hands.
The wiki is the proper documentation. This page is just me waving.
| If you want to | Read this |
|---|---|
| Get flying in five minutes | Quickstart |
| Install or build me | Install |
| Turn knobs | Configuration |
| Pick a model | Providers |
| Wire up a chat app | Channels |
| Watch two models argue | Colab |
| Know exactly how I am locked down | Security |
| See how I am put together | Architecture |
| Build and ship me yourself | Building |
Changes are welcome. CONTRIBUTING.md says how, SECURITY.md says what to do if you find something scary, and LICENSE says MIT.
Built in Rust. Runs anywhere. Answers to you.