简体中文

Pie is an open-source Agent-to-IM connector: a Mac desktop app for creating local Agent profiles, connecting them to IM channels, and keeping their runtime visible. Learn more at pieim.com.

The stable path today is Pie Desktop with the Pi Agent Harness and the Feishu/Lark channel. WeChat and DingTalk are early support, Discord is available in the desktop app, Slack and Telegram remain hidden development channels, and Ousia, Codex, Hermes, and OpenClaw are advanced harness choices rather than the default stable path.

Pie keeps the Agent-to-IM loop small and explicit:

1. Create one Agent profile for one Agent instance.
2. Choose the local Agent Harness behind it.
3. Connect the Agent to an IM channel such as Feishu/Lark, WeChat, Discord, or DingTalk.
4. Observe channel state, runtime output, logs, config, secrets, Skills, and working directories from the desktop app.

Follow messages, runtime state, CPU, memory, and recent activity from the desktop view.

Create a profile by choosing the agent harness and IM channel that should back one agent instance.

Configure channel credentials and behavior from the desktop app.

Choose provider, model, thinking level, API key, system prompt, and working-directory settings for each profile.

Use the local chat view for quick checks while keeping day-to-day conversations in connected IM channels.

Review logs and terminal output when an Agent is running for a long time.

Adjust desktop language, appearance, lifecycle, and launch behavior.

Pie is pre-release software. The main development target is the desktop app.

The default and most complete path today is:

Desktop app -> Pi Agent Harness -> Feishu/Lark channel

Current channel status:

1. Feishu/Lark is the primary and most complete IM channel.
2. WeChat can log in, poll, receive, and send messages, but should still be treated as early support.
3. Discord is available in the desktop creation flow and runtime.
4. DingTalk is available in the desktop creation flow and runtime with app bot Stream mode text replies.
5. Slack and Telegram remain hidden development channels.

Current harness status:

1. Pi is the default stable harness for new Agents.
2. Ousia is an explicit advanced harness that reuses Pi session capabilities and adds its own framework companion features.
3. Codex, Hermes, and OpenClaw are real local runtime adapters with desktop diagnostics and setup surfaces, but they are not the default stable path yet.

Ousia's Task Engine is prototype-level. It is useful for exploring scheduled or longer-running Agent work, but should not be used for critical automation.

Pie does not provide a security sandbox yet. The Runtime Environment sets an Agent's home directory, working directory, and lifecycle state; file, command, and network access are still controlled by the selected Agent Harness and underlying tools.

The current public pre-release build is Pie 0.2.4 for macOS Apple Silicon.

• Download for macOS Apple Silicon
• SHA-256: c38848dc2f7a1ddd7fbc68df52c670f8a2c92dd58f5d69f4134520533c303f92
• Windows and Linux builds are not published yet.

Install dependencies:

npm install

Start the desktop app in development:

npm run desktop:dev

Or run CLI onboarding and start the runtime:

npm run start:onboard
npm run start

Build the desktop app:

npm run desktop:build

Pie is organized around a small set of boundaries:

1. Desktop app: manage Agents, channels, models, logs, folders, Skills, and global preferences.
2. Runtime: start one profile/Agent instance with its selected channels and harness capability.
3. Agent Harnesses: adapt Pi, Ousia, Codex, Hermes, OpenClaw, and future backends into Pie's session and event surface.
4. Channels: receive messages, send replies, and translate IM events for Feishu/Lark, WeChat, Discord, DingTalk, and future adapters.
5. Profile state: keep profile-scoped config, secrets, runtime logs, usage events, normalized agent events, Skills, and working directories under the Agent profile home.

See Development Guide for local setup, commands, data layout, debugging, and release notes.

MIT

The Feishu/Lark messaging delivery code in src/channels/feishu/platform/messaging/send.ts is adapted from larksuite/openclaw-lark, which is distributed under the MIT License.