Pimpo
Documentation
Everything about Pimpo, from the first task to writing a connector. New here? Start with Getting started.
Start here
User guideEverything you can do with Pimpo, screen by screen.Getting startedInstall Pimpo, find your way around and ask for the first task.RoutinesHow a task becomes a routine, what starts it, and how to change it.DashboardsTabs of widgets: routines as widgets, ready-made ones, charts and sharing.Companies of agentsCompanies of any kind whose members are agents, with you as the CEO.Approvals and receiptsWhat waits for you, and how to see and undo what Pimpo did.Memory and peopleWhat Pimpo remembers, and sharing it with the people of the house.Phone, voice and devicesThe phone app, other computers and servers, and talking to Pimpo.Channels and webhooksTelegram, WhatsApp, Slack, Discord, Signal, iMessage, email and webhooks.ConnectionsAccounts, connectors, the gallery, skills, the browser and running code.Models and costsChoosing models, downloading local ones, and what everything costs.Updates, backups and helpKeeping Pimpo up to date, moving it, backups and check-ups.MoreEverything else in the guide.
In depth
How routines workFrom a request to a tested routine: triggers, tests and writing one by hand.ConfigurationThe command line, settings, models, channels, the data folder, network access and backups.Running on a serverDocker, systemd, reaching it safely, and the apps opening it.Validating on real accountsWhat
pimpo report measures and what counts as done.Extending
Extending PimpoThe API, channels, bridges and everything a developer can build on.Writing a connectorJSON connectors, MCP servers and OpenAPI imports.Data formatsThe frozen formats of the database, routines, connectors, memory and backups.RFC 0001: code sandboxHow the agent runs code in isolation.RFC 0002: browserHow the agent drives a browser safely.RFC 0003: dashboards and widgetsDashboards, routines as widgets, and widgets on every system.RFC 0004: companies of agentsCompanies with roles, members, decision levels and accounts of their own.RFC templateHow to propose a larger change.
Security
Project
RoadmapThe milestones to v1.0 and beyond.StatusWhat is built, what is tested, and what waits.Releases and supportVersions, channels, signing and how a release is made.The planWhy Pimpo exists and how it was planned.ChangelogWhat changed in each version.ContributingHow to help, and how changes are made.GovernanceHow decisions are made.Code of ConductHow we treat each other.Getting helpWhere to ask questions and report problems.
This page is built from the repository's documentation. Improve it on GitHub.