Pimpo
Pimpo, a tuxedo kitten

An AI agent that learns a task once

Ask in plain words. The first time, Pimpo does it with a language model while you watch. When it works, it turns the task into tested code that runs on its own, without a model: reliable, cheap, and safe by construction.

Download Source on GitHub

Free and open source (Apache 2.0). macOS, Windows, Linux, and servers. No telemetry.

Reliable

A routine is code with tests, not a prompt read again every night. It does the same thing each time, and says so when it cannot.

Cheap

Routines cost cents, not dollars. It works with the plans you already pay for (Claude Code, Codex, opencode), any API key, or local models.

Safe by construction

Routines reach only the capabilities they declare. Every action passes your rules and is logged, and anything that cannot be undone waits for you.

Yours

It runs on your computer or your server and keeps your data there. Export everything to one encrypted file, whenever you want.

Features

Everything Pimpo does for you

One agent that learns your tasks once and then does them on its own, safely, wherever you are.

Learns once, then runs on its own

Ask in plain words. Pimpo does it once with a model while you watch, then turns it into tested code that runs without one.

Explore, then compileEvery change is rehearsed first; what worked becomes readable JavaScript with tests.
Any triggerOn a schedule, on a webhook, or when something new shows up in your email or a feed; Gmail, Slack and GitHub push it the moment it happens.
Repairs itselfWhen a service changes and a routine breaks, Pimpo tells you and redoes it with the agent.
Change it without codeTimes, recipients and settings are fields you edit; routines can use other routines.
A gallery of 51 routinesSigned and audited, each installed with its tests; publish yours back.
Your routines as filesKeep them in a git repository and review every change as a diff.

At a glance

Dashboards of widgets, so you see what your routines found without reading a message.

Dashboards in tabsAs many as you like: home, work, the shop. Drag and resize widgets on a grid; on the phone they stack.
Any routine as a widgetAsk “show me the dollar every hour” and the routine keeps a widget up to date, or turn a routine you already have into one from its page. Any routine can also show its own health.
Seven kinds, all good-lookingNumbers with trends and sparklines, goals, status, lists, tables, and line, area, bar and donut charts.
Floating on the desktopOn macOS, Windows and Linux any widget can float in a small window of its own, above everything, keeping its place, and hidden while the app is locked.
On the Android home screenPut any widget on your phone's home screen. It refreshes on its own, keeps the last values away from home, and reads with a key that sees only those widgets.
Ready-made widgetsWhat needs you, today's runs, your reminders, what you spent and your daily limit, with no routine needed.
Shared with the houseShare a dashboard with the people of the house; it shows them only the widgets you mark as shared.
Live and freshWidgets update as routines run, show when they are out of date, and refresh on a tap, asking first when that costs money.

Safe by construction

Rules live outside the model, so a clever email cannot talk Pimpo out of them.

ApprovalsAnything that cannot be undone waits for you, on your phone or in the app, never by voice alone.
Receipts and undoA tamper-evident log of every action, with one tap to undo what can be undone.
Only what it declaredEach routine reaches just the capabilities in its manifest, and nothing else.
A daily spending limitChecked before every paid model call, so it cannot be passed.
Community protection listKnown data-stealing domains, malicious skills and dangerous actions, updated daily.
Sandboxed code and browserCode runs in an isolated container; the browser opens only the sites you allow and never types a password.

Wherever you are

One agent across your computer, your phone and the apps you already talk in.

Desktop and webmacOS, Windows and Linux apps, or any browser, with signed updates and one-click rollback.
Your phone, as part of itRoutines that run when you arrive home, on a photo of a bill, or from a Shortcut.
The chats you useTelegram, WhatsApp, Slack, Discord, Signal, iMessage on a Mac, and email.
Talk to itSay “Pimpo” and have a spoken conversation; interrupt it any time. Speech is transcribed on your machine.
A server if you likeDocker image, one-line install, and your phone reaches it from anywhere through Tailscale.

Works with what you have

Your accounts and tools, and anything with an API, without waiting for an integration.

Everyday accountsEmail, calendars, Google Sheets, Notion, Todoist, Obsidian, GitHub, Home Assistant, Spotify, Apple Reminders and Notes.
Any MCP serverSearch the official registry or add one by hand; each tool gets a risk you can see.
Any REST APIImport an OpenAPI description, or write a small JSON connector, with no recompiling.
Sites without an APIPimpo's own browser reads and fills pages on the hosts a routine is allowed.
SKILL.md skillsInstall skills from OpenClaw, Hermes or agentskills.io, limited to what you grant.

Your models, your costs

Use what you already pay for, or run everything on your own computer.

Subscriptions you haveClaude Code, Codex and opencode, with no API bill.
Any API keyAnthropic, OpenAI, Gemini, DeepSeek, OpenRouter and more, with fallbacks when one is down.
Local modelsOllama and LM Studio, plus local voices and Whisper for speech.
Routines cost centsOnce compiled, a routine runs without a model; you see every cent on the cost page.

For the whole house

Each person has their own Pimpo inside the same one, and nobody sees anyone else's things.

A login per personPair a phone for each person, or sign in with a passkey: Touch ID, Face ID or Windows Hello.
Private by defaultRoutines, conversations, memory and activity belong to their person, the administrator included.
RolesThe administrator runs the house, members manage their own things, guests can only ask.
Shared when you wantMark a fact as the house's and everyone's Pimpo knows it.

