https://github.com/haoxiang-xu/pupu
PuPu is a lightweight tool that makes it easy to run AI models on your own device. Designed for smooth performance and ease of use, PuPu is perfect for anyone who wants quick access to AI without technical complexity.
https://github.com/haoxiang-xu/pupu
ai chat deepseek llm llm-gui llm-webui llms minimalist multios ollama ollama-app ollama-chat ollama-client ollama-gui ollama-interface ollama-ui ollama-webui self-hosted webui
Last synced: about 2 months ago
JSON representation
PuPu is a lightweight tool that makes it easy to run AI models on your own device. Designed for smooth performance and ease of use, PuPu is perfect for anyone who wants quick access to AI without technical complexity.
- Host: GitHub
- URL: https://github.com/haoxiang-xu/pupu
- Owner: haoxiang-xu
- License: mit
- Created: 2025-02-05T00:10:52.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-22T04:10:56.000Z (about 1 year ago)
- Last Synced: 2025-03-22T04:23:55.145Z (about 1 year ago)
- Topics: ai, chat, deepseek, llm, llm-gui, llm-webui, llms, minimalist, multios, ollama, ollama-app, ollama-chat, ollama-client, ollama-gui, ollama-interface, ollama-ui, ollama-webui, self-hosted, webui
- Language: JavaScript
- Homepage:
- Size: 8.5 MB
- Stars: 9
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
PuPu
Your AI, your way — beautifully simple.
A desktop AI client for local and cloud models, with workspace-aware chat in one clean app.
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.
## 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:
### Windows
1. Download the latest `.exe` installer:
2. Run the installer.
3. Launch PuPu from the Start menu.
### macOS
1. Download the latest `.dmg`:
2. Open the disk image.
3. Drag PuPu into `Applications`.
4. Launch PuPu from `Applications`.
### Linux
1. Download the latest:
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
## 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)