PuPu

<div align="center">
  <img src="./public/logo512.png" alt="PuPu" style="height: 128px">
  <h1>PuPu</h1>
  <p>Your AI, your way — beautifully simple.</p>
  <p>
    A desktop AI client for local and cloud models, with workspace-aware chat in one clean app.
  </p>
  <p>
    <a href="#macos">
      <img src="./public/assets/download_mac.svg" alt="Download for Mac" />
    </a>
    &nbsp;&nbsp;
    <a href="https://github.com/haoxiang-xu/PuPu/releases/latest/download/PuPu.Setup.0.1.1.exe">
      <img src="./public/assets/download_windows.svg" alt="Download for Windows" />
    </a>
    &nbsp;&nbsp;
    <a href="#linux">
      <img src="./public/assets/download_linux.svg" alt="Download for Linux" />
    </a>
  </p>
</div>

PuPu is a cross-platform desktop AI client that lets you chat with local models through Ollama or connect to cloud providers such as OpenAI and Anthropic. It is built for people who want one fast desktop app for everyday AI work, not a browser tab maze.

If you find the project useful, ⭐⭐⭐ star the repo.

![PuPu UI](./public/assets/v0.1.0-release/social_preview.png)

## Why PuPu

- Local and cloud models in one place
  - Use Ollama for local models, or switch to supported hosted providers when you need them.
- Workspace-aware chat
  - Attach a project folder so PuPu can work with your local files in context.
- A cleaner desktop workflow
  - Keep conversations, settings, and tools inside one native app on macOS, Windows, and Linux.
- Built for real usage
  - Manage multiple chats, keep context close to your work, and avoid bouncing between disconnected tools.

## Get PuPu

Download the latest release:

<a href="https://github.com/haoxiang-xu/PuPu/releases/latest/download/PuPu-0.1.1-arm64.dmg"><img src="./public/assets/download_mac_apple_silicon.svg" alt="Mac (Apple Silicon)" /></a>&nbsp;&nbsp;<a href="https://github.com/haoxiang-xu/PuPu/releases/latest/download/PuPu-0.1.1-intel.dmg"><img src="./public/assets/download_mac_intel.svg" alt="Mac (Intel)" /></a>

<a href="https://github.com/haoxiang-xu/PuPu/releases/latest/download/PuPu.Setup.0.1.1.exe"><img src="./public/assets/download_windows.svg" alt="Download for Windows" /></a>

<a href="https://github.com/haoxiang-xu/PuPu/releases/latest/download/PuPu-0.1.1.AppImage"><img src="./public/assets/download_linux_appimage.svg" alt="Linux (.AppImage)" /></a>&nbsp;&nbsp;<a href="https://github.com/haoxiang-xu/PuPu/releases/latest/download/PuPu_0.1.1.deb"><img src="./public/assets/download_linux_deb.svg" alt="Linux (.deb)" /></a>

### Windows

1. Download the latest `.exe` installer:

   <a href="https://github.com/haoxiang-xu/PuPu/releases/latest/download/PuPu.Setup.0.1.1.exe"><img src="./public/assets/download_windows.svg" alt="Download for Windows" /></a>

2. Run the installer.
3. Launch PuPu from the Start menu.

### macOS

1. Download the latest `.dmg`:

   <a href="https://github.com/haoxiang-xu/PuPu/releases/latest/download/PuPu-0.1.1-arm64.dmg"><img src="./public/assets/download_mac_apple_silicon.svg" alt="Mac (Apple Silicon)" /></a>&nbsp;&nbsp;<a href="https://github.com/haoxiang-xu/PuPu/releases/latest/download/PuPu-0.1.1-intel.dmg"><img src="./public/assets/download_mac_intel.svg" alt="Mac (Intel)" /></a>

2. Open the disk image.
3. Drag PuPu into `Applications`.
4. Launch PuPu from `Applications`.

### Linux

1. Download the latest:

   <a href="https://github.com/haoxiang-xu/PuPu/releases/latest/download/PuPu-0.1.1.AppImage"><img src="./public/assets/download_linux_appimage.svg" alt="Linux (.AppImage)" /></a>&nbsp;&nbsp;<a href="https://github.com/haoxiang-xu/PuPu/releases/latest/download/PuPu_0.1.1.deb"><img src="./public/assets/download_linux_deb.svg" alt="Linux (.deb)" /></a>

2. If you use the `.deb`, install it with:

```bash
sudo apt install ./PuPu_0.1.1.deb
```

3. If your system reports a Chromium sandbox permission error, run:

```bash
sudo chown root:root /opt/PuPu/chrome-sandbox
sudo chmod 4755 /opt/PuPu/chrome-sandbox
```

## Quick Start

1. Open PuPu.
2. Choose how you want to run models:
   - local with Ollama
   - cloud with a supported provider such as OpenAI or Anthropic
3. Add any API key or provider settings in the app if needed.
4. Optionally attach a workspace folder so PuPu can work with local files in context.
5. Start chatting.

## What You Can Do

### Work With Local Models

Run supported Ollama models directly from your machine without leaving the desktop app.

### Connect To Hosted Providers

Switch to supported cloud providers when you want stronger hosted models or a different workflow.

### Attach A Workspace

Give PuPu a workspace and keep the conversation tied to the files you are actually working on.

### Keep Chats Organized

Manage multiple conversations without losing context or cluttering your workflow.

## Screenshots

![PuPu showcase](./public/assets/v0.1.0-release/ui_showcase_1.png)

## Roadmap

- Agent Builder
- Agent Teams and Skills
- MCP integration

## Contributing

Contributions are welcome.

By intentionally submitting a contribution, you agree to the terms in
[docs/CLA.md](./docs/CLA.md). In short:

- you keep ownership of your contribution;
- the project may ship your contribution under Apache-2.0; and
- the project may also reuse or relicense accepted contributions in future
  commercial, dual-licensed, source-available, or proprietary offerings.

If you are contributing code or assets owned by your employer or client, make
sure you have authority to do so before opening a pull request.

## License And Trademark

PuPu is distributed under the [Apache License 2.0](./LICENSE).

This means the code can be used, modified, and redistributed commercially, but
the PuPu name and brand are not automatically included in those rights.

- License text: [LICENSE](./LICENSE)
- Project notices: [NOTICE](./NOTICE)
- Contributor terms: [docs/CLA.md](./docs/CLA.md)
- Brand usage rules: [docs/TRADEMARK_POLICY.md](./docs/TRADEMARK_POLICY.md)

If you ship a modified fork, rename it and replace PuPu branding unless you
have written permission to use the marks.

## Support

- Found a bug or want to request something: [open an issue](https://github.com/haoxiang-xu/PuPu/issues)
- Want the latest downloadable builds: [see releases](https://github.com/haoxiang-xu/PuPu/releases/latest)