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: 7 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 (9 months ago)
- Default Branch: main
- Last Pushed: 2025-03-22T04:10:56.000Z (7 months ago)
- Last Synced: 2025-03-22T04:23:55.145Z (7 months 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
A simple and easy to use UI for the Ollama.
[![Download for Windows][windows-shield]][windows-url]
[![Download for Mac][macos-shield]][macos-url]
[![Download for Linux][linux-shield]][linux-url]
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.
## Table of Contents
- [For Users](#for-users)
- [App installation](#app-installation)
- [For Developers](#for-developers)
- [Local Setup](#local-setup)
- [Deployment](#deployment)
- [Further Development](#further-development)
### Windows
[![Download for Windows][windows-shield]][windows-url]
- Download the `.exe` Windows installer [here](windows-url).
- Run the installer and follow the instructions.
- Once the installation is complete, you can find the app in the start menu.
### Mac
[![Download for Mac][macos-shield]][macos-url]
- Download the `.dmg` Mac installer [here](macos-url).
- Open the downloaded file and drag the app to the Applications folder.
- Once the installation is complete, you can find the app in the Applications folder.
### Linux
[![Download for Linux][linux-shield]][linux-url]
- Download the `.deb` or `.AppImage` file [here](linux-url).
- If you downloaded the `.deb` file, run the following command in the terminal:
```bash
sudo dpkg -i PuPu-0.0.4.deb
```
OR
```bash
sudo apt install ./PuPu-0.0.4.deb
```
- Ensuring Proper Sandbox Permissions: If you encounter an error message about sandbox permissions, you can run the following command:
```bash
sudo chown root:root /opt/PuPu/chrome-sandbox
sudo chmod 4755 /opt/PuPu/chrome-sandbox
```
- Install dependencies: To run the electron app locally, you need to install the dependencies by running the following command:
- windows might require extra steps to install the node-gyp dependencies, you can follow the instructions [here](./docs/setup_guide/node_gyp_setup_guide.md).
- Create python virtual environment: To run the backend python child process, you need to create a python virtual environment by running the following command: `python -m venv ./public/child_processes/venv` and install the dependencies by running the following command: `pip install -r requirements.txt`
`npm install`
- Rebuild the Electron App: After installing the dependencies, you need to rebuild the electron app by running the following command:
`npx electron-rebuild`
- Run the Electron App: Once the dependencies are installed, you can run the app by running the following command:
`npm start`
- Build the React App: In order to build the app for different platforms, you should build the React app first by running the following command:
`npm run build`
- Build the Electron App: Once the React app is built, you can build the electron app for different platforms by running the following command:
`npx electron-builder --mac` (for mac)
`npx electron-builder --win` (for windows) Notice: Windows might require you to run the command in an administrator shell.
`npx electron-builder --linux` (for linux)
- To further develop the app, you can refer to the [development guide](./docs/development/development.md).
[windows-shield]: https://img.shields.io/badge/download_for_windows-EBDBE2?style=for-the-badge&logo=windows&logoColor=FFFFFF&labelColor=FFFFFF
[windows-url]: https://github.com/haoxiang-xu/PuPu/releases/tag/v0.0.3
[macos-shield]: https://img.shields.io/badge/download_for_mac-EBDBE2?style=for-the-badge&logo=apple&logoColor=000000&labelColor=EBDBE2
[macos-url]: https://github.com/haoxiang-xu/PuPu/releases/tag/v0.0.3
[linux-shield]: https://img.shields.io/badge/download_for_linux-EBDBE2?style=for-the-badge&logo=linux&logoColor=000000&labelColor=EBDBE2
[linux-url]: https://github.com/haoxiang-xu/PuPu/releases/tag/v0.0.3