A company of agents

Build a company of any kind whose members are agents, each with its own role and boss. You are the CEO. In Labs.

Any kind of companyA shop, an agency, a software project: you write the roles, what each is for and what it may use.
Context and rules in layersFor the company, a department, a role or one member; the most specific wins, never past the house's rules.
Members that workTasks, routines on a schedule and routines that wake an agent when something new arrives, inside working hours, one at a time.
Tasks that keep their reasonHanded down with the objective and a dossier of where they came from; strays wait for the boss.
Ask the boss, then go onA question stops the work until the boss, an agent or you, answers; then it picks up where it was.
A company that remembersDecisions, lessons and meeting minutes every member reads; a summary of the week every Monday.
You choose who decidesThe agent, Jev, a model, the boss, a committee or you, per member and per action.
Decision levelsThe highest decisions always reach you, with the bosses' opinions; nothing takes them away.
Every cost has its ownerSpending by member, salaries and budgets in layers, a forecast before hiring, subscription use shown apart.
Accounts of their ownEach agent its own mailbox, GitHub or Slack, the company's shared accounts by grant, and never yours.
Decisions on your machineLaya, an open decision model, answers judgments and company decisions here, free and calibrated.
A showcase, if you want oneA public page with only what you chose to show, the company's name and mission, and nobody's name.
How each agent doesWork done, time, cost, tasks closed, autonomy earned and accuracy, and the company on your dashboards.
Start from a template, or describe itSix companies ready to adjust, or say what yours does and review the company Pimpo proposes before it exists.
Published with careYouTube uploads stay private until you say so, LinkedIn posts, and everything an agent publishes says it was made with AI.
Videos made hereA voice, screenshots and captions put together with ffmpeg as tutorials or shorts, checked before you are asked.
A finance memberThe month's costs and what came in, what looks wrong, a monthly report and budgets it only proposes; no money moves.
Autonomy that is earnedApprove the same kind of work enough times in a row and Pimpo suggests letting the agent do it alone; one no takes it back.
A product owner who citesBriefs with a source for every claim, scored, checked by Jev, and measured against their predictions after they ship.
Agents that codeClaude Code, Codex or opencode in a worktree per task, on the agent's own branch, sandboxed if you choose.
A team on GitHubAgents open issues and pull requests, review, read the checks and merge, each with its own token, within your rules.
Memory that knows whose it isThe company's, each agent's own and each task's, kept automatically or only once someone approves.
Talk with your teamA conversation with one agent or a meeting with several, as in a real company; anything said can become a task.
An org chart you dragMembers as cards in a tree; drop one on another to change its boss.
Yours, or shared by grantHidden from everyone else, the administrator included; partners view, approve or configure.
A company as a fileExport it as a company.yaml and import it anywhere, without anyone's name in it.

Remembers and suggests

It gets to know you, and only from what you told it.

Memory you controlFacts you confirmed guide it; what it read somewhere is marked unconfirmed and never becomes an instruction.
Learns your preferencesOnce a week, from your own requests and choices; confirm or remove each one.
Suggests routinesFrom patterns in your email and calendar metadata, never their contents.
Long jobs“Compare these 20 suppliers”: split across agents, with a plan, a budget and a final report.

Yours, and open

Free and open source, and your data stays where you put it.

Runs on your machineYour computer or your server; no account with us and no telemetry.
Backups you can readExport everything to one encrypted file, or back up to S3 or Google Drive, encrypted before it leaves.
Snapshots and rollbackA snapshot before every update, and one click to go back with your data as it was.
Stable formatsFrom v1.0, newer versions read older data; the formats are documented and tested.
Apache 2.0Read the code, run it, change it, and share it.

How it works

You ask

In the app, on Telegram or WhatsApp, or by voice: “every morning, send me my agenda and the emails that matter.”

It explores

A model does the task once, with every change rehearsed first, so you see exactly what it would do.

It compiles

Pimpo writes a routine: readable JavaScript, tests from what it just saw, and the list of the only things it may touch. A held-out test must pass too.

It runs

On schedule, on a webhook or when something changes, with no model. If a service changes and it breaks, Pimpo tells you and repairs it.

What it connects to

Your day

Email, calendars, Google Sheets, Notion, Todoist, Obsidian, GitHub, Home Assistant, Apple Reminders and Notes, Spotify, news feeds, web search.

Anything with an API

Any MCP server, any REST API with an OpenAPI description, or a JSON file describing its requests. No recompiling.

Where you talk

Desktop, web, phone, Telegram, WhatsApp, Slack, Discord, Signal, email, and voice, with local or cloud voices.

Download

macOS

Apple Silicon and Intel. A .dmg.

From the releases page

Windows

An installer (.exe) or an .msi.

From the releases page

Linux

.deb, .rpm or AppImage, for x64 and arm64.

From the releases page

A server, with Docker

docker run -d --name pimpo -p 127.0.0.1:7788:7788 \
  -v pimpo:/data ghcr.io/turbine-dev/pimpo

Running on a server

The command line

curl -fsSL https://raw.githubusercontent.com/turbine-dev/pimpo/main/scripts/install.sh | sh

Linux, macOS and Raspberry Pi. Checksums are verified.

Built to be trusted

Read the threat model · Report a vulnerability