WorkPilot
An enterprise AI assistant for coding and office work, built for the Microsoft ecosystem.
Documentation · 简体中文 · Changelog · Add to Teams
WorkPilot runs its agent, credentials, memory, and sessions on your machine. Prompts and tool content are sent only to the model providers and external channels you configure. It combines development tools, Microsoft 365 integration, browser automation, MCP servers, scheduled work, and multi-agent delegation behind one security and approval pipeline. The optional Cloud Gateway is a stateless relay for Teams and Web Chat.
Install
Windows PowerShell
irm https://aka.ms/workpilot/install.ps1 | iex
wp
macOS / Linux
curl -fsSL https://aka.ms/workpilot/install.sh | bash
wp
Complete the guided enterprise GitHub Copilot sign-in and setup, then run
workpilot doctor to verify the configuration and effective Python package source.
WorkPilot-managed installs and updates default to
https://packagefeedproxy.microsoft.io/pypi/simple/; normal pip/uv use against
that feed does not require sign-in, a PAT, or artifacts-keyring. See the
installation guide for
manual PIP_INDEX_URL / UV_DEFAULT_INDEX setup, firewall requirements, and
alternative install and update paths.
Choose how to work
| Surface | Start command | Use it for |
|---|---|---|
| Terminal (TUI) | workpilot chat |
Local terminal conversations |
| Self-hosted Web | workpilot serve |
Browser chat, attachments, approvals, settings, and status |
| Teams + M365 Copilot | workpilot cloud |
Microsoft 365 conversations through the Cloud Gateway |
What it can do
| Area | Capabilities |
|---|---|
| Development | Read and edit code, run shell commands and tests, use Git, browse repositories, and delegate focused work |
| Microsoft 365 | Work with mail, calendars, files, people, Teams, and other Graph surfaces through configured credentials |
| Automation | Run browser workflows, scheduled jobs, heartbeat tasks, skills, and MCP tools |
| Knowledge | Preserve append-only sessions, maintain long-term memory, search prior conversations, and use attachments |
| Operations | Serve a local gateway, connect cloud channels, inspect status, manage secrets, and audit actions |
Security model
- Four profiles:
open,standard,controlled, andrestricted - Per-call risk scoring and approval decisions
- Command and workspace sandboxing
- Secret storage, credential redaction, SSRF protection, and audit logs
- Manual emergency stop across tools and channels
- MCP tools treated as untrusted by default
Start with the security architecture and approval guide.
Documentation
- Get started
- Channels
- CLI
- Agents and tools
- Extensions and automation
- Configuration
- Gateways and security
- CLI reference
- Configuration schema
- Troubleshooting
- Contributor guide
Development
WorkPilot contains three separately validated components:
| Component | Location | Primary checks |
|---|---|---|
| Python runtime and CLI | workpilot/ |
pytest, Ruff, mypy |
| React Web app | web/ |
TypeScript, ESLint, Vitest, Vite |
| .NET Cloud Gateway | cloud_gateway/ |
dotnet build, dotnet test |
mkdir -p web/dist
python -m pip --isolated install --index-url https://packagefeedproxy.microsoft.io/pypi/simple/ -e ".[dev]"
pytest tests/ -v
python -m ruff check workpilot/ tests/
python -m mypy workpilot/
For multi-command manual shell sessions, set PIP_INDEX_URL / UV_DEFAULT_INDEX and
clear alternate index variables as shown in the development guide. Frontend installs
use web/.npmrc and the Microsoft-protected npm feed. Read the
development guide before
changing a component.
All changes go through a feature branch and pull request; never push directly to main.
Architecture
WorkPilot is organized as Transport → Message Bus → Processing, with provider, session, memory, configuration, and security services underneath. See the architecture overview and the internal core specification.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file workpilot-0.33.1.tar.gz.
File metadata
- Download URL: workpilot-0.33.1.tar.gz
- Upload date:
- Size: 2.4 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
86cd2bc0633c495869c0fced7f31833c3d2b91447513c2b7277235211c4b25e9
|
|
| MD5 |
44645fd72851cb2f7bb715c9fe612e52
|
|
| BLAKE2b-256 |
9fc89d1c6b06cdfb80e0cf936825466b4721a2ccb40220a476aa46093af85097
|
File details
Details for the file workpilot-0.33.1-py3-none-any.whl.
File metadata
- Download URL: workpilot-0.33.1-py3-none-any.whl
- Upload date:
- Size: 2.6 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ddb0ab7841ad605ffa4725094c8e79508aec889be2ac91339d4d2519ebc95e27
|
|
| MD5 |
fdc831c4ce63b70e7084770acdbb26a9
|
|
| BLAKE2b-256 |
e9f98be4b903fc065fcb4ebfa24b82f9937c02af69a8349f9079d6108fe4f15a
|